{
 "$schema": "https://oedi-data-lake.s3.amazonaws.com/nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/catalog.schema.json",
 "schema_version": "1.0.0",
 "generated": {
  "timestamp": "2026-11-03T21:59:49+00:00",
  "method": "scripts/gen_catalog.py over a read-only ListObjectsV2 scan of the bucket",
  "source_of_truth": "bucket_scan"
 },
 "repository": {
  "name": "End Use Load Profiles for the U.S. Building Stock",
  "bucket": "oedi-data-lake",
  "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/",
  "region": "us-west-2",
  "requester_pays": false,
  "doi": "10.25984/1876417",
  "landing_page": "https://data.openei.org/submissions/4520",
  "license": "CC-BY-4.0",
  "publisher": "National Laboratory of the Rockies (NLR)",
  "contact": "ResStock@nrel.gov, ComStock@nrel.gov",
  "known_issues_url": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/KNOWN_ISSUES.md",
  "naming_convention_baseline": "2025",
  "anomaly_notes": [
   {
    "release_id": "2024/resstock_dataset_2024.1",
    "summary": "Annual-results-only release. Contains no timeseries data of any kind, which is the defining difference from every other release in this repository. 30,055 objects, 5.9 TB, 260 upgrade packages.",
    "deviations": [
     "NO TIMESERIES DATA. No timeseries_aggregates, no timeseries_individual_buildings, and no building_energy_models. Contains metadata/, metadata_and_annual_results/ (by_state and national), weather/ and geographic_information/ only.",
     "Content is nested one level deeper than every other release, under resstock_tmy3/. That includes data_dictionary.tsv, enumeration_dictionary.tsv and upgrades_lookup.json, which are NOT at the release root where every other release puts them.",
     "Directory name does not follow the <type>_<weather>_release_<n> convention.",
     "upgrades_lookup.json exists but defines only {\"0\": \"Baseline\"}, despite the release carrying 260 upgrade packages. Upgrades are described in 'Measure Package Index.csv' by decimal package number (1.01 ... 15.28) while the data files use sequential integers (upgrade1 ... upgrade260). No crosswalk between the two is published, and the lookup file does not bridge them.",
     "Its data dictionary is, however, exact: all 283 documented fields match the annual-results Parquet schema with no undocumented columns. The interpretation gap is confined to the upgrade dimension.",
     "COMPLETE AS PUBLISHED. The building models referenced by UnderConstruction.txt were never uploaded and will not be; that notice is scheduled for deletion. The absence of timeseries data and models is the defining characteristic of this release, not a gap awaiting completion."
    ]
   }
  ]
 },
 "releases": [
  {
   "id": "2021/EULP TAG Meeting Presenations",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2021/EULP TAG Meeting Presenations/",
   "kind": "non_release",
   "publication_year": 2021,
   "lifecycle": "unknown",
   "notes": [
    "Archive of Technical Advisory Group meeting presentations. Not a dataset. Directory name contains a typo ('Presenations')."
   ]
  },
  {
   "id": "2021/comstock_amy2018_release_1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2021/comstock_amy2018_release_1/",
   "kind": "data_release",
   "publication_year": 2021,
   "lifecycle": "superseded",
   "superseded_by": "2023/comstock_amy2018_release_1",
   "lineage": "comstock_amy2018",
   "dataset_type": "comstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "1",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 1,
    "ids": [
     0
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v2",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v2"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_name",
      "field_location",
      "data_type",
      "units",
      "field_description",
      "allowable_enumeration"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v2",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v2"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "enumerations",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "geographic_information/",
    "metadata/",
    "timeseries_aggregates/",
    "timeseries_aggregates_metadata/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_county",
     "by_iso_rto_region",
     "by_puma",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_county",
     "by_puma_midwest",
     "by_puma_northeast",
     "by_puma_south",
     "by_puma_west",
     "by_state"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "comstock-california-warehouse-hvac",
    "comstock-california-equipment-power-density",
    "comstock-california-ventilation-rates"
   ],
   "notes": []
  },
  {
   "id": "2021/comstock_tmy3_release_1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2021/comstock_tmy3_release_1/",
   "kind": "data_release",
   "publication_year": 2021,
   "lifecycle": "archived",
   "superseded_by": null,
   "lineage": "comstock_tmy3",
   "dataset_type": "comstock",
   "weather": "tmy3",
   "weather_kind": "tmy3",
   "weather_year": null,
   "release_number": "1",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 1,
    "ids": [
     0
    ],
    "id_gaps": [],
    "lookup_file": "upgrade_dictionary.tsv",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v2",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v2"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_name",
      "field_location",
      "data_type",
      "units",
      "field_description",
      "allowable_enumeration"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v2",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v2"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "enumerations",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "geographic_information/",
    "metadata/",
    "timeseries_aggregates/",
    "timeseries_aggregates_metadata/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_county",
     "by_iso_rto_region",
     "by_puma",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_county",
     "by_puma_midwest",
     "by_puma_northeast",
     "by_puma_south",
     "by_puma_west",
     "by_state"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "comstock-california-warehouse-hvac",
    "comstock-california-equipment-power-density",
    "comstock-california-ventilation-rates"
   ],
   "notes": []
  },
  {
   "id": "2021/resstock_amy2018_release_1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2021/resstock_amy2018_release_1/",
   "kind": "data_release",
   "publication_year": 2021,
   "lifecycle": "superseded",
   "superseded_by": "2022/resstock_amy2018_release_1",
   "lineage": "resstock_amy2018",
   "dataset_type": "resstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "1",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 1,
    "ids": [
     0
    ],
    "id_gaps": [],
    "lookup_file": "upgrade_dictionary.tsv",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v3",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v3"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_location",
      "field_name",
      "data_type",
      "units",
      "field_description",
      "allowable_enumerations"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v3",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v3"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "",
      "field",
      "enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "correction_factors/",
    "geographic_information/",
    "metadata/",
    "occupancy_schedules/",
    "timeseries_aggregates/",
    "timeseries_aggregates_metadata/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_county",
     "by_iso_rto_region",
     "by_puma",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_county",
     "by_puma_midwest",
     "by_puma_northeast",
     "by_puma_south",
     "by_puma_west",
     "by_state"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "resstock-wall-type-maine",
    "empty-occupancy-schedule-files-2021"
   ],
   "notes": []
  },
  {
   "id": "2021/resstock_tmy3_release_1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2021/resstock_tmy3_release_1/",
   "kind": "data_release",
   "publication_year": 2021,
   "lifecycle": "superseded",
   "superseded_by": "2022/resstock_tmy3_release_1",
   "lineage": "resstock_tmy3",
   "dataset_type": "resstock",
   "weather": "tmy3",
   "weather_kind": "tmy3",
   "weather_year": null,
   "release_number": "1",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 1,
    "ids": [
     0
    ],
    "id_gaps": [],
    "lookup_file": "upgrade_dictionary.tsv",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v3",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v3"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_location",
      "field_name",
      "data_type",
      "units",
      "field_description",
      "allowable_enumerations"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v3",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v3"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "",
      "field",
      "enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "geographic_information/",
    "metadata/",
    "occupancy_schedules/",
    "timeseries_aggregates/",
    "timeseries_aggregates_metadata/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_county",
     "by_iso_rto_region",
     "by_puma",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_county",
     "by_puma_midwest",
     "by_puma_northeast",
     "by_puma_south",
     "by_puma_west",
     "by_state"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "resstock-wall-type-maine",
    "empty-occupancy-schedule-files-2021"
   ],
   "notes": []
  },
  {
   "id": "2022/resstock_amy2012_release_1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2022/resstock_amy2012_release_1/",
   "kind": "data_release",
   "publication_year": 2022,
   "lifecycle": "superseded",
   "superseded_by": "2022/resstock_amy2012_release_1.1",
   "lineage": "resstock_amy2012",
   "dataset_type": "resstock",
   "weather": "amy2012",
   "weather_kind": "amy",
   "weather_year": 2012,
   "release_number": "1",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 11,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v4",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v4"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_location",
      "field_name",
      "data_type",
      "units",
      "field_description",
      "allowable_enumerations_baseline"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v4",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v4"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "field",
      "baseline_enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "geographic_information/",
    "metadata/",
    "metadata_and_annual_results/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_iso_rto_region",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "kiva-foundation-2022",
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "resstock-wall-type-maine"
   ],
   "notes": []
  },
  {
   "id": "2022/resstock_amy2012_release_1.1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2022/resstock_amy2012_release_1.1/",
   "kind": "data_release",
   "publication_year": 2022,
   "lifecycle": "superseded",
   "superseded_by": "2025/resstock_amy2012_release_1",
   "lineage": "resstock_amy2012",
   "dataset_type": "resstock",
   "weather": "amy2012",
   "weather_kind": "amy",
   "weather_year": 2012,
   "release_number": "1.1",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 11,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v4",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v4"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_location",
      "field_name",
      "data_type",
      "units",
      "field_description",
      "allowable_enumerations_baseline"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v4",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v4"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "field",
      "baseline_enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "geographic_information/",
    "metadata/",
    "metadata_and_annual_results/",
    "metadata_income/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_iso_rto_region",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "kiva-foundation-2022",
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "resstock-wall-type-maine"
   ],
   "notes": [
    "Uses the 'release_N.M' form, which the root README naming convention does not define."
   ]
  },
  {
   "id": "2022/resstock_amy2018_release_1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2022/resstock_amy2018_release_1/",
   "kind": "data_release",
   "publication_year": 2022,
   "lifecycle": "superseded",
   "superseded_by": "2022/resstock_amy2018_release_1.1",
   "lineage": "resstock_amy2018",
   "dataset_type": "resstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "1",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 11,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v4",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v4"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_location",
      "field_name",
      "data_type",
      "units",
      "field_description",
      "allowable_enumerations_baseline"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v4",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v4"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "field",
      "baseline_enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "geographic_information/",
    "metadata/",
    "metadata_and_annual_results/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_iso_rto_region",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "kiva-foundation-2022",
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "resstock-wall-type-maine"
   ],
   "notes": []
  },
  {
   "id": "2022/resstock_amy2018_release_1.1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2022/resstock_amy2018_release_1.1/",
   "kind": "data_release",
   "publication_year": 2022,
   "lifecycle": "superseded",
   "superseded_by": "2024/resstock_amy2018_release_2",
   "lineage": "resstock_amy2018",
   "dataset_type": "resstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "1.1",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 11,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v4",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v4"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_location",
      "field_name",
      "data_type",
      "units",
      "field_description",
      "allowable_enumerations_baseline"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v4",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v4"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "field",
      "baseline_enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "geographic_information/",
    "metadata/",
    "metadata_and_annual_results/",
    "metadata_income/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_iso_rto_region",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "kiva-foundation-2022",
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "resstock-wall-type-maine"
   ],
   "notes": [
    "Uses the 'release_N.M' form, which the root README naming convention does not define."
   ]
  },
  {
   "id": "2022/resstock_tmy3_release_1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2022/resstock_tmy3_release_1/",
   "kind": "data_release",
   "publication_year": 2022,
   "lifecycle": "superseded",
   "superseded_by": "2022/resstock_tmy3_release_1.1",
   "lineage": "resstock_tmy3",
   "dataset_type": "resstock",
   "weather": "tmy3",
   "weather_kind": "tmy3",
   "weather_year": null,
   "release_number": "1",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 11,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v4",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v4"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_location",
      "field_name",
      "data_type",
      "units",
      "field_description",
      "allowable_enumerations_baseline"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v4",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v4"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "field",
      "baseline_enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "geographic_information/",
    "metadata/",
    "metadata_and_annual_results/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "kiva-foundation-2022",
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "resstock-wall-type-maine"
   ],
   "notes": []
  },
  {
   "id": "2022/resstock_tmy3_release_1.1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2022/resstock_tmy3_release_1.1/",
   "kind": "data_release",
   "publication_year": 2022,
   "lifecycle": "superseded",
   "superseded_by": "2024/resstock_tmy3_release_2",
   "lineage": "resstock_tmy3",
   "dataset_type": "resstock",
   "weather": "tmy3",
   "weather_kind": "tmy3",
   "weather_year": null,
   "release_number": "1.1",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 11,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v4",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v4"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_location",
      "field_name",
      "data_type",
      "units",
      "field_description",
      "allowable_enumerations_baseline"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v4",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v4"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "field",
      "baseline_enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "geographic_information/",
    "metadata/",
    "metadata_and_annual_results/",
    "metadata_income/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_iso_rto_region",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "kiva-foundation-2022",
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "resstock-wall-type-maine"
   ],
   "notes": [
    "Uses the 'release_N.M' form, which the root README naming convention does not define."
   ]
  },
  {
   "id": "2023/comstock_amy2018_release_1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2023/comstock_amy2018_release_1/",
   "kind": "data_release",
   "publication_year": 2023,
   "lifecycle": "superseded",
   "superseded_by": "2023/comstock_amy2018_release_2",
   "lineage": "comstock_amy2018",
   "dataset_type": "comstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "1",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 10,
    "ids": [
     0,
     1,
     2,
     3,
     5,
     6,
     7,
     8,
     9,
     10
    ],
    "id_gaps": [
     4
    ],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v2",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v2"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_name",
      "field_location",
      "data_type",
      "units",
      "field_description",
      "allowable_enumeration"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v2",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v2"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "enumerations",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "Basic Building Stock Characteristic Analysis Template 1.0.xlsx",
     "format": "xlsx",
     "canonical": false,
     "machine_readable": false
    },
    {
     "file": "EUSS_commerical_release1_webinar_033023.pdf",
     "format": "pdf",
     "canonical": false,
     "machine_readable": false
    },
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "comstock_reference_documenation_version_1.pdf",
     "format": "pdf",
     "canonical": false,
     "machine_readable": false
    }
   ],
   "top_level_directories": [
    "building_energy_model_files/",
    "geographic_information/",
    "metadata/",
    "metadata_and_annual_results/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_iso_rto_region",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "comstock-california-warehouse-hvac",
    "comstock-california-equipment-power-density",
    "comstock-california-ventilation-rates"
   ],
   "notes": [
    "Upgrade ID sequence has interior gaps: [4]. Confirm whether intentional."
   ]
  },
  {
   "id": "2023/comstock_amy2018_release_2",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2023/comstock_amy2018_release_2/",
   "kind": "data_release",
   "publication_year": 2023,
   "lifecycle": "superseded",
   "superseded_by": "2024/comstock_amy2018_release_1",
   "lineage": "comstock_amy2018",
   "dataset_type": "comstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "2",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 19,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10,
     11,
     12,
     13,
     14,
     15,
     16,
     17,
     18
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v2",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v2",
      "field_names": "reconciled_to_parquet",
      "field_names_corrected": 409
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_name",
      "field_location",
      "data_type",
      "units",
      "field_description",
      "allowable_enumeration"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v5",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v5"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "measure_name_crosswalk.csv",
     "format": "csv",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "webinar_links.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "geographic_information/",
    "metadata/",
    "metadata_and_annual_results/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2006",
     "by_building_america_climate_zone",
     "by_iso_rto_region",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_puma_midwest",
     "by_puma_northeast",
     "by_puma_south",
     "by_puma_west",
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "comstock-field-name-missing-unit-suffix",
    "comstock-california-warehouse-hvac",
    "comstock-california-equipment-power-density",
    "comstock-california-ventilation-rates"
   ],
   "notes": []
  },
  {
   "id": "2024/comstock_amy2018_release_1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2024/comstock_amy2018_release_1/",
   "kind": "data_release",
   "publication_year": 2024,
   "lifecycle": "superseded",
   "superseded_by": "2024/comstock_amy2018_release_2",
   "lineage": "comstock_amy2018",
   "dataset_type": "comstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "1",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 31,
    "ids": [
     0,
     1,
     2,
     3,
     5,
     6,
     7,
     8,
     9,
     10,
     11,
     12,
     13,
     14,
     15,
     16,
     17,
     18,
     19,
     20,
     21,
     22,
     23,
     24,
     25,
     26,
     27,
     28,
     29,
     31,
     32
    ],
    "id_gaps": [
     4,
     30
    ],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v2",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v2",
      "field_names": "reconciled_to_parquet",
      "field_names_corrected": 752
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_name",
      "field_location",
      "data_type",
      "units",
      "field_description",
      "allowable_enumeration"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v5",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v5"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "Upgrade Measure Documentation Links.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "Webinar Links.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "measure_name_crosswalk.csv",
     "format": "csv",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "comparison_plots/",
    "geographic_information/",
    "metadata/",
    "metadata_and_annual_results/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2006",
     "by_building_america_climate_zone",
     "by_iso_rto_region",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_puma_midwest",
     "by_puma_na",
     "by_puma_northeast",
     "by_puma_south",
     "by_puma_west",
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "comstock-field-name-missing-unit-suffix",
    "comstock-california-warehouse-hvac",
    "comstock-california-equipment-power-density"
   ],
   "notes": [
    "Upgrade ID sequence has interior gaps: [4, 30]. Confirm whether intentional."
   ]
  },
  {
   "id": "2024/comstock_amy2018_release_2",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2024/comstock_amy2018_release_2/",
   "kind": "data_release",
   "publication_year": 2024,
   "lifecycle": "superseded",
   "superseded_by": "2025/comstock_amy2018_release_1",
   "lineage": "comstock_amy2018",
   "dataset_type": "comstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "2",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 40,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10,
     11,
     12,
     13,
     14,
     15,
     16,
     17,
     18,
     19,
     20,
     21,
     22,
     23,
     24,
     25,
     26,
     27,
     28,
     29,
     30,
     31,
     32,
     33,
     34,
     35,
     36,
     37,
     38,
     39
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v2",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v2",
      "field_names": "reconciled_to_parquet",
      "field_names_corrected": 802
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_name",
      "field_location",
      "data_type",
      "units",
      "field_description",
      "allowable_enumeration"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v5",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v5"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "measure_name_crosswalk.csv",
     "format": "csv",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "comparison_plots/",
    "geographic_information/",
    "metadata_and_annual_results/",
    "metadata_and_annual_results_aggregates/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2006",
     "by_building_america_climate_zone",
     "by_county",
     "by_iso_rto_region",
     "by_puma",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state_and_county"
    ],
    "metadata_and_annual_results_aggregates": [
     "by_state",
     "by_state_and_county",
     "by_state_and_puma",
     "national"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "comstock-field-name-missing-unit-suffix",
    "comstock-california-warehouse-hvac",
    "comstock-california-equipment-power-density",
    "comstock-2024r2-utility-bills-emissions",
    "comstock-2024r2-aggregate-discrepancy"
   ],
   "notes": []
  },
  {
   "id": "2024/resstock_amy2018_release_2",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2024/resstock_amy2018_release_2/",
   "kind": "data_release",
   "publication_year": 2024,
   "lifecycle": "superseded",
   "superseded_by": "2025/resstock_amy2018_release_1",
   "lineage": "resstock_amy2018",
   "dataset_type": "resstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "2",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 17,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10,
     11,
     12,
     13,
     14,
     15,
     16
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": false,
    "reconciliation_notes": "Not yet reconciled against on-disk partitions for this release. See manifest.json where present."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v5",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v5"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_location",
      "field_name",
      "data_type",
      "units",
      "field_description",
      "allowable_baseline_enumerations"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v6",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v6"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "metadata_column",
      "enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "resstock_documentation_2024_release_2.pdf",
     "format": "pdf",
     "canonical": false,
     "machine_readable": false
    }
   ],
   "top_level_directories": [
    "comparisons/",
    "metadata/",
    "metadata_and_annual_results/",
    "model_and_schedule_files/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_iso_rto_region",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": null,
   "known_issue_ids": [
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "resstock-2024r2-electricity-energy-bills",
    "resstock-2024r2-measure-applicability",
    "resstock-wall-type-maine"
   ],
   "notes": []
  },
  {
   "id": "2024/resstock_dataset_2024.1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2024/resstock_dataset_2024.1/",
   "kind": "anomalous_release",
   "publication_year": 2024,
   "lifecycle": "unknown",
   "superseded_by": null,
   "dataset_type": "resstock",
   "weather": "tmy3",
   "name_follows_convention": false,
   "publisher_name_at_release": "NREL",
   "manifest": null,
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "resstock_tmy3/data_dictionary.tsv",
     "schema_variant": "dd-v3",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v3"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": []
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "resstock_tmy3/enumeration_dictionary.tsv",
     "schema_variant": "ed-v7",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v7"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": []
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "resstock_tmy3/Measure Package Index.csv",
     "format": "csv",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "known_issue_ids": [
    "unresolvable-upgrade-numbering-2024-1",
    "resstock-wall-type-maine"
   ],
   "notes": [
    "Annual-results-only release. Contains no timeseries data of any kind, which is the defining difference from every other release in this repository. 30,055 objects, 5.9 TB, 260 upgrade packages.",
    "Dictionaries and upgrades_lookup.json are under resstock_tmy3/, not at the release root.",
    "The standardized sidecars for this release sit at the release root, not beside the originals under resstock_tmy3/. normalized_sidecar is relative to the release root; file is not.",
    "See repository.anomaly_notes for the full list of deviations."
   ]
  },
  {
   "id": "2024/resstock_tmy3_release_2",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2024/resstock_tmy3_release_2/",
   "kind": "data_release",
   "publication_year": 2024,
   "lifecycle": "current",
   "superseded_by": null,
   "lineage": "resstock_tmy3",
   "dataset_type": "resstock",
   "weather": "tmy3",
   "weather_kind": "tmy3",
   "weather_year": null,
   "release_number": "2",
   "name_follows_convention": true,
   "publication_date": null,
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 17,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10,
     11,
     12,
     13,
     14,
     15,
     16
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": true,
    "reconciliation_notes": "Reconciled against on-disk partitions. Upgrade coverage differs BY DIRECTORY; see manifest.json directories[].upgrades_available."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v5",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v5"
     },
     "normalized_sidecar": "data_dictionary_standardized.tsv",
     "columns": [
      "field_location",
      "field_name",
      "data_type",
      "units",
      "field_description",
      "allowable_baseline_enumerations"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v6",
     "standardized_schema": false,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v6"
     },
     "normalized_sidecar": "enumeration_dictionary_standardized.tsv",
     "columns": [
      "metadata_column",
      "enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "resstock_documentation_2024_release_2.pdf",
     "format": "pdf",
     "canonical": false,
     "machine_readable": false
    }
   ],
   "top_level_directories": [
    "geographic_information/",
    "metadata/",
    "metadata_and_annual_results/",
    "model_and_schedule_files/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_iso_rto_region",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2024/resstock_tmy3_release_2/manifest.json",
   "known_issue_ids": [
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "resstock-2024r2-electricity-energy-bills",
    "resstock-2024r2-measure-applicability",
    "resstock-wall-type-maine"
   ],
   "notes": []
  },
  {
   "id": "2025/comstock_amy2012_release_2",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2025/comstock_amy2012_release_2/",
   "kind": "data_release",
   "publication_year": 2025,
   "lifecycle": "current",
   "superseded_by": null,
   "lineage": "comstock_amy2012",
   "dataset_type": "comstock",
   "weather": "amy2012",
   "weather_kind": "amy",
   "weather_year": 2012,
   "release_number": "2",
   "name_follows_convention": true,
   "publication_date": "2025-11-21",
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 62,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10,
     11,
     12,
     13,
     14,
     15,
     16,
     17,
     18,
     19,
     20,
     21,
     22,
     23,
     24,
     25,
     26,
     27,
     28,
     29,
     30,
     31,
     32,
     33,
     34,
     35,
     36,
     37,
     38,
     39,
     40,
     41,
     42,
     43,
     44,
     45,
     46,
     47,
     48,
     49,
     50,
     51,
     52,
     53,
     54,
     55,
     56,
     57,
     58,
     59,
     60,
     61
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": true,
    "reconciliation_notes": "Reconciled against on-disk partitions. Upgrade coverage differs BY DIRECTORY; see manifest.json directories[].upgrades_available."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v6",
     "standardized_schema": true,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v6",
      "field_names": "reconciled_to_parquet",
      "field_names_corrected": 802
     },
     "normalized_sidecar": null,
     "columns": [
      "field_name",
      "field_location",
      "data_type",
      "units",
      "field_description",
      "allowable_enumeration",
      "in_full_metadata_file",
      "in_basic_metadata_file"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v5",
     "standardized_schema": true,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v5"
     },
     "normalized_sidecar": null,
     "columns": [
      "enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "README.pdf",
     "format": "pdf",
     "canonical": true,
     "machine_readable": false
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "measure_name_crosswalk.csv",
     "format": "csv",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "geographic_information/",
    "metadata_and_annual_results/",
    "metadata_and_annual_results_aggregates/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2006",
     "by_building_america_climate_zone",
     "by_county",
     "by_iso_rto_region",
     "by_puma",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state_and_county"
    ],
    "metadata_and_annual_results_aggregates": [
     "by_state",
     "by_state_and_county",
     "by_state_and_puma",
     "national"
    ]
   },
   "manifest": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2025/comstock_amy2012_release_2/manifest.json",
   "known_issue_ids": [
    "comstock-2025r2-package-naming",
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "comstock-dictionary-stale-2025r2",
    "comstock-field-name-missing-unit-suffix",
    "comstock-undocumented-weight-applicability",
    "comstock-2025r2-hawaii-amy2012-weather"
   ],
   "notes": []
  },
  {
   "id": "2025/comstock_amy2018_release_1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2025/comstock_amy2018_release_1/",
   "kind": "data_release",
   "publication_year": 2025,
   "lifecycle": "superseded",
   "superseded_by": "2025/comstock_amy2018_release_2",
   "lineage": "comstock_amy2018",
   "dataset_type": "comstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "1",
   "name_follows_convention": true,
   "publication_date": "2025-09-05",
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 58,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10,
     11,
     12,
     13,
     14,
     15,
     16,
     17,
     18,
     19,
     20,
     21,
     22,
     23,
     24,
     25,
     26,
     27,
     28,
     29,
     30,
     31,
     32,
     33,
     34,
     35,
     36,
     37,
     38,
     39,
     40,
     41,
     42,
     43,
     44,
     45,
     46,
     47,
     48,
     49,
     50,
     51,
     52,
     53,
     54,
     55,
     56,
     57
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": true,
    "reconciliation_notes": "Reconciled against on-disk partitions. Upgrade coverage differs BY DIRECTORY; see manifest.json directories[].upgrades_available."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": false,
     "file": null,
     "schema_variant": null,
     "standardized_schema": true,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "copied",
      "copied_from": "2025/comstock_amy2018_release_2",
      "status": "provisional",
      "field_names": "reconciled_to_parquet",
      "field_names_corrected": 799
     },
     "normalized_sidecar": null,
     "columns": []
    },
    "enumeration_dictionary": {
     "present": false,
     "file": null,
     "schema_variant": null,
     "standardized_schema": true,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "copied",
      "copied_from": "2025/comstock_amy2018_release_2",
      "status": "provisional"
     },
     "normalized_sidecar": null,
     "columns": []
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "README.pdf",
     "format": "pdf",
     "canonical": true,
     "machine_readable": false
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "measure_name_crosswalk.csv",
     "format": "csv",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "commercial_gap_model/",
    "comparison_plots/",
    "geographic_information/",
    "metadata_and_annual_results/",
    "metadata_and_annual_results_aggregates/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2006",
     "by_building_america_climate_zone",
     "by_county",
     "by_iso_rto_region",
     "by_puma",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state_and_county"
    ],
    "metadata_and_annual_results_aggregates": [
     "by_state",
     "by_state_and_county",
     "by_state_and_puma",
     "national"
    ]
   },
   "manifest": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2025/comstock_amy2018_release_1/manifest.json",
   "known_issue_ids": [
    "missing-dictionaries",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "comstock-dictionary-stale-2025r2",
    "comstock-field-name-missing-unit-suffix",
    "comstock-undocumented-weight-applicability",
    "comstock-california-warehouse-hvac"
   ],
   "notes": [
    "No data_dictionary.tsv. Column meanings unavailable from the repository."
   ]
  },
  {
   "id": "2025/comstock_amy2018_release_2",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2025/comstock_amy2018_release_2/",
   "kind": "data_release",
   "publication_year": 2025,
   "lifecycle": "superseded",
   "superseded_by": "2025/comstock_amy2018_release_3",
   "lineage": "comstock_amy2018",
   "dataset_type": "comstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "2",
   "name_follows_convention": true,
   "publication_date": "2025-09-10",
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 62,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10,
     11,
     12,
     13,
     14,
     15,
     16,
     17,
     18,
     19,
     20,
     21,
     22,
     23,
     24,
     25,
     26,
     27,
     28,
     29,
     30,
     31,
     32,
     33,
     34,
     35,
     36,
     37,
     38,
     39,
     40,
     41,
     42,
     43,
     44,
     45,
     46,
     47,
     48,
     49,
     50,
     51,
     52,
     53,
     54,
     55,
     56,
     57,
     58,
     59,
     60,
     61
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": true,
    "reconciliation_notes": "Reconciled against on-disk partitions. Upgrade coverage differs BY DIRECTORY; see manifest.json directories[].upgrades_available."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v6",
     "standardized_schema": true,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v6",
      "field_names": "reconciled_to_parquet",
      "field_names_corrected": 802
     },
     "normalized_sidecar": null,
     "columns": [
      "field_name",
      "field_location",
      "data_type",
      "units",
      "field_description",
      "allowable_enumeration",
      "in_full_metadata_file",
      "in_basic_metadata_file"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v5",
     "standardized_schema": true,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v5"
     },
     "normalized_sidecar": null,
     "columns": [
      "enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "README.pdf",
     "format": "pdf",
     "canonical": true,
     "machine_readable": false
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "measure_name_crosswalk.csv",
     "format": "csv",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "commercial_gap_model/",
    "comparison_plots/",
    "geographic_information/",
    "metadata_and_annual_results/",
    "metadata_and_annual_results_aggregates/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2006",
     "by_building_america_climate_zone",
     "by_county",
     "by_iso_rto_region",
     "by_puma",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state_and_county"
    ],
    "metadata_and_annual_results_aggregates": [
     "by_state",
     "by_state_and_county",
     "by_state_and_puma",
     "national"
    ]
   },
   "manifest": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2025/comstock_amy2018_release_2/manifest.json",
   "known_issue_ids": [
    "comstock-2025r2-package-naming",
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "comstock-dictionary-stale-2025r2",
    "comstock-field-name-missing-unit-suffix",
    "comstock-undocumented-weight-applicability"
   ],
   "notes": []
  },
  {
   "id": "2025/comstock_amy2018_release_3",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2025/comstock_amy2018_release_3/",
   "kind": "data_release",
   "publication_year": 2025,
   "lifecycle": "current",
   "superseded_by": null,
   "lineage": "comstock_amy2018",
   "dataset_type": "comstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "3",
   "name_follows_convention": true,
   "publication_date": "2025-12-05",
   "publisher_name_at_release": "NLR",
   "upgrades": {
    "count": 66,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10,
     11,
     12,
     13,
     14,
     15,
     16,
     17,
     18,
     19,
     20,
     21,
     22,
     23,
     24,
     25,
     26,
     27,
     28,
     29,
     30,
     31,
     32,
     33,
     34,
     35,
     36,
     37,
     38,
     39,
     40,
     41,
     42,
     43,
     44,
     45,
     46,
     47,
     48,
     49,
     50,
     51,
     52,
     53,
     54,
     55,
     56,
     57,
     58,
     59,
     60,
     61,
     62,
     63,
     64,
     65
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": true,
    "reconciliation_notes": "Reconciled against on-disk partitions. Upgrade coverage differs BY DIRECTORY; see manifest.json directories[].upgrades_available."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v6",
     "standardized_schema": true,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v6",
      "field_names": "reconciled_to_parquet",
      "field_names_corrected": 1113
     },
     "normalized_sidecar": null,
     "columns": [
      "field_name",
      "field_location",
      "data_type",
      "units",
      "field_description",
      "allowable_enumeration",
      "in_full_metadata_file",
      "in_basic_metadata_file"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v5",
     "standardized_schema": true,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v5"
     },
     "normalized_sidecar": null,
     "columns": [
      "enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "README.pdf",
     "format": "pdf",
     "canonical": true,
     "machine_readable": false
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "measure_name_crosswalk.csv",
     "format": "csv",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "commercial_gap_model/",
    "comparison_plots/",
    "component_loads/",
    "geographic_information/",
    "metadata_and_annual_results/",
    "metadata_and_annual_results_aggregates/",
    "timeseries_aggregates/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2006",
     "by_building_america_climate_zone",
     "by_county",
     "by_iso_rto_region",
     "by_puma",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state_and_county"
    ],
    "metadata_and_annual_results_aggregates": [
     "by_state",
     "by_state_and_county",
     "by_state_and_puma",
     "national"
    ]
   },
   "manifest": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2025/comstock_amy2018_release_3/manifest.json",
   "known_issue_ids": [
    "comstock-2025r3-california-swh",
    "dead-documentation-links",
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "small-sample-county-aggregates",
    "comstock-field-name-missing-unit-suffix",
    "comstock-undocumented-weight-applicability",
    "comstock-2025r3-package-naming"
   ],
   "notes": []
  },
  {
   "id": "2025/resstock_amy2012_release_1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2025/resstock_amy2012_release_1/",
   "kind": "data_release",
   "publication_year": 2025,
   "lifecycle": "current",
   "superseded_by": null,
   "lineage": "resstock_amy2012",
   "dataset_type": "resstock",
   "weather": "amy2012",
   "weather_kind": "amy",
   "weather_year": 2012,
   "release_number": "1",
   "name_follows_convention": true,
   "publication_date": "2025-11-01",
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 29,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10,
     11,
     12,
     13,
     14,
     15,
     16,
     17,
     18,
     19,
     20,
     21,
     22,
     23,
     24,
     25,
     26,
     27,
     28
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": true,
    "reconciliation_notes": "Reconciled against on-disk partitions. Upgrade coverage differs BY DIRECTORY; see manifest.json directories[].upgrades_available."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": false,
     "file": null,
     "schema_variant": null,
     "standardized_schema": true,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "copied",
      "copied_from": "2025/resstock_amy2018_release_1",
      "status": "provisional"
     },
     "normalized_sidecar": null,
     "columns": []
    },
    "enumeration_dictionary": {
     "present": false,
     "file": null,
     "schema_variant": null,
     "standardized_schema": true,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "copied",
      "copied_from": "2025/resstock_amy2018_release_1",
      "status": "provisional"
     },
     "normalized_sidecar": null,
     "columns": []
    }
   },
   "documentation": [
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "README_resstock_2025_1.pdf",
     "format": "pdf",
     "canonical": true,
     "machine_readable": false
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    }
   ],
   "top_level_directories": [
    "metadata_and_annual_results/",
    "timeseries_aggregates/",
    "timeseries_aggregates_new_env/",
    "timeseries_individual_buildings/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_iso_rto_region",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2025/resstock_amy2012_release_1/manifest.json",
   "known_issue_ids": [
    "split-aggregates-2025-resstock",
    "upgrade-lookup-incomplete-amy2012-2025",
    "missing-dictionaries",
    "dead-documentation-links",
    "upgrade-id-rendering-inconsistent",
    "readme-directory-mismatch",
    "small-sample-county-aggregates",
    "resstock-2025-columns-omitted-from-amy2018",
    "resstock-2025-readme-amy2012-defined-as-2018",
    "resstock-2025r1-electric-panel-capacity",
    "resstock-2025r1-column-applicability",
    "resstock-wall-type-maine",
    "amy2012-missing-directories"
   ],
   "notes": [
    "No data_dictionary.tsv. Column meanings unavailable from the repository."
   ]
  },
  {
   "id": "2025/resstock_amy2018_release_1",
   "prefix": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2025/resstock_amy2018_release_1/",
   "kind": "data_release",
   "publication_year": 2025,
   "lifecycle": "current",
   "superseded_by": null,
   "lineage": "resstock_amy2018",
   "dataset_type": "resstock",
   "weather": "amy2018",
   "weather_kind": "amy",
   "weather_year": 2018,
   "release_number": "1",
   "name_follows_convention": true,
   "publication_date": "2025-11-01",
   "publisher_name_at_release": "NREL",
   "upgrades": {
    "count": 33,
    "ids": [
     0,
     1,
     2,
     3,
     4,
     5,
     6,
     7,
     8,
     9,
     10,
     11,
     12,
     13,
     14,
     15,
     16,
     17,
     18,
     19,
     20,
     21,
     22,
     23,
     24,
     25,
     26,
     27,
     28,
     29,
     30,
     31,
     32
    ],
    "id_gaps": [],
    "lookup_file": "upgrades_lookup.json",
    "reconciled_with_storage": true,
    "reconciliation_notes": "Reconciled against on-disk partitions. Upgrade coverage differs BY DIRECTORY; see manifest.json directories[].upgrades_available."
   },
   "dictionaries": {
    "data_dictionary": {
     "present": true,
     "file": "data_dictionary.tsv",
     "schema_variant": "dd-v7",
     "standardized_schema": true,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "dd-v7"
     },
     "normalized_sidecar": null,
     "columns": [
      "field_location",
      "field_name",
      "data_type",
      "units",
      "field_description"
     ]
    },
    "enumeration_dictionary": {
     "present": true,
     "file": "enumeration_dictionary.tsv",
     "schema_variant": "ed-v6",
     "standardized_schema": true,
     "provenance": {
      "schema_version": "1.0.0",
      "generated": "2026-08-05",
      "source_variant": "ed-v6"
     },
     "normalized_sidecar": null,
     "columns": [
      "metadata_column",
      "enumeration",
      "enumeration_description"
     ]
    }
   },
   "documentation": [
    {
     "file": "Column Name Crosswalk.csv",
     "format": "csv",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "README.md",
     "format": "md",
     "canonical": true,
     "machine_readable": true
    },
    {
     "file": "README_resstock_2025_1.pdf",
     "format": "pdf",
     "canonical": true,
     "machine_readable": false
    },
    {
     "file": "ResStockTechnicalReferenceGuide_2025_1.pdf",
     "format": "pdf",
     "canonical": false,
     "machine_readable": false
    },
    {
     "file": "Summary of column comparison between datasets.docx",
     "format": "docx",
     "canonical": false,
     "machine_readable": false
    },
    {
     "file": "citation.txt",
     "format": "txt",
     "canonical": false,
     "machine_readable": true
    },
    {
     "file": "measure_name_crosswalk_res_2025_1.xlsx",
     "format": "xlsx",
     "canonical": false,
     "machine_readable": false
    }
   ],
   "top_level_directories": [
    "building_energy_models/",
    "comparisons/",
    "geographic_information/",
    "metadata_and_annual_results/",
    "timeseries_aggregates/",
    "timeseries_aggregates_new_env/",
    "timeseries_individual_buildings/",
    "weather/"
   ],
   "geographies": {
    "timeseries_aggregates": [
     "by_ashrae_iecc_climate_zone_2004",
     "by_building_america_climate_zone",
     "by_iso_rto_region",
     "by_state"
    ],
    "timeseries_individual_buildings": [
     "by_state"
    ],
    "metadata_and_annual_results": [
     "by_state",
     "national"
    ]
   },
   "manifest": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2025/resstock_amy2018_release_1/manifest.json",
   "known_issue_ids": [
    "split-aggregates-2025-resstock",
    "dead-documentation-links",
    "dictionary-schema-variants",
    "upgrade-id-rendering-inconsistent",
    "readme-directory-mismatch",
    "small-sample-county-aggregates",
    "resstock-2025-columns-omitted-from-amy2018",
    "resstock-2025-enumeration-dictionary-not-utf8",
    "resstock-2025-readme-amy2012-defined-as-2018",
    "resstock-2025r1-electric-panel-capacity",
    "resstock-2025r1-column-applicability",
    "resstock-wall-type-maine"
   ],
   "notes": []
  }
 ],
 "known_issues": [
  {
   "id": "kiva-foundation-2022",
   "summary": "Kiva foundation model bug fixed during the transition to OpenStudio-HPXML v1.5.0 / OpenStudio 3.5.0 / EnergyPlus 22.2. Affects baseline and upgrade simulations; in about 11% of models the slab temperature initial condition differs between baseline and upgrade, producing unexpected savings values.",
   "detail_url": "nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2022/KNOWN_ISSUES.md",
   "severity": "significant",
   "date_identified": "2024-03-26",
   "affects_results": true,
   "affected_releases": [
    "2022/resstock_amy2012_release_1",
    "2022/resstock_amy2012_release_1.1",
    "2022/resstock_amy2018_release_1",
    "2022/resstock_amy2018_release_1.1",
    "2022/resstock_tmy3_release_1",
    "2022/resstock_tmy3_release_1.1"
   ],
   "status": "wont_fix",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "split-aggregates-2025-resstock",
   "summary": "Timeseries aggregates for upgrades 29-32 are NOT in timeseries_aggregates/. They are in timeseries_aggregates_new_env/, which also mixes CSV with chunked Parquet. Constructing the documented aggregate key for upgrades 29-32 returns no data and no error.",
   "severity": "critical",
   "date_identified": "2026-08-04",
   "affects_results": false,
   "affected_releases": [
    "2025/resstock_amy2018_release_1",
    "2025/resstock_amy2012_release_1"
   ],
   "status": "fix_in_progress",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "upgrade-lookup-incomplete-amy2012-2025",
   "summary": "upgrades_lookup.json defines IDs 0-28, but published aggregates for upgrades 29, 30, 31 and 32 exist under timeseries_aggregates_new_env/. The lookup was not updated when those upgrades were added. The sibling release 2025/resstock_amy2018_release_1 defines all 33.",
   "severity": "significant",
   "date_identified": "2026-08-04",
   "affects_results": false,
   "affected_releases": [
    "2025/resstock_amy2012_release_1"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "unresolvable-upgrade-numbering-2024-1",
   "summary": "260 upgrade packages cannot be interpreted. Measure Package Index.csv numbers packages 1.01-15.28 while the data files use sequential integers upgrade1-upgrade260, and no crosswalk between the two schemes is published. The release does ship resstock_tmy3/upgrades_lookup.json, but it defines only {\"0\": \"Baseline\"} -- so the file that should resolve this actively reports that no upgrades exist.",
   "severity": "critical",
   "date_identified": "2026-08-04",
   "affects_results": false,
   "affected_releases": [
    "2024/resstock_dataset_2024.1"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "missing-dictionaries",
   "summary": "Release published no data_dictionary.tsv or enumeration_dictionary.tsv of its own and now carries a PROVISIONAL copy from its nearest sibling (comstock_amy2018_release_1 <- release_2; resstock_amy2012_release_1 <- resstock_amy2018_release_1). The copy describes a different release: measured against this release's own Parquet schema, the ComStock copy leaves 346 columns undocumented and describes 405 fields that do not exist, and the ResStock copy leaves 104 undocumented. Both carry status=provisional in their provenance line and standardized_schema=false here. Treat descriptions and enumerations as indicative, not authoritative, until verified.",
   "severity": "significant",
   "date_identified": "2026-08-04",
   "affects_results": false,
   "affected_releases": [
    "2025/comstock_amy2018_release_1",
    "2025/resstock_amy2012_release_1"
   ],
   "status": "partially_resolved",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "comstock-2025r3-california-swh",
   "summary": "Service water heating was not modeled in any California buildings due to a workflow error. Energy consumption and EUI are understated, most severely for hot-water-intensive building types (hotels, restaurants). Use 2025/comstock_amy2018_release_2 for California analysis.",
   "detail_url": "https://natlabrockies.github.io/ComStock.github.io/docs/resources/explanations/2025_release_3_ca_swh_known_issue.html",
   "severity": "significant",
   "date_identified": "2026-08-04",
   "affects_results": true,
   "affected_releases": [
    "2025/comstock_amy2018_release_3"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "2025 Release 3: California Service Water Heating"
  },
  {
   "id": "comstock-2025r2-package-naming",
   "summary": "Results for package 6 (Demand Flexibility) and package 9 (Geothermal Heat Pump) were swapped. upgrades_lookup.json and measure_name_crosswalk.csv were corrected, but the incorrect names persist in the published metadata and annual results files. Resolve package identity from the lookup files, not from names embedded in results. Fixed in release_3, but the 2012 weather year was not re-released.",
   "detail_url": "https://natlabrockies.github.io/ComStock.github.io/docs/resources/explanations/2025_release_2_packages_known_issue.html",
   "severity": "significant",
   "date_identified": "2026-08-04",
   "affects_results": true,
   "affected_releases": [
    "2025/comstock_amy2018_release_2",
    "2025/comstock_amy2012_release_2"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "2025 Release 2: Geothermal Heat Pump and Demand Flexibility Package Naming"
  },
  {
   "id": "dead-documentation-links",
   "summary": "Five documentation link targets in the current release READMEs return HTTP 404 after the organisation rename: one in the ComStock 2025 R3 README and four in the ResStock 2025 R1 README (which covers both 2025 ResStock releases), including the Technical Reference Guide link. Replacements are verified, and both the Markdown README and the regenerated PDF carry the corrected links. See deliverables/LINK_CHECK.md.",
   "severity": "caution",
   "date_identified": "2026-08-04",
   "affects_results": false,
   "affected_releases": [
    "2025/comstock_amy2018_release_3",
    "2025/resstock_amy2018_release_1",
    "2025/resstock_amy2012_release_1"
   ],
   "status": "resolved",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "dictionary-schema-variants",
   "summary": "data_dictionary.tsv has seven header variants across the repository and enumeration_dictionary.tsv has seven. Column ORDER also flips between ComStock (field_name first) and ResStock (field_location first), so positional parsing silently mislabels every field. Read dictionaries by header name, never by position. Standardized copies on one schema are proposed in revised/dictionaries/.",
   "severity": "significant",
   "date_identified": "2026-08-04",
   "affects_results": false,
   "affected_releases": [
    "2021/comstock_amy2018_release_1",
    "2021/comstock_tmy3_release_1",
    "2021/resstock_amy2018_release_1",
    "2021/resstock_tmy3_release_1",
    "2022/resstock_amy2012_release_1",
    "2022/resstock_amy2012_release_1.1",
    "2022/resstock_amy2018_release_1",
    "2022/resstock_amy2018_release_1.1",
    "2022/resstock_tmy3_release_1",
    "2022/resstock_tmy3_release_1.1",
    "2023/comstock_amy2018_release_1",
    "2023/comstock_amy2018_release_2",
    "2024/comstock_amy2018_release_1",
    "2024/comstock_amy2018_release_2",
    "2024/resstock_amy2018_release_2",
    "2024/resstock_tmy3_release_2",
    "2025/comstock_amy2012_release_2",
    "2025/comstock_amy2018_release_2",
    "2025/comstock_amy2018_release_3",
    "2025/resstock_amy2018_release_1"
   ],
   "status": "partially_resolved",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "upgrade-id-rendering-inconsistent",
   "summary": "The upgrade ID is written several different ways within a single release: unpadded in partition directories (upgrade=0), zero-padded in some filenames (up00-), unpadded in others (up0-), and bare in timeseries filenames. ResStock and ComStock pad the aggregate prefix in OPPOSITE ways, and both agree at and above upgrade 10 -- so code tested on upgrade 10 fails silently on the baseline. Build keys from the per-directory key_template in manifest.json, never from a remembered pattern.",
   "severity": "critical",
   "date_identified": "2026-08-04",
   "affects_results": false,
   "affected_releases": [
    "2021/comstock_amy2018_release_1",
    "2021/comstock_tmy3_release_1",
    "2021/resstock_amy2018_release_1",
    "2021/resstock_tmy3_release_1",
    "2022/resstock_amy2012_release_1",
    "2022/resstock_amy2012_release_1.1",
    "2022/resstock_amy2018_release_1",
    "2022/resstock_amy2018_release_1.1",
    "2022/resstock_tmy3_release_1",
    "2022/resstock_tmy3_release_1.1",
    "2023/comstock_amy2018_release_1",
    "2023/comstock_amy2018_release_2",
    "2024/comstock_amy2018_release_1",
    "2024/comstock_amy2018_release_2",
    "2024/resstock_amy2018_release_2",
    "2024/resstock_tmy3_release_2",
    "2025/comstock_amy2012_release_2",
    "2025/comstock_amy2018_release_1",
    "2025/comstock_amy2018_release_2",
    "2025/comstock_amy2018_release_3",
    "2025/resstock_amy2012_release_1",
    "2025/resstock_amy2018_release_1"
   ],
   "status": "wont_fix",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "readme-directory-mismatch",
   "summary": "The release README's contents table does not match the directory. The 2025 ResStock README omits directories that exist and documents measure_name_crosswalk.csv where the release ships measure_name_crosswalk_res_2025_1.xlsx. manifest.json records the directories that are actually present, and flags the difference as an UNDOCUMENTED_DIRECTORIES warning.",
   "severity": "caution",
   "date_identified": "2026-08-04",
   "affects_results": false,
   "affected_releases": [
    "2025/resstock_amy2018_release_1",
    "2025/resstock_amy2012_release_1"
   ],
   "status": "partially_resolved",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "small-sample-county-aggregates",
   "summary": "In sparsely populated counties the number of building models behind an aggregate may be in single digits, making the load profile unrealistic. Check the models_used column before using any aggregate. Roughly 1,000 individual dwelling models are needed to keep uncertainty near 15%. One row of data is not one dwelling unit.",
   "severity": "caution",
   "date_identified": "2026-08-04",
   "affects_results": false,
   "affected_releases": [
    "2021/comstock_amy2018_release_1",
    "2021/comstock_tmy3_release_1",
    "2021/resstock_amy2018_release_1",
    "2021/resstock_tmy3_release_1",
    "2022/resstock_amy2012_release_1",
    "2022/resstock_amy2012_release_1.1",
    "2022/resstock_amy2018_release_1",
    "2022/resstock_amy2018_release_1.1",
    "2022/resstock_tmy3_release_1",
    "2022/resstock_tmy3_release_1.1",
    "2023/comstock_amy2018_release_1",
    "2023/comstock_amy2018_release_2",
    "2024/comstock_amy2018_release_1",
    "2024/comstock_amy2018_release_2",
    "2024/resstock_amy2018_release_2",
    "2024/resstock_tmy3_release_2",
    "2025/comstock_amy2012_release_2",
    "2025/comstock_amy2018_release_1",
    "2025/comstock_amy2018_release_2",
    "2025/comstock_amy2018_release_3",
    "2025/resstock_amy2012_release_1",
    "2025/resstock_amy2018_release_1"
   ],
   "status": "inherent",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "comstock-dictionary-stale-2025r2",
   "summary": "The published data_dictionary.tsv does not describe this release's own data. 402 documented fields do not exist in the annual results and 348 actual columns are undocumented, because the dictionary carries the previous generation's column names (out.qoi.maximum_daily_peak_intensity_apr where the data has out.qoi.maximum_daily_peak_apr..kw). 2025/comstock_amy2018_release_3 shipped a corrected dictionary; the 2012 weather year was never re-released, so it still carries the stale one.",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": false,
   "affected_releases": [
    "2025/comstock_amy2018_release_2",
    "2025/comstock_amy2012_release_2",
    "2025/comstock_amy2018_release_1"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "comstock-field-name-missing-unit-suffix",
   "summary": "data_dictionary.field_name omits the trailing ..unit suffix that the actual Parquet columns carry, so joining the dictionary to its own data on field_name fails for most columns. ResStock dictionaries record the full column name and are unaffected. A corrected copy, derived from the Parquet schema, is proposed in revised/dictionaries/.",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": false,
   "affected_releases": [
    "2023/comstock_amy2018_release_2",
    "2024/comstock_amy2018_release_1",
    "2024/comstock_amy2018_release_2",
    "2025/comstock_amy2012_release_2",
    "2025/comstock_amy2018_release_1",
    "2025/comstock_amy2018_release_2",
    "2025/comstock_amy2018_release_3"
   ],
   "status": "resolved",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "comstock-undocumented-weight-applicability",
   "summary": "The weight column and one applicability.<measure> column per upgrade measure appear in the annual results with no dictionary entry. weight is required to scale a model result to the building stock, so its absence from the dictionary is a correctness hazard, not a documentation gap.",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": false,
   "affected_releases": [
    "2025/comstock_amy2012_release_2",
    "2025/comstock_amy2018_release_1",
    "2025/comstock_amy2018_release_2",
    "2025/comstock_amy2018_release_3"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "resstock-2025-columns-omitted-from-amy2018",
   "summary": "82 result columns were unintentionally omitted from resstock_amy2018_release_1: component loads (out.component_load.*, 40), component load savings (out.component_load_savings.*, 40) and heat-pump backup delivered load (out.load.heating_hp_bkup.*, 2). They are published in resstock_amy2012_release_1, which has 853 annual-results columns against amy2018's 771. Both releases come from the same ResStock code version with the same model creation and simulation, so this is a publication gap in the amy2018 release, NOT a modelling difference -- every column present in both releases is directly comparable. PERMANENT: amy2018 cannot be regenerated, so these columns will never be published there and no source for them on 2018 weather exists in this repository. The amy2012 release holds the same models under 2012 weather. The 82 columns are not described in either data dictionary.",
   "severity": "caution",
   "date_identified": "2026-08-05",
   "affects_results": false,
   "affected_releases": [
    "2025/resstock_amy2018_release_1",
    "2025/resstock_amy2012_release_1"
   ],
   "status": "wont_fix",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "resstock-2025-enumeration-dictionary-not-utf8",
   "summary": "enumeration_dictionary.tsv is cp1252-encoded, not UTF-8: it contains non-breaking spaces that raise UnicodeDecodeError when opened with default settings. Every other dictionary in the repository is UTF-8, so nothing signals that this one needs an encoding argument.",
   "severity": "caution",
   "date_identified": "2026-08-05",
   "affects_results": false,
   "affected_releases": [
    "2025/resstock_amy2018_release_1"
   ],
   "status": "resolved",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "resstock-2025-readme-amy2012-defined-as-2018",
   "summary": "The naming-convention section of the ResStock 2025 README defines amy2012 as 'actual meteorological year 2018 (2018 weather data...)', duplicating the amy2018 line. This is the line that defines what distinguishes resstock_amy2012_release_1, and the README covers both 2025 ResStock releases. Corrected in both the Markdown README and the regenerated PDF.",
   "severity": "caution",
   "date_identified": "2026-08-05",
   "affects_results": false,
   "affected_releases": [
    "2025/resstock_amy2018_release_1",
    "2025/resstock_amy2012_release_1"
   ],
   "status": "resolved",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "resstock-2025r1-electric-panel-capacity",
   "summary": "Electric panel capacity outputs are WRONG where an HVAC measure is a like-for-like replacement: the NEC load calculation counts the replacement as a new load, so panel constraints are overstated. Seven capacity columns are affected, across measures covering most of the stock. Do not use those columns for these measures. See detail_url.",
   "detail_url": "https://natlabrockies.github.io/ResStock.github.io/docs/resources/explanations/Issue_2025_1_Electric_Panel_Capacity.html",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": true,
   "affected_releases": [
    "2025/resstock_amy2018_release_1",
    "2025/resstock_amy2012_release_1"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "ResStock 2025 Release 1 Electric Panel Capacity"
  },
  {
   "id": "resstock-2025r1-column-applicability",
   "summary": "Three upgrade.* columns are populated for only some of the upgrades they should cover: upgrade.heating_fuel, upgrade.hvac_heating_type_and_fuel and upgrade.hvac_detailed_performance_data. The values present are correct; values are missing rather than wrong, and can be inferred from other columns. See detail_url.",
   "detail_url": "https://natlabrockies.github.io/ResStock.github.io/docs/resources/explanations/Issue_2025_1_Column_Applicability.html",
   "severity": "caution",
   "date_identified": "2026-08-05",
   "affects_results": false,
   "affected_releases": [
    "2025/resstock_amy2018_release_1",
    "2025/resstock_amy2012_release_1"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "ResStock 2025 Release 1 Column Applicability"
  },
  {
   "id": "resstock-2024r2-electricity-energy-bills",
   "summary": "Electricity and energy bills were computed from three different rate sets, so bills are internally inconsistent and bill SAVINGS can be nonsensical -- a bill can rise while consumption falls. Savings are affected more than absolute bills. Gas, propane and oil bills are unaffected. Upstream gives a recalculation procedure. See detail_url.",
   "detail_url": "https://natlabrockies.github.io/ResStock.github.io/docs/resources/explanations/Issue_2024_2_Electricity_and_Energy_Bills.html",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": true,
   "affected_releases": [
    "2024/resstock_amy2018_release_2",
    "2024/resstock_tmy3_release_2"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "ResStock 2024 Release 2 Electricity and Energy Bills"
  },
  {
   "id": "resstock-2024r2-measure-applicability",
   "summary": "Dual-fuel heat pump measures (upgrades 4, 9 and 14) are marked not-applicable for a subset of models that should have received them, so their upgrade results equal the baseline. Roughly 2% of models nationally, varying widely by state. See detail_url.",
   "detail_url": "https://natlabrockies.github.io/ResStock.github.io/docs/resources/explanations/Issue_2024_2_Measure_Applicability.html",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": true,
   "affected_releases": [
    "2024/resstock_amy2018_release_2",
    "2024/resstock_tmy3_release_2"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "ResStock 2024 Release 2 Measure Applicability"
  },
  {
   "id": "resstock-wall-type-maine",
   "summary": "Maine wall types are mis-characterised in the source assessor data, showing far more masonry and far less wood framing than local experts expect. Affects wall type, wall exterior finish, and the applicability of measures that require wood-frame walls. Energy results are believed little affected. Applies to ALL published ResStock datasets. See detail_url.",
   "detail_url": "https://natlabrockies.github.io/ResStock.github.io/docs/resources/explanations/Issue_Wall_Type_Especially_Maine.html",
   "severity": "caution",
   "date_identified": "2026-08-05",
   "affects_results": true,
   "affected_releases": [
    "2021/resstock_amy2018_release_1",
    "2021/resstock_tmy3_release_1",
    "2022/resstock_amy2012_release_1",
    "2022/resstock_amy2012_release_1.1",
    "2022/resstock_amy2018_release_1",
    "2022/resstock_amy2018_release_1.1",
    "2022/resstock_tmy3_release_1",
    "2022/resstock_tmy3_release_1.1",
    "2024/resstock_amy2018_release_2",
    "2024/resstock_dataset_2024.1",
    "2024/resstock_tmy3_release_2",
    "2025/resstock_amy2012_release_1",
    "2025/resstock_amy2018_release_1"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "Wall Type Issue, Especially in Maine"
  },
  {
   "id": "comstock-california-warehouse-hvac",
   "summary": "California warehouse models have no conditioned HVAC system, though their metadata implies one, so heating, cooling and ventilation energy is understated for that segment -- along with the emissions and bills derived from it. See detail_url.",
   "detail_url": "https://natlabrockies.github.io/ComStock.github.io/docs/resources/explanations/california_known_issues.html",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": true,
   "affected_releases": [
    "2021/comstock_amy2018_release_1",
    "2021/comstock_tmy3_release_1",
    "2023/comstock_amy2018_release_1",
    "2023/comstock_amy2018_release_2",
    "2024/comstock_amy2018_release_1",
    "2024/comstock_amy2018_release_2",
    "2025/comstock_amy2018_release_1"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "California Models Known Issues"
  },
  {
   "id": "comstock-california-equipment-power-density",
   "summary": "California models use older DEER equipment assumptions with much higher plug and process loads than the rest of the country, which overstates interior equipment consumption and its share of savings potential. See detail_url for the magnitude by building type.",
   "detail_url": "https://natlabrockies.github.io/ComStock.github.io/docs/resources/explanations/california_known_issues.html",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": true,
   "affected_releases": [
    "2021/comstock_amy2018_release_1",
    "2021/comstock_tmy3_release_1",
    "2023/comstock_amy2018_release_1",
    "2023/comstock_amy2018_release_2",
    "2024/comstock_amy2018_release_1",
    "2024/comstock_amy2018_release_2"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "California Models Known Issues"
  },
  {
   "id": "comstock-california-ventilation-rates",
   "summary": "California models summed Title 24 ventilation requirements instead of taking the maximum, roughly doubling ventilation rates and inflating heating and cooling intensity. Corrected before ComStock 2024 Release 1. See detail_url.",
   "detail_url": "https://natlabrockies.github.io/ComStock.github.io/docs/resources/explanations/california_known_issues.html",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": true,
   "affected_releases": [
    "2021/comstock_amy2018_release_1",
    "2021/comstock_tmy3_release_1",
    "2023/comstock_amy2018_release_1",
    "2023/comstock_amy2018_release_2"
   ],
   "status": "wont_fix",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "California Models Known Issues"
  },
  {
   "id": "comstock-2024r2-utility-bills-emissions",
   "summary": "The sampling method reuses models across locations, and utility rates and grid emissions factors from the original location were carried over rather than re-applied for the reallocated one. Affects 19 utility bill fields and 200+ emissions fields. Upstream advises not using utility bills from the aggregate files at all. See detail_url.",
   "detail_url": "https://natlabrockies.github.io/ComStock.github.io/docs/resources/explanations/utility_bills_emissions_known_issue.html",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": true,
   "affected_releases": [
    "2024/comstock_amy2018_release_2"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "2024 Release 2: Utility Bill and Emissions"
  },
  {
   "id": "comstock-2024r2-aggregate-discrepancy",
   "summary": "The metadata_and_annual_results_aggregates files were built from two different weight tables, so aggregates disagree between geographic levels -- national totals differ by up to about 5% between county and state aggregation. Neither group is more correct; each is internally consistent. See detail_url.",
   "detail_url": "https://natlabrockies.github.io/ComStock.github.io/docs/resources/explanations/aggregate_file_discrepancy_known_issue.html",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": true,
   "affected_releases": [
    "2024/comstock_amy2018_release_2"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "2024 Release 2: Metadata and Annual Results Aggregate File Discrepancy"
  },
  {
   "id": "comstock-2025r2-hawaii-amy2012-weather",
   "summary": "The AMY2012 weather files for Hawaii contain temperatures below freezing, which does not occur there. Every Hawaii model is affected and state heating energy is materially overstated relative to the 2018 weather releases. Upstream recommends NOT using this dataset for Hawaii analysis. See detail_url.",
   "detail_url": "https://natlabrockies.github.io/ComStock.github.io/docs/resources/explanations/2025_release_2_hi_known_issue.html",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": true,
   "affected_releases": [
    "2025/comstock_amy2012_release_2"
   ],
   "status": "wont_fix",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "2025 Release 2: Hawaii AMY2012 Weather Files"
  },
  {
   "id": "comstock-2025r3-package-naming",
   "summary": "The names of packages pkg_0003 and pkg_0004 are swapped: data labelled as one holds the results of the other. The results themselves are correct and only the label is wrong, but in.upgrade_name in the published metadata and annual results cannot be corrected. Resolve package identity from upgrades_lookup.json and measure_name_crosswalk.csv. See detail_url.",
   "detail_url": "https://natlabrockies.github.io/ComStock.github.io/docs/resources/explanations/2025_release_3_packages_known_issue.html",
   "severity": "significant",
   "date_identified": "2026-08-05",
   "affects_results": false,
   "affected_releases": [
    "2025/comstock_amy2018_release_3"
   ],
   "status": "wont_fix",
   "status_date": "2026-08-05",
   "source": "upstream",
   "upstream_title": "2025 Release 3: Heat Pump and Envelope Package Naming"
  },
  {
   "id": "empty-occupancy-schedule-files-2021",
   "summary": "215 occupancy schedule files are zero bytes: 210 in 2021/resstock_amy2018_release_1 and 5 in 2021/resstock_tmy3_release_1, all written on the same day, against a median file size of about 240 KB. Per the data owner, this signature -- zero-byte objects at otherwise valid keys -- is what an interrupted upload looks like in this publication process. A consumer fetching one of those building IDs receives an empty gzip rather than a schedule, or an error, depending on the reader. 0.04% of the directory, so a bulk job will hit them. They are NOT deleted: the key is documented and a missing schedule is a known gap, whereas a 404 looks like a key-construction mistake. Full list in deliverables/ZERO_BYTE_OBJECTS.md.",
   "severity": "caution",
   "date_identified": "2026-08-05",
   "affects_results": false,
   "affected_releases": [
    "2021/resstock_amy2018_release_1",
    "2021/resstock_tmy3_release_1"
   ],
   "status": "wont_fix",
   "status_date": "2026-08-05",
   "source": "review"
  },
  {
   "id": "amy2012-missing-directories",
   "summary": "Release lacks weather/, geographic_information/, building_energy_models/ and comparisons/, all of which its amy2018 sibling has. The weather/ gap is the most consequential: AMY 2012 weather is what distinguishes this release and those files are not published elsewhere in the repository. Under investigation -- may be intentional asset sharing with the sibling release.",
   "severity": "caution",
   "date_identified": "2026-08-04",
   "affects_results": false,
   "affected_releases": [
    "2025/resstock_amy2012_release_1"
   ],
   "status": "open",
   "status_date": "2026-08-05",
   "source": "review"
  }
 ]
}