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 :ref:`buildstockbatch <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 :ref:`run_analysis.rb <run_analysis>`.
Download the version of OpenStudio software (corresponding to the ResStock version that has been selected) from the OpenStudio developer website.
If you will be developing residential measures and testing residential building models, see the :ref:`advanced_tutorial`. If you are a developer, make sure that you have checked out the develop
branch of the repository.