.Buildings.Obsolete.ThermalZones.EnergyPlus_9_6_0.UsersGuide.Installation

Information

Installation of binaries

The official release of the Modelica Buildings Library that can be downloaded at simulationresearch.lbl.gov/modelica/download.html contains all binaries required to simulated the models in Buildings.ThermalZones_9_6_0. You should not have to do any other installations or settings and skip the instructions below.

However, binaries can also be downloaded and installed either using an installation script or using a manual installation. This is only required for users who clone the Buildings library from github. Developers may install or build these binaries individually.

There are three different binaries:

1. The Spawn of EnergyPlus library that contains a special version of EnergyPlus.
2. The Modelica to EnergyPlus library that provides a layer to link Modelica with EnergyPlus.
3. The fmi-library that provides the API functions that communicate with EnergyPlus.

To install or build these libraries, proceed as described below.

Spawn of EnergyPlus library

If the Buildings library is cloned from github, then the EnergyPlus libraries need to be installed by running

Buildings/Resources/src/ThermalZones/install.py --binaries-for-os-only

To install the binaries for all operating systems, omit the flag --binaries-for-os-only.

Modelica to EnergyPlus

Rebuilding this library requires CMake to be installed.

To rebuild the library, run

cd modelica-buildings
rm -rf build && mkdir build && cd build && \
  cmake ../ && cmake --build . --target install && \
  cd .. && rm -rf build

fmi-library

Rebuilding this library requires CMake to be installed.

To rebuild the library, run

cd Buildings/Resources/src/fmi-library
rm -rf build && mkdir build && \
  cd build && cmake .. && cmake --build . && \
  cd .. && rm -rf build

Manual installation of the libraries without using a script

Alternatively, instead of using install.py, the binaries can be downloaded from the following links:

To install, proceed as follows:

wget https://spawn.s3.amazonaws.com/custom/Spawn-light-0.5.0-ab07bde9bb-Linux.tar.gz;
tar xzf Spawn-light-0.5.0-ab07bde9bb-Linux.tar.gz;
export PATH=${PATH}:`pwd`/Spawn-light-0.5.0-ab07bde9bb-Linux/bin

How is spawn invoked?

Modelica tries to invoke spawn-0.5.0-ab07bde9bb[.exe] in this order:

1. On Linux, it searches for

   Buildings[ x.y.z]/Resources/bin/spawn-0.5.0-ab07bde9bb/linux64/bin/spawn-0.5.0-ab07bde9bb
   

   and on Windows, it searches for

   Buildings[ x.y.z]/Resources/bin/spawn-0.5.0-ab07bde9bb/win64/bin/spawn-0.5.0-ab07bde9bb.exe
   

   where Buildings[ x.y.z] is the installation folder of the Modelica Buildings Library. This file is distributed with the Modelica Buildings Library installation, together with all files needed to translate and simulate a model in a Modelica environment.
2. If not found, it searches on the environment variable SPAWNPATH for spawn-0.5.0-ab07bde9bb[.exe].
3. If not found, it searches on the environment variable PATH for spawn-0.5.0-ab07bde9bb[.exe].

If none of this succeeds, it will stop with an error.