Installation instruction for Linux

Background

  • TransiEnt Library 2.0.2 or lower is not directly compatible with any Linux standard distribution.
  • The incompatibility exists due to a bug in the ModelicaStandardLibrary, which does not allow to save more than one environment variable. Therefore, the command ”Modelica.Utilities.System .setEnvironmentVariable(name, path)”, specified in the system specific loadup file (loadTransiEnt.mos), will not work as intended.
  • On the other hand the contrary function Modelica.Utilites.System.getEnvironmentVariable(name) works as intended.
  • In Linux, Dymola is started from an environment specified in the chosen terminal. Therefore, the environment variables can also be specified from outside Dymola over the Terminal settings. Software opened in this Terminal then will inherit specified conditions as the set of environment variables. One more thing to consider is, that the environment variables in Linux Terminals are not allowed to consist of non-ASCII letters, meaning for example “-“ is not allowed. Therefore, some of the often used environment variable names, like “public-data”, will need to be renamed in the TransiEnt Libraries “Basics.Types” section.

Apply in three steps

Following steps were tested with Ubuntu and Arch Linux. First complete points 1 to 5 from the general installation instructions.

  1. Load the TransiEnt Library manually in Dymola (…/transient-sources/transient-library/TransiEnt/package.mo)
  2. Open the /TransiEnt/Basics/Types section with “Open model in new tab” and rename the environment variables. (Only use ASCII letters!)
  3. Open a terminal session and type “nano ~/.bashrc”. Now add your new variable names from  the previous step with your system specific path to represent like in the following picture. Do not forget to export the variable, then save the changes and restart the terminal afterwards. Now you can start Dymola from this terminal session and make use of the environment variables in your Dymola session.
Load package
Rename environment variables
add environment variables to your system