Running Inchman

Invoke Inchman from the Editor

Inchman can be invoked on the local computer directly from the Editor by pressing the simulate button. The editor then creates the annotated SBML file corresponding to the model and sends a link back to the browser using the inchman:// protocol.

Note

When the user submits the experiment by pressing the simulate button, the editor internally creates an SBML file and sends a link to this file back to the browser. The link is of the form

inchman://simulate/<global id>

and uses the specific protocol inchman:// for communication between the browser and the editor. If you are using Inchman for the first time, or if you are using a different browser, you will get a message which asks you to specify the program for this protocol. You will then have to point the browser to the location of the Inchman Python wrapper script (for example /usr/local/bin/inchman). This choice can be changed at any time by going to Preferences->Applications in your browser and look for the Inchman protocol.

After invokation, a window pops up asking the user to specify the working directory. This is the directory where all Inchman output files will be stored. If the user previously chose to perform parameter sweeps (see Section parameters), Inchman will perform the required number of simulations to cover all combinations of parameter values. These different simulations will be saved in different output files. In contrast, if the user runs a number of experiments for each parameter set (see Section options), the results of all these experiments will be stored in the same file.

Warning

Always check the output log files for errors. Not all errors are caught by the minimal GUI. In particular, any errors which involve the custom Diffusivity-Drift-method will only reveal themselves at compile time.

Invoke Inchman from the Command Line

Inchman can also be invoked from the command line. This can be useful, for example, if Inchman is run on a GPU-enabled cluster or if the user opts to generate the annotated SBML files from a script. For this purpose, two executables are available to the user.

Inchman Python Wrapper

This Python wrapper script is known by the name of inchman and, in a unix environment, by default resides in /usr/local/bin/. This script is called by the editor if the simulation button is pressed by the user. On the command line, it can be invoked by:

$ inchman [options] <SBML-FILE>|<GLOBAL_ID>

The wrapper looks for any parameter sweep options in the <SBML-file> and computes the required parameter combinations. For each combination, it then invokes the Inchman binary. The wrapper script can also be called with a reference to to an editor model of the form inchman://simulate/<global id>. In this case, the wrapper attempts to fetch the model with the given id from the server first.

--no-display

Specifically asks Inchman not to show the progress window. If this option is selected, a working directory must be given explicitly.

--datadir

This will be the working directory.

--pbs

This option is useful, if Inchman is run on cluster that supports the PBS job scheduling system. If this option is checked, Inchman will create a PBS script file for each experiment and submit it to the queue. Since the syntax of these files is very platform dependent, the user will most likely have to adapt the template file. The template can be found in the Python package gpgmp.common.pbs.

--pbs-walltime=<walltime>

Can be used in conjunction with the --pbs option and allows the user to specify a maximum wall time for the PBS run.

Inchman Binary

The binary file inchman-exec is the actual simulator. It can be invoked by:

$ inchman-exec [options] <model-file>

and takes a <model-file> as an argument. Note that the binary cannot perform any parameter sweeps.

--output=<output file>

Tells Inchman to save the simulation output to the file <output file>

--p <name>=<value>

Sets the parameter <name> to value <value>. This is used by the wrapper script to do parameter sweeps.

--cl-source=<cl-directory>

This option can be used to tell Inchman where to find the Open-CL template files.

Table Of Contents

Previous topic

Editor

Next topic

Analyzing the simulation output

This Page