Link Search Menu Expand Document

DES Installation

There are three major steps to running the GeoJSON to Modelica Translator (GMT):

  1. generating the GeoJSON and System Parameter JSON files,
  2. creating of the Modelica package containing the district system, and
  3. running the Modelica package.

Depending on the use case, the need to run all the steps above may not be needed. For example: it may be desirable to only generate the Modelica package and then open and run the model in a Modelica user interface such as Dymola. Or, there may be a case to simply generate the GeoJSON and System Parameter file from results of an URBANopt SDK simulation result set.

This Installation guide is broken up into three major setup steps:

  1. Installing the GMT from PyPi
  2. Installing and configuring the Modelica Buildings Library (MBL)
  3. Installing and configuring Docker in order to run simulations using JModelica

GMT Installation

You must have PIP and Python 3.7 or later installed (run python --version to see what version you’re using). After installing Python and PIP run the following in a terminal (requires Python 3):

 pip install geojson-modelica-translator

After installation of the GMT, a new command line interface (called the URBANopt District Energy Systems [UO DES] CLI) can be used to run various commands. Without needing to install the MBL the user can use the CLI to build the system parameters file from the results of the URBANopt SDK. For more information run the following:

  uo_des -h
  uo_des build-system-param -h

  # the command below is only an example; however, it will run if the repository
  # is checked out and run in the following path: ./tests/management/data/sdk_project_scraps
  uo_des build-sys-param sys_param.json baseline_scenario.csv example_project.json

MBL Installation

The Modelica Buildings Library contains many models that are needed to assemble the district systems. Installation of the MBL is done through Git and GitHub. Follow the instructions below to install the MBL needed for the GMT:

  • Clone the MBL into a working directory outside of the GMT directory
  • Change to the directory inside the modelica-buildings repo you just checked out. (cd modelica-buildings)
  • Install git-lfs
    • Mac: brew install git-lfs; git lfs install
    • Ubuntu: sudo apt install git-lfs; git lfs install
  • Pull the correct staging branch for this project with: git checkout v9.0.0. Note that the git repo will be in a detached head state, which is expected.
  • Add the Modelica Buildings Library path to your MODELICAPATH environment variable (e.g., export MODELICAPATH=${MODELICAPATH}:$HOME/path/to/modelica-buildings). Restart your terminal to ensure that the MBL library is exported correctly.

Once the MBL is installed, the CLI can be used to create the model with the following command:

  uo_des create-model -h

  # the command below is only an example; however, it will run if the repository
  # is checked out and run in the following path: ./tests/management/data/sdk_project_scraps
  uo_des create-model sys_param.json

The resulting Modelica package will be created and can be opened in a Modelica editor. Open the file in the root directory of the generated package. You will also need to load the MBL into your Modelica editor.

Docker Installation

In GMT version 0.3.0, the only method of running the simulations is within Dymola or OpenModelica. We are working on an approach that will reenable the Docker-based solution that is described below.

The GMT versions prior to 0.3.0 enabled running of the models using JModelica. It requires the installation of Docker. To configure Docker, do the following:

  • Install Docker for your system.
  • Configure Docker Desktop to have at least 4 GB Ram and 2 cores. This is configured under the Docker Preferences.
  • It is recommended to test the installation of Docker by simply running docker run hello-world in a terminal.

After Docker is installed and configured, you can use the CLI to run the model using the following command:

  uo_des run-model -h

  # the command below is only an example; however, it will run if the repository
  # is checked out and run in the following path: ./tests/management/data/sdk_project_scraps
  uo_des run-model model_from_sdk

URBANopt, Copyright (c) 2019-2022, Alliance for Sustainable Energy, LLC, and other contributors. All rights reserved.