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.
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.
Download the version of OpenStudio software (corresponding to the ResStock version that has been selected) from the OpenStudio developer website.