Bauklimatik-Dresden DELPHINCONDTHERAKLESNANDRADMASTERSIM SchulungenDownloads Impressum English
Dokumentation & Hilfe
StartseiteDokumentation & HilfeScreenshotsFAQBestellung & LizenzenKontakt
    START»MASTERSIM»DOKUMENTATION & HILFE

Software-Dokumentation

Funktionalität

Script-Funktionalität

MasterSim kann durch Skripte gesteuert werden, zum Beispiel für Variationsstudien. Zu diesem Zweck sind Projektdateien als einfache Textdateien gespeichert und können mit Scripten leicht erstellt/bearbeitet werden. Der eigentliche Simulator steht als Kommandozeilentool MasterSimulator zur Verfügung, welches von Skripten aufgerufen werden kann.

Unterstützung bei der FMU Entwicklung

MasterSim kann mittels Kommandozeilenargumenten so konfiguriert werden, dass FMUs autmatisch entpackt werden, oder aber bereits entpackte FMUs verwendet werden. Dadurch können Shared Libraries/DLLs im Debug-Modus übersetzt werden, welche MasterSim dann anstelle der in der FMU gepackten DLL lädt. Dadurch können externe Debugger verwendet werden, um das Verhalten der FMUs im Co-Simulationsszenario zu testen. Außerdem kann man so direkt Fehler in der modelDescription-Datei beheben, ohne jeweils die FMU neu packen zu müssen.

Simulation-Szenarien mit mehreren FMU Instanzen

MasterSim unterstützt das mehrfache Instanziieren der gleichen FMU innerhalb eines Simulationsszenarios. Damit FMU Instanzen beim schreiben eigenen Ausgaben sich nicht gegenseitig überschreiben, gibt es eine definierte Verzeichnisstruktur und FMU-spezifische Wurzelverzeichnisse werden an jeden FMU-Slave übergeben. Diese ermöglicht auch die gleichzeitige Ausführung mehrerer Simulationszenarios (MasterSimulation Ausführungen), wobei die gleiche FMU verwendet wird.

All die anderen netten Funktionen...

... sind auf der Wiki-Seite beschrieben.

API Dokumentation

Die aktuellste Dokumentation kann aus den SVN-Quellen generiert werden, unter Verwendung des Doxygen Programms. Siehe doc Verzeichnis im Quelltext.

 

Fehler, Funktionswünsche, Danksagungen und Beschwerden

Das Sourceforge Projekt verfügt auch über ein Fehlerreport/Anfrage-System, wo man Fehler melden kann und neue Funktionen beschreiben kann.

 
 

Tutorials

Getting Started Tutorial of the MasterSim User Interface

This tutorial illustrates usage of the MasterSimulator user interface to setup a co-simulation scenario.

First step is to create a new project. From the welcome page choose Create project... or from the file menu New....

Defining Simulators/Importing FMUs

Once the project has been created it should be saved to some location. For this tutorial simply use the directory from the examples with the Math003 files and create a new project file inside this directory.

Now add simulators by selecting FMU files. The slave name is automatically generated from the FMU file name, but can be later edited in the table.

You may even add an FMU file several times, in which case the FMU is instantiated once for each slave.

Once all FMUs have been imported, the connections between the slaves can be made. Before setting connections you may want to set the cycle index for each FMU. FMUs with the same cycle index are solved iteratively, if an iteration method is selected.

Analyzing FMUs

Note: This step is important for the input/output variable tables to be filled.
 

Click on "Analyze FMUs" to parse model description.

A window will show basic information (to be extended in future) about all analyzed FMUs.

Now all input and output variables appear in the "create connection" tables.

Connecting Simulation Slaves

To connect slaves select input and corresponding output in both tables. You can double-click on a variable to create a connection or use the + button.

Slave inputs that are connected disappear from the list of available inputs.

Once all connections are made, the input variable table should be empty. However, you can always choose to leave some variables unconnected, in which case only the start/default value will be set at these inputs.

Specifying Simulation Parameters

Finally, you need to set the master algorithm parameters and start the simulation (with the racing flag button).

Post-Processing Tutorial

Simulation output files are stored by the FMUs themselves (see documentation of directory structure) and the master. MasterSim stores all output variables from all FMUs (unless filtered out, see doc) grouped according to type and scientific unit in DataIO file format (see file format specs).

You can use the IBK/TU Dresden PostProcessing tool for detailed analysis (see documentation on PostProc webpage for details). Alternatively, you can extract columns/data sets from the data files with the command line tool and generate CSV files (for use in spreadsheet calculation tools or other postprocessing software).

 

(Auf Hintergrund klicken, um zu schließen)