BlueM.Sim application: Difference between revisions

Revision as of 04:11, 13 May 2009

BlueM.Sim | Downloads | Application | Theory | Development

This page is an aid to the application of BlueM.

Record

A record consists of several text files. Mandatory for each simulation are ALL- (general information) and the SYS file - (System Plan). Furthermore, files for a description of the system elements should be in the required manner. All files must have the same file name (name = record), only the file extensions differ. (The name of the record shall consist of not more than 32 characters! See Bug 13)
It is possible to make a record using TALSIM, after creating these can be exported and used for BlueM. These are minor modifications to the export files. See TALSIM Export.

See also Input files

Simulation

BlueM.Win Screenshot

Release 0.9.1

For individual simulations, it is easiest to use the BlueM.Win package.

Download the prebuilt package BlueM.Win.zip and unzip.
Start the file BlueM.Win.exe
Select a record
Start simulation
After successful simulation, view the simulation result in BlueM.Wave.

For bluem.dll from another application address, the BlueM.DLLAdapter can be used.

Release 0.9

BlueM.exe Screenshot

In the simplest case the compiled EXE file (BlueM.exe) is in the same directory as the data to be simulated. In this case, simply launch the EXE at the request of the record name. Then the simulation starts.
You can specify the name of the data directly as a parameter to pass to BlueM.exe

<dos>C:\Arbeitsverzeichnis>"Pfad\zu\BlueM.exe" Datensatzname</dos>

To prevent the window from closing immediately when the simulation is finished or an error has occurred, a shortcut to BlueM.exe can be created. In the properties of the shortcut enter the following "target" :

cmd.exe /K "Pfad\zu\BlueM.exe"

Under "Start in" the working directory must be specified, i.e., the directory in which the record is located.

Results

Depending on the setting BlueM creates result files. By default, the WEL-file.

See also output files

Errors / warnings

In some cases, the blue model for a global program termination gives an ERROR-Constant back. (In case a $FEHL.TMP file is generated, there is also the ERROR constant in the left column).
Warnings (eg, Buffer overflows) are written during the simulation in the file $WARN.TMP .

@@ Line 1: / Line 1: @@
 __NOTOC__
 {{BlueM_nav}}
-Diese Seite ist eine Hilfe zur Anwendung von BlueM.
+This page is an aid to the application of BlueM.
-==Datensatz==
+==Record==
-* Ein Datensatz besteht aus mehreren Textdateien. Obligatorisch für jede Simulation sind die [[TSIM.ALL|ALL]]- (Allgemeine Angaben) und die [[TSIM.SYS|SYS]]-Datei (Systemplan). Darüber hinaus sind Dateien für die Beschreibung der abzubildenden Systemelemente erforderlich. Alle Dateien müssen den gleichen Dateinamen (= Datensatzname) haben, nur die Dateiendungen unterscheiden sich. <small>(Der Name des Datensatzes darf aus nicht mehr als 32 Zeichen bestehen! ''siehe Bug 13'')</small>
+* A record consists of several text files. Mandatory for each simulation are [[TSIM.ALL|ALL]]- (general information) and the [[TSIM.SYS|SYS]] file - (System Plan). Furthermore, files for a description of the system elements should be in the required manner. All files must have the same file name (name = record), only the file extensions differ. <small>(The name of the record shall consist of not more than 32 characters! ''See Bug 13'')</small>
-* Es ist möglich, einen Datensatz mithilfe von [[TALSIM]] zu erstellen, dieser kann dann exportiert werden und für BlueM verwendet werden. Dazu sind kleinere Modifikationen an den Exportdateien erforderlich. Siehe [[TALSIM Export]].
+* It is possible to make a record using [[TALSIM]], after creating these can be exported and used for BlueM. These are minor modifications to the export files. See [[TALSIM Export]].
-''Siehe auch [[BlueM Eingabedateien|Eingabedateien]]''
+''See also [[BlueM Eingabedateien|Input files]]''
 ==Simulation==
 [[Bild:BlueMWin_screenshot.png|thumb|BlueM.Win Screenshot]]
-===ab Release 0.9.1===
+===Release 0.9.1===
-Für einzelne Simulationen ist es am einfachsten, das Paket '''[[BlueM.Win]]''' zu nutzen.
+For individual simulations, it is easiest to use the '''[[BlueM.Win]]''' package.
-* Das vorkompilierte Paket <code>BlueM.Win.zip</code> [[BlueM Downloads|herunterladen]] und entpacken.
+* [[BlueM Downloads|Download]] the prebuilt package <code>BlueM.Win.zip</code>  and unzip.
-* Die Datei <code>BlueM.Win.exe</code> starten
+* Start the file <code>BlueM.Win.exe</code>
-* Einen Datensatz auswählen
+* Select a record
-* Simulation starten
+* Start simulation
-* Nach erfolgreicher Simulation das Simulationsergebnis in Wave anzeigen.
+* After successful simulation, view the simulation result in BlueM.Wave.
-Um die <code>bluem.dll</code> aus einer anderen Anwendung heraus anzusprechen, kann der [[BlueM.DLLAdapter]] genutzt werden.<br clear="all"/>
+For <code>bluem.dll</code> from another application address, the [[BlueM.DLLAdapter]] can be used.<br clear="all"/>
 ===Release 0.9===
 [[Bild:BlueMExe_screenshot.png|thumb|BlueM.exe Screenshot]]
-* Im Einfachsten Fall befindet sich die kompilierte EXE-Datei ([[BlueM Downloads|BlueM.exe]]) im gleichen Verzeichnis wie der zu simulierende Datensatz. In diesem Fall wird einfach die EXE gestartet und auf Anforderung der Datensatzname eingegeben. Damit wird die Simulation gestartet.
+* In the simplest case the compiled EXE file ([[BlueM Downloads|BlueM.exe]]) is in the same directory as the data to be simulated. In this case, simply launch the EXE at the request of the record name. Then the simulation starts.
-* Man kann den Namen des Datensatzes auch direkt als Übergabeparameter an BlueM.exe übergeben
+* You can specify the name of the data directly as a parameter to pass to BlueM.exe
 :<dos>C:\Arbeitsverzeichnis>"Pfad\zu\BlueM.exe" Datensatzname</dos>
-* Um zu verhindern, dass sich das Dialogfenster sofort wieder schließt, wenn die Simulation beendet ist oder ein Fehler aufgetreten ist, kann man eine Verknüpfung zu BlueM.exe erstellen. In den Eigenschaften der Verknüpfung, bei "Ziel" folgendes eingeben:
+* To prevent the window from closing immediately when the simulation is finished or an error has occurred,  a shortcut to BlueM.exe can be created. In the properties of the shortcut enter the following "target" :
 :<pre>cmd.exe /K "Pfad\zu\BlueM.exe"</pre>
-:Unter "Ausführen in" muss das Arbeitsverzeichnis angegeben werden, d.h. das Verzeichnis, in dem der Datensatz liegt.
+:Under "Start in" the working directory must be specified, i.e., the directory in which the record is located.
-==Ergebnisse==
+==Results==
-* Je nach Einstellung erzeugt BlueM verscheidene Ergebnisdateien. Standardmäßig die [[WEL-Datei]].
+* Depending on the setting BlueM creates result files. By default, the [[WEL-file]].
-''Siehe auch [[BlueM Ausgabedateien|Ausgabedateien]]''
+''See also [[BlueM Ausgabedateien|output files]]''
-===Fehlermeldungen/Warnungen===
+===Errors / warnings===
-* In manchen Fällen gibt das Blaue Modell bei Programmabbruch eine globale '''[[ERROR-Konstanten | ERROR-Konstante]]''' zurück. (Im Fall das eine '''[[$FEHL.TMP]]''' Datei generiert wird, steht dort auch die ERROR-Konstante in der linken Spalte).
+* In some cases, the blue model for a global program termination gives an  '''[[ERROR-Konstanten | ERROR-Constant]]''' back. (In case a  '''[[$FEHL.TMP]]'''  file is generated, there is also the ERROR constant in the left column).
-* Warnungen (z.B. Speicherüberläufe) werden während der Simulation in die Datei '''[[$WARN.TMP]]''' geschrieben.
+* Warnings (eg, Buffer overflows) are written during the simulation in the file '''[[$WARN.TMP]]''' .
 [[Kategorie:BlueM.Sim Anwendung|A]]