Feature/weather infrastructure

[afontani]

Pull Request Description

Companion PR: resstock-estimation #95

This PR generalizes the weather data available for a given AMY or TMY analysis. ResStock currently uses 941 static weather stations. The stations are used based on the Location.tsv.

The issue with the current approach is that if the data from a particular weather station 1) has errors or does not exist for the year of interest and/or 2) is not consistent with corresponding TMY stations the weather file name in options_lookup.tsv or the Location.tsv needs to change to simulate different years or run a TMY analysis.

In an effort to simply replace the weather zip file based on the best available data for the given analysis (AMY or TMY), the weather files have been named based on their county GEOID in options_lookup.tsv.

Example:

County | AL, Autauga County | ResidentialLocation | dst_start_date=April 7 | dst_end_date=October 26 | weather_directory=../../../../weather | weather_file_name=G0100010.epw

The new weather zip files are named BuildStock_<year>.zip where year is for example 2019, 2018, ... or TMY3. In these files there exists a mapping file (example: map_FIPs_TMY3s.csv) that states the weather station that is used for a given county and other meta data. In this approach, the Counties that correspond to a given weather station is flexible and not static.

New TMY3 weather data

TMY3 weather data that correspond to the new structure can be downloaded from this link: https://data.nrel.gov/submissions/156

Checklist

Not all may apply:

• Unit tests have been added or updated
• All rake tasks have been run, and pass
• Documentation has been modified appropriately
• Any new options are added to project_testing
• project_testing runs without any failures
• No unexpected regression test changes
• All tests are passing (green) on circleci
• The changelog has been updated appropriately
• This branch is up-to-date with develop

For more information on how to perform these checklist items, see the documentation's Advanced Tutorial.

[afontani]

@joseph-robertson: The weather data is available to download (https://data.nrel.gov/submissions/156). I updated the national.yml file to reflect the correct download path. If this comes back green, I think this is about ready.

[joseph-robertson]

This needs to be changed as well, right? https://github.com/NREL/resstock/blob/feature/weather_infrastructure/project_testing/testing.yml#L6

[joseph-robertson]

I think you should choose up to 6 counties as options. Corresponding epw files will need to be added to resources/measures/HPXMLtoOpenStudio/weather/project_testing (which are used in unit testing).

[afontani]

Oh. You are right. I think this commit is going to fail the tests.