Installation¶
Download ResStock¶
There are two options for downloading ResStock:
- download a released version
- clone the repository
For the first option, go to the releases page on GitHub and select a release. Note the OpenStudio version requirements associated with each version of ResStock. For example, ResStock v2.4.0 requires that you have OpenStudio v2.9.0 installed.
For the second option, you will need to have Git or some other Git-based tool installed. Cloning the ResStock repository gives you access to the develop
branch of ResStock. The develop
branch is under active development.
Note
If you are planning to perform large-scale runs on ResStock (greater than 1000 simulations) or analyze timeseries data, you will need to use buildstockbatch to run and manage batch simulations of ResStock. Buildstockbatch can be run locally via Docker, on AWS, or on an HPC like NREL’s Eagle. Installation instructions can be found in buildstockbatch’s installation documentation.
If you are planning to perform small-scale runs of ResStock (1000 simulations or fewer), you can use the Docker-less option of running locally via run_analysis.rb.
Install OpenStudio¶
Download the version of OpenStudio software (corresponding to the ResStock version that has been selected) from the OpenStudio developer website.
Developer instructions¶
If you will be developing residential measures and testing residential building models, see the Advanced Tutorial. If you are a developer, make sure that you have checked out the develop
branch of the repository.