JAMS Start

From ILMS-Wiki
(Difference between revisions)
Jump to: navigation, search
 
(Transferring Model Parameters when Starting JAMS-Start)
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==JAMS starten==
+
[[de:JAMS_Start]]
Der Start von JAMS kann auf zwei Wegen erfolgen:
+
[[pt:Iniciando_o_JAMS]]
# durch Ausführen der Datei jams.exe (jams für Linux) im JAMS-Installationsverzeichnis
+
==Starting JAMS==
# durch Ausführen von JAVA im JAMS-Installationsverzeichnis unter Angabe des JAMS-Archivs: java -jar lib/JAMS.jar
+
Starting JAMS can be done in two ways:
 +
# Executing the file jams.exe (jams for Linux) in the JAMS installation directory
 +
# Executing JAVA in the JAMS installation directory by indicating the JAMS archive: java -jar lib/JAMS.jar
  
Die zweite Möglichkeit ist geeignet für Fälle, in denen eine andere als die im Installationspaket vorhandene JAVA-Installation verwendet werden soll oder wenn die Datei jams.exe nicht existiert. Bei diesem direkten Aufruf von JAVA können darüber hinaus zusätzliche Parameter an die virtuelle Maschine übermittelt und sämtliche Ausgaben von JAMS einschließlich Fehlermeldungen eingesehen werden. Ein Beispiel für die Angabe zusätzlicher Parameter ist die Voreinstellung des initialen und maximalen Speicherplatzes, welcher bei der JAMS-Ausführung zur Verfügung steht. Eine Reservierung von initialen 300MB und maximalen 500MB Speicherplatz kann so etwa mit folgendem Aufruf sichergestellt werden:
+
The second option is suitable if a different file than that in the installation package is to be used or if the file jams.exe does not exist. The direct call of Java also makes it possible to transfer additional parameters to the virtual machine and to show the entire output of JAMS including error messages. An example of indicating additional parameters is presetting the initial and maximum memory space, which is available when executing JAMS. 300MB as initial space and 500MB as maximum can be reserved by using the following call:
 
  java -Xms300m -Xmx500m -jar lib/JAMS.jar
 
  java -Xms300m -Xmx500m -jar lib/JAMS.jar
  
==JAMS Kommandozeilenargumente==
+
==JAMS Command Line Argument==
Beim Start von JAMS können folgende Kommandozeilenargumente verwendet werden:
+
When starting JAMS the following command line arguments can be used:
# -h/--help : Liste aller Kommandozeilenargumente
+
# -h/--help : list of all command line arguments
# -c/--config <config file name> : Angabe einer [[Systemkonfiguration|Systemkonfigurationsdatei]]
+
# -c/--config <config file name> : indicating a [[System Configuration File|system configuration file]]
# -m/--model <model file name> : Angabe einer [[Modelldefinition|Modelldefinitionsdatei]]
+
# -m/--model <model file name> : indicating a [[Model Definition|model definition file]]
# -p/--parametervalue <list of parameter values> : Angabe einer Semikolon-separierten Liste von Parameterwerten.
+
# -p/--parametervalue <list of parameter values> : indicating a list of parameters, separated by semicolons.
  
Ein typischer Start von JAMS mit direkter Angabe der Modellkonfigurationsdatei könnte somit wie folgt aussehen:
+
A typical start of JAMS using a direct indication of a model configuration file could be as follows:
 
  java -jar lib/JAMS.jar -m JAMS-Gehlberg/j2k_gehlberg.jam
 
  java -jar lib/JAMS.jar -m JAMS-Gehlberg/j2k_gehlberg.jam
  
==Modellparameter beim JAMS-Start übergeben==
+
==Transferring Model Parameters when Starting JAMS-Start==
  
Das Kommandozeilenargument -p/--parametervalue erlaubt die Angabe einer Semikolon-separierten Liste von Parameterwerten (z.B. "0.1;7;1996-11-01 7:30 2000-10-31 7:30 6 1"). Die Zuordnung dieser Werte zu Modellparametern in JAMS erfolgt dabei über ihre Position in der Liste. Dazu müssen in der [[Modellkonfiguration|Modellkonfigurationsdatei]] Platzhalter an denjenigen Stellen eingefügt werden, an denen die übergebenen Parameterwerte eingefügt werden sollen. Diese Platzhalter haben die Form "%x", wobei x eine bei 0 startende, fortlaufende natürliche Zahl ist. Im Beispiel
+
The command line argument -p/--parametervalue allows an indication of a semicolon-separated list of parameters values (e.g. "0.1;7;1996-11-01 7:30 2000-10-31 7:30 6 1"). Assigning the values to model parameters in JAMS is done by their positioning in the list. For this purpose, wildcards have to be inserted in the [[Model Configuration|model configuration file]] at those positions where the transferred parameter values are to be inserted. Those wildcards have the form "%x", where x is a natural, consecutive number starting at 0. In the example
 
  java -jar lib/JAMS.jar -m JAMS-Gehlberg/j2k_gehlberg.jam -p "0.1;7;1996-11-01 7:30 2000-10-31 7:30 6 1"
 
  java -jar lib/JAMS.jar -m JAMS-Gehlberg/j2k_gehlberg.jam -p "0.1;7;1996-11-01 7:30 2000-10-31 7:30 6 1"
würde in j2k_gehlberg/j2k_gehlberg.jam dann der Platzhalter "%0" durch "0.1",  
+
the wildcard "%0%" would be replaced by "0.1", then "%1%" by "7", and "%2%" by "1996-11-01 7:30 2000-10-31 7:30 6 1" in j2k_gehlberg/j2k_gehlberg.jam.  
der Platzhalter "%1" durch "7" und der Platzhalter "%2" durch "1996-11-01 7:30 2000-10-31 7:30 6 1" ersetzt werden.  
+
  
Auf diese Weise ist es leicht möglich, Modellparameter bereits beim JAMS-Start mit vorgegebenen Werten zu versehen, was beispielsweise bei der Batch-Prozessierung von Simulationsläufen erforderlich ist.
+
In this way it is easily possible to assign given values to model parameters when starting JAMS, such as required in the Batch processing of simulation runs.

Latest revision as of 15:08, 19 June 2018

Starting JAMS

Starting JAMS can be done in two ways:

  1. Executing the file jams.exe (jams for Linux) in the JAMS installation directory
  2. Executing JAVA in the JAMS installation directory by indicating the JAMS archive: java -jar lib/JAMS.jar

The second option is suitable if a different file than that in the installation package is to be used or if the file jams.exe does not exist. The direct call of Java also makes it possible to transfer additional parameters to the virtual machine and to show the entire output of JAMS including error messages. An example of indicating additional parameters is presetting the initial and maximum memory space, which is available when executing JAMS. 300MB as initial space and 500MB as maximum can be reserved by using the following call:

java -Xms300m -Xmx500m -jar lib/JAMS.jar

JAMS Command Line Argument

When starting JAMS the following command line arguments can be used:

  1. -h/--help : list of all command line arguments
  2. -c/--config <config file name> : indicating a system configuration file
  3. -m/--model <model file name> : indicating a model definition file
  4. -p/--parametervalue <list of parameter values> : indicating a list of parameters, separated by semicolons.

A typical start of JAMS using a direct indication of a model configuration file could be as follows:

java -jar lib/JAMS.jar -m JAMS-Gehlberg/j2k_gehlberg.jam

Transferring Model Parameters when Starting JAMS-Start

The command line argument -p/--parametervalue allows an indication of a semicolon-separated list of parameters values (e.g. "0.1;7;1996-11-01 7:30 2000-10-31 7:30 6 1"). Assigning the values to model parameters in JAMS is done by their positioning in the list. For this purpose, wildcards have to be inserted in the model configuration file at those positions where the transferred parameter values are to be inserted. Those wildcards have the form "%x", where x is a natural, consecutive number starting at 0. In the example

java -jar lib/JAMS.jar -m JAMS-Gehlberg/j2k_gehlberg.jam -p "0.1;7;1996-11-01 7:30 2000-10-31 7:30 6 1"

the wildcard "%0%" would be replaced by "0.1", then "%1%" by "7", and "%2%" by "1996-11-01 7:30 2000-10-31 7:30 6 1" in j2k_gehlberg/j2k_gehlberg.jam.

In this way it is easily possible to assign given values to model parameters when starting JAMS, such as required in the Batch processing of simulation runs.

Personal tools
In other languages