To run URBANopt, first install the project dependencies and the URBANopt Command Line Interface.
Once the CLI is installed, help is available by typing
uo -h from the command line.
Create a project folder in your current directory using:
uo -p <path/to/PROJECT_DIRECTORY_NAME>
This creates a project folder containing the example project, and downloads related weather files and detailed models to the appropriate folders.
Create an empty base project folder by using:
uo -e -p <path/to/PROJECT_DIRECTORY_NAME>
This creates project folder without an example FeatureFile and an empty weather folder. You can download weather files and add to this folder from energyplus.net/weather.
Overwrite an existing folder by using:
uo -o -p <path/to/PROJECT_DIRECTORY_NAME>
This deletes anything in the named folder and creates a fresh project directory. Can be combined with
-eto overwrite a directory with a new empty URBANopt project directory.
- Put your FeatureFile in the root of the folder you just created, or use the provided example.
- We recommend calling all URBANopt commands from outside the project folder you created, using absolute paths to the relevant files.
Create ScenarioFiles for all Features in the FeatureFile based off the example mappers using:
uo -m -f <path/to/FEATUREFILE>
Or create ScenarioFiles for a single Feature by specifying the Feature_ID in the arguments.
uo -m -f <path/to/FEATUREFILE> -i <FEATURE_ID>
You may write your own mapper file for your own specific use case as needed, as well as make your own ScenarioFile by hand. You may also make edits to the ScenarioFiles to mix and match mappers.
Simulate energy usage of each feature or for a single Feature by specifying the appropriate ScenarioFile by using:
uo -r -f <path/to/FEATUREFILE> -s <path/to/SCENARIOFILE>
Note that there is a runner.conf file automatically created in the project folder. This file is used to configure the number of features to process in parallel as well as a few other parameters. Make edits to this file prior to running the above command.
Gather simulated features into a Scenario report by using:
uo -g -t <TYPE> -f <path/to/FEATUREFILE> -s <path/to/SCENARIOFILE>
Delete an outdated Scenario run by using:
uo -d -s <path/to/SCENARIOFILE>
The figure below describes the workflow that takes place for the run and post_process calls.
The following figure represents how Simulation Mapper Classes can be assigned to different Features from the FeatureFile in the Scenario CSV.