This workflow is available in URBANopt versions 0.11.0 and later
The URBANopt-Geothermal Heat Pump (GHP) workflows are used for modeling and simulation of district-scale GHP systems. URBANopt is used to calculate building loads connected to the GHP system. The building loads along with technical specifications for the GHP system, stored in the system parameter file, are used for sizing and simulations of custom district GHP systems. The installation and usage of these capabilities are described below.
Run the following URBANopt CLI command to install Python and the required GHP-related dependencies:
In order to use the URBANopt-GHP capabilities, the example
GHP Project can be created and run using the URBANopt CLI following the steps below:
Create a GHP project by including the
-gas a shortcut) in the create command:
uo create --project-folder <path/to/ghp/folder> --ghe
This will create an URBANopt example project which includes a feature file with a single pipe closed GHP network as shown in the figure below:
The Feature File includes the footprint area of the GHP will be used as an input for GHP sizing.
Scenario files are created next using the following command:
uo create --scenario-file <path/to/FEATUREFILE.json>
Run the project using the GHP feature file, and the scenario file created in the previous step:
uo run --feature <path/to/GHP/featurefile.json> --scenario <path/to/SCENARIOFILE.csv>
Post-process using the default post-processor, this generates the timeseries building loads (kW) using the
export_modelica_loadsmeasure and stored in the run folder for the scenario:
uo process --default --feature <path/to/FEATUREFILE.json> --scenario <path/to/SCENARIOFILE.csv>
This is used to create a system parameters file that stores technical properties related to GHP components such as boreholes, soil, fluid, and pipe definitions.
The following command can be used to create the system parameters file:
uo des_params --sys-param-file <path/to/sys_param.json> --feature <path/to/FEATUREFILE.json> --scenario <path/to/SCENARIOFILE.csv> --ghe
ghe_specific_paramssection within the system parameters file generated by this command stores properties for each GHP in the network. It pulls the GHP ID as well as the length and width of GHP from the feature file.
Sizing the GHP system involves calculating properties such as number of boreholes, length of boreholes, and the g-function.
This is done using the following command:
uo ghe_size --sys-param-file <path/to/sys_param.json> --feature <path/to/FEATUREFILE.json> --scenario <path/to/SCENARIOFILE.csv> --ghe
On running this command, a new folder
ghe_diris created that stores sizing results such as the g-function and the ground loads for the GHP. The system parameters file is also updated with the results of sizing such as the number of boreholes and length of boreholes.
This uses the URBANopt-DES module to create a Modelica package for the sized GHP network, as shown in the DES Functionality section. It takes in the building loads, GHE sizing results, and the system parameter file with GHE-specific properties to create the Modelica package for the district thermal energy system.
The following command is used:
uo des_create --sys-param-file <path/to/sys_param.json> --feature <path/to/FEATUREFILE.json> --des-name <path/to/example_modelica_project>
uo des_run --model <path/to/modelica_dir>