Question-and-Answer Resource for the Building Energy Modeling Community
Get started with the Help page
Ask Your Question

Revision history [back]

resstock: 2007 vs 2018 timestamps in TMY individual building time series files

Hey folks --

The year of the individual building timestamp files is set to 2018 in the 2021 resstock TMY release, but set to 2007 in the 2022 TMY v1 and v1.1 releases (demo below). I haven't found a reason for this in the documentation.

Since this is TMY and not AMY, the absolute date wouldn't seem to matter much, but it does prompt the following questions:

  1. Why the change from 2018 to 2007 between the 2021 and 2022 TMY releases?
  2. Could you confirm that it is appropriate to merge the individual time series files with the weather files for the relevant TMY region, which have timestamps with heterogeneous years, and with the schedules.csv files for the relevant building id, which do not have explicit timestamps?

Thanks kindly.

2021 TMY release has 2018 timestamps:

❯ parquet-tools csv -c timestamp -n 10 s3://oedi-data-lake/nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2021/resstock_tmy3_release_1/timeseries_individual_buildings/by_county/upgrade=0/county=G0100010/105114-0.parquet
timestamp
2018-01-01 00:15:00
2018-01-01 00:30:00
2018-01-01 00:45:00
2018-01-01 01:00:00
2018-01-01 01:15:00
2018-01-01 01:30:00
2018-01-01 01:45:00
2018-01-01 02:00:00
2018-01-01 02:15:00
2018-01-01 02:30:00

2022 TMY releases have 2007 timestamps:

❯ parquet-tools csv -c timestamp -n 10 s3://oedi-data-lake/nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2022/resstock_tmy3_release_1/timeseries_individual_buildings/by_state/upgrade=0/state=AL/100066-0.parquet
timestamp
2007-01-01 00:15:00
2007-01-01 00:30:00
2007-01-01 00:45:00
2007-01-01 01:00:00
2007-01-01 01:15:00
2007-01-01 01:30:00
2007-01-01 01:45:00
2007-01-01 02:00:00
2007-01-01 02:15:00
2007-01-01 02:30:00

❯ parquet-tools csv -c timestamp -n 10 s3://oedi-data-lake/nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2022/resstock_tmy3_release_1.1/timeseries_individual_buildings/by_state/upgrade=0/state=AL/100066-0.parquet
timestamp
2007-01-01 00:15:00
2007-01-01 00:30:00
2007-01-01 00:45:00
2007-01-01 01:00:00
2007-01-01 01:15:00
2007-01-01 01:30:00
2007-01-01 01:45:00
2007-01-01 02:00:00
2007-01-01 02:15:00
2007-01-01 02:30:00

resstock: 2007 vs 2018 timestamps in TMY individual building time series files

Hey folks --

The year of the individual building timestamp files is set to 2018 in the 2021 resstock TMY release, but set to 2007 in the 2022 TMY v1 and v1.1 releases (demo below). I haven't found a reason for this in the documentation.

Since this is TMY and not AMY, the absolute date wouldn't seem to matter much, but it does prompt the following questions:

  1. Why the change from 2018 to 2007 between the 2021 and 2022 TMY releases?
  2. Could you confirm that it is appropriate to merge the individual time series files with the weather files for the relevant TMY region, which have timestamps with heterogeneous years, and with the schedules.csv files for the relevant building id, which do not have explicit timestamps?

Thanks kindly.

2021 TMY release has 2018 timestamps:

❯ parquet-tools csv -c timestamp -n 10 s3://oedi-data-lake/nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2021/resstock_tmy3_release_1/timeseries_individual_buildings/by_county/upgrade=0/county=G0100010/105114-0.parquet
timestamp
2018-01-01 00:15:00
2018-01-01 00:30:00
2018-01-01 00:45:00
2018-01-01 01:00:00
2018-01-01 01:15:00
2018-01-01 01:30:00
2018-01-01 01:45:00
2018-01-01 02:00:00
2018-01-01 02:15:00
2018-01-01 02:30:00

2022 TMY releases have 2007 timestamps:

❯ parquet-tools csv -c timestamp -n 10 s3://oedi-data-lake/nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2022/resstock_tmy3_release_1/timeseries_individual_buildings/by_state/upgrade=0/state=AL/100066-0.parquet
timestamp
2007-01-01 00:15:00
2007-01-01 00:30:00
2007-01-01 00:45:00
2007-01-01 01:00:00
2007-01-01 01:15:00
2007-01-01 01:30:00
2007-01-01 01:45:00
2007-01-01 02:00:00
2007-01-01 02:15:00
2007-01-01 02:30:00

❯ parquet-tools csv -c timestamp -n 10 s3://oedi-data-lake/nrel-pds-building-stock/end-use-load-profiles-for-us-building-stock/2022/resstock_tmy3_release_1.1/timeseries_individual_buildings/by_state/upgrade=0/state=AL/100066-0.parquet
timestamp
2007-01-01 00:15:00
2007-01-01 00:30:00
2007-01-01 00:45:00
2007-01-01 01:00:00
2007-01-01 01:15:00
2007-01-01 01:30:00
2007-01-01 01:45:00
2007-01-01 02:00:00
2007-01-01 02:15:00
2007-01-01 02:30:00