4.4. Command line arguments

4.4. Command line arguments
	Chapter 4. Running simulations with the BCVTB

To start the BCVTB from a console, type

java -jar ["path_to_bcvtb/bin/"]BCVTB.jar [JVM_options] [BCVTB_options [-parameterName value]]

where JVM_options can be any Java Virtual Machine options (type java -h for available options), and BCVTB_options include:

`-file fileName`	Open `fileName`, which must be a Ptolemy II file. The flag `-file` is optional if `fileName` is the last parameter.
`-run fileName`	Open `fileName`, which must be a Ptolemy II file, run the program, and terminate.
`-console fileName`	Open `fileName`, which must be a Ptolemy II file, run the program without opening any windows, and terminate.
`-diagnostics`	Print all environment variables to the console window.
`-command program flags`	Runs the executable `program` with the flags `flags`. Any number of flags are allowed. This allows for example to start a new console that has the same environment variables as any other program started by the BCVTB.

The optional argument -parameterName value are model parameters and their values, such as -endTime 3600. Note that a hyphen must precede the keyword parameterName.

Example 4.1. Examples for command line arguments

To run the file system.xml and terminate the BCVTB after the simulation, type

java -jar BCVTB.jar -run system.xml

or, alternatively, type

java -jar BCVTB.jar -file system.xml -run

To run system.xml as a console application that does not open any windows, type

java -jar BCVTB.jar -console system.xml

If the model system.xml has a top-level parameter named endTime and an actor with name Controller, and Controller contains a parameter named Kp then

java -jar BCVTB.jar -run system.xml -endTime 86400 -Controller.Kp 10

runs the model system.xml up to endTime=86400, with the parameter Kp of the controller set to 10.

If Java runs out of memory, type

java -jar BCVTB.jar -Xmx1024m system.xml

to run system.xml with increased Java heap size.

On Linux, to set environment variables and open a new terminal that can be used to run the Apache Ant build files (see Section 7.6, “Compiling the BCVTB” ), type
```
java -jar BCVTB.jar -command xterm
```


4.3. Running the BCVTB from a terminal window		4.5. Example files