User Manual

Documentation is available as:

• Online manual
• Printed manual [MasterSim_manual_en.pdf]
• Online manual (german)
• Printed manual (german) [MasterSim_manual_de.pdf]

The following scientific publications, presentations and research reports are available about MASTERSIM:

• Nicolai, A. and Söhnchen, A.; FMI Co-Simulation between 2D/3D component models and HVAC/control models, 2021, Building Simulation Conference 2021, Brugge
  [Nicolai_Soehnchen_2021_BuildingSim_CoSimulation_DelphinControlModel.pdf]
• Nicolai, A., Paepcke, A. and Hirsch, H.; Robust and accurate co-simulation master algorithms applied to FMI slaves with discontinuous signals using FMI 2.0 features, 2019, 13th International Modelica Conference, Munich
  [Nicolai_et_al_2019_ModelicaConference_CoSimAlgorithms.pdf]
• Nicolai, A.; Validierung des Co-Simulations-Masterprogramms MASTERSIM, 2019, Technical Report
  [Nicolai_2019_Validierung_des_CoSimulations_Masterprogramms_MasterSim.pdf]
• Nicolai, A.; Co-Simulation-Test Case: Predator-Prey (Lotka-Volterra) System, 2019, Technical Report
  [Nicolai_2019_MasterSim_ErrorTests_with_Lotka_Volterra_Model.pdf]
• Nicolai, A.; Co-Simulations-Masteralgorithmen - Analyse und Details der Implementierung am Beispiel des Masterprogramms MASTERSIM, 2018, Qucosa, http://nbn-resolving.de/urn:nbn:de:bsz:14-qucosa2-319735.
  [Nicolai_2018_Qucosa_MasterSim_Algorithmus.pdf (in german)]
• Nicolai, A. and Paepcke, A.; Co-Simulation between detailed building energy performance simulation and Modelica HVAC component models, 2017, 12th International Modelica Conference, Prague
  [Nicolai_2017_Modelica_NANDRAD_CoSim.pdf]
  [Nicolai_2017_Modelica_NANDRAD_CoSim_praesentation.pptx]

Special features

Scripting possibilities

MasterSim can be used from scripts, for example when variation studies are done. For that purpose, project files are plain-text and can created/edited with scripts easily. The actual simulator is provided as command line executable MasterSimulator, which can be called from scripts.

Assisting FMU Development

MasterSim can be configured via command line arguments to extract FMUs automatically, or use already extracted FMUs. This allows compilation of the shared libraries/DLLs in debug mode and let MasterSim load these librares, instead of those packaged in the FMU, which allows external debugger use. Also, you can directly fix errors in the modelDescription file without unpacking/repacking the FMU archive.

Simulation Scenarios with several FMU instances

MasterSim supports multiple instances of the same FMU within one simulation scenario. In order to avoid FMU instances overwriting each others results, a directory structure layout is defined and FMU-specific base paths are communicated to each FMU slave. This allows batch processing/parallel execution of several simulation scenarios (runs of MasterSimulator) where the same FMU is instantiated many times.

Bugs, feature wishes, thanks and complains

The GitHub project also hosts a bug/request tracker where you can create issues/tickets about bugs and problems or describe features that you might miss.