Installation

Supported Environments#

Power Balance Models (PBM) has been confirmed to work on:

• Ubuntu 20.04 - 21.10
• Windows 7 SP1*
• Windows 10*

* using Python for Windows and CMD.

The PBM is not tested on Mac systems. The software requires:

• Python >= 3.8.6. Recommended version is 3.9.9, which you can download from the bottom of the page here);
• OpenModelica >= 1.14.4. Recommended version is 1.17.0, which you can download from here (Windows) or here (Unix) (instructions in https://www.openmodelica.org/download/download-linux). Installation on Mac (not stable) can be found here;

It is recommended you run the software from within a virtual environment system such as PyEnv or the built-in venv module, this ensures there is no interference with your system python installation. Alternatively you can install it under the current user.

Installation for UNIX and Windows#

Downloads are available here. You can install the package using pip on the wheels file:

pip install power_balance-<version>-py3-none-any.whl

To install this package you will firstly need to install OpenModelica to your system. The module works by either finding the location of an omc installation (in the case of UNIX) or using the environment variable %OPENMODELICAHOME% in the case of Windows.

Installing OpenModelica Compiler#

For Windows users will need to install the complete OpenModelica application using the dedicated installer found on the project website.

Linux users only require omc and the Modelica Standard Library:

echo "deb https://build.openmodelica.org/apt `lsb_release -cs` stable" | sudo tee /etc/apt/sources.list.d/openmodelica.list
wget -q http://build.openmodelica.org/apt/openmodelica.asc -O- | sudo apt-key add - 
sudo apt update
sudo apt install -y omlib-modelica-3.2.3 omc

Installation on Mac is not tested and not supported by the Power Balance team, primarily because of the difficulty associated with installing OpenModelica on Mac.

powerbalance generate-profiles

Testing#

You can verify your install is working correctly by either running the default configuration using the powerbalance command, or by running the included tests using pytest:

pytest -s tests/