Tool for paralell simulations and verification
Java Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
R
application
benchmark
core
docs
experiments
extensions
gradle/wrapper
lib
model
resources
scripts
util
.gitignore
.travis.yml
LICENSE.txt
README.markdown
build.gradle
gradlew
gradlew.bat
license_template.txt
servers-shutdown.sh
servers-start.sh
settings.gradle

README.markdown

Parasim

Parasim is a tool for robustness analysis. For information not covered in this README visit the Parasim wiki.

Requirements

  • Runtime: Java (7+), octave (simulation framework is based on octave)
  • Building: gradle (available through wrapper)

Running Parasim

You can download latest Parasim prebuilt as a zip archive in the release section [LINK NEEDED]. Then use bin/parasim (Unix) or bin/parasim.bat (Windows) to execute Parasim.

Note: In the latest version of Parasim, all distributed components have been deprecated. However, the shared memory parallelisation should be still usable.

Parasim options

Parasim can be executed either in GUI mode (no command line arguments), or in command line mode (argument -t or --terminal).

Command Line Options

  • -v, --version Print parasim version and exits.

  • -h, --help Print command line (condensed) options and exits.

  • -c <file>, --confing <file> Specify parasim configuration file (other than default).

  • -e <file>, --experiment <file> (mandatory) Specify file containing experiment specification (see experiment file format).

  • -r, --result Do not execute experiment, only print result contained in file specified by experiment file (see above). Note: This will result in error when the result file is not present.

  • -csv <file>, --csv <file> Specify destination file for CSV export.

  • -b, --batch Disable result plotting.

  • -s, --server [Deprecated] Start Parasim server only.

  • -t, --terminal Use command line interface.

Examples

parasim.sh -e experiment.properties

Execute experiment described in experiment.properties (see experiment file format) and plot result.

parasim.sh -e experiment.properties -r

Load result from file referenced in experiment.properties and plot it. Do not execute the experiment. Note: The result file must exist, i.e. the experiment has already had to be executed.

Building Parasim

To build and test Parasim, run:

./gradlew clean build

You can also use assemble to build without testing or check to explicitly run tests.

If you want to run Parasim directly, withouth creating distribution binaries, use:

./gradlew run

If you want to create the distribution archive, run:

./gradlew distZip

The distribution .zip will then be located in the application/build/distributions folder. Alternatively, you can generated the contents of the .zip file into application/build/install by calling:

./gradlew installDist

Finally, to regenerate license headers use gradle commands license and licenseFormat (If you have your own Gradle insallation, you can run gradle instead of ./gradlew)