Command-line switches

This page lists the switches accepted by the command-line version of PRISM, grouped as in the output of prism -help. Many of them are described in more detail elsewhere in this manual, and most of the settings they change can also be made in the GUI (from the Options menu) or in the settings file. For switches whose syntax is not obvious, prism -help followed by the switch, e.g., prism -help exportmodel, gives the details shown below.

The list is generated from PRISM itself, so it is complete for this version of PRISM. Switches are typed with a single -, as shown, but -- also works, e.g., --version.

General

  • -help: Display this help message

  • -version: Display PRISM version info

  • -javaversion: Display Java version info

  • -dir <dir>: Set current working directory

  • -settings <file>: Load settings from <file>

  • -mainlog <file>[:<options>]: Write the log to <file> instead of stdout

    If provided, <options> is a comma-separated list of options taken from:

    • append: Append to the log file, rather than overwriting it
  • -pf <props> (or -pctl, -csl): Model check properties <props>

  • -property <refs> (or -prop): Only model check properties included in list <refs> of indices/names

  • -const <vals>: Define constant values as <vals> (e.g. for experiments)

    <vals> is a comma-separated list of values or value ranges for undefined constants in the model or properties (i.e. those declared without values, such as "const int a;"). You can either specify a single value (a=1), a range (a=1:10) or a range with a step (a=1:2:50). For convenience, constant definitions can also be split across multiple -const switches.

    Examples:

    -const a=1,b=5.6,c=true
    -const a=1:10,b=5.6
    -const a=1:2:50,b=5.6
    -const a=1:2:50 -const b=5.6
    
  • -steadystate (or -ss): Compute steady-state probabilities (D/CTMCs only)

  • -transient <x> (or -tr): Compute transient probabilities for time (or time range) <x> (D/CTMCs only)

  • -simpath <options> <file>: Generate a random path with the simulator

    Generate a random path with the simulator and export it to <file> (or to the screen if <file>="stdout"). <options> is a comma-separated list of options taken from:

    • <n>: generate a path of <n> steps
    • time=<x>: generate a path of at least <x> time units
    • deadlock: generate a path until a deadlock is reached
    • repeat=<n>: try <n> paths until a deadlock is found
    • sep=<val>: use <val> as column separator (space, tab, comma)
    • vars=<x1,x2,...>: show values for variables x1,x2,.. only
    • loopcheck=<true|false>: whether to detect deterministic loops
    • snapshot=<x>: view states at fixed timepoints of interval <x>
    • probs=<true|false>: display probability (or rate) of transitions taken
    • rewards=<true|false>: display state/transition rewards
    • changes=<true|false>: only display states where displayed variables change
  • -nobuild: Skip model construction (just do parse/export)

  • -test[:<options>]: Enable "test" mode

    If provided, <options> is a comma-separated list of options taken from:

    • umb: Enable UMB round trip test
    • pexp: Enable explicit (.pexp) round trip test
  • -testall: Enable "test" mode, but don't exit on error

  • -javamaxmem <x>: Set the maximum heap size for Java, e.g. 500m, 4g [default: 1g]

  • -javastack <x>: Set the Java stack size [default: 4m]

  • -javaparams <x>: Pass additional command-line arguments to Java

  • -timeout <n>: Exit after a time-out of <n> seconds if not already terminated

  • -ng: Run PRISM in Nailgun server mode; subsequent calls are then made via "ngprism"

Imports

  • -importpepa: Model description is in PEPA, not the PRISM language

  • -importmodel <files>[:<options>]: Import the model directly from file(s)

    Import the model directly from one or more file(s). Use a list of file extensions to indicate which files should be read, e.g.:

    -importmodel in.tra,sta
    

    Possible extensions are: .tra, .sta, .obs, .lab, .srew, .trew, .pexp, .umb Use extension .all to import all explicit files (.tra/sta/obs/lab/srew/trew), e.g.:

    -importmodel in.all
    

    If provided, <options> is a comma-separated list of options taken from:

    • format (=explicit/umb): model import format
  • -importtrans <file>: Import the transition matrix directly from a text file

  • -importstates <file>: Import the list of states directly from a text file

  • -importobs <file>: Import the list of observations directly from a text file

  • -importlabels <file>: Import the list of labels directly from a text file

  • -importstaterewards <file>: Import the state rewards directly from a text file

  • -importtransrewards <file>: Import the transition rewards directly from a text file

  • -importinitdist <file>: Specify initial probability distribution for transient/steady-state analysis

  • -dtmc: Force imported/built model to be a DTMC

  • -ctmc: Force imported/built model to be a CTMC

  • -mdp: Force imported/built model to be an MDP

  • -importresults <file>: Import results from a data frame stored in CSV file

    Import results from a data frame stored as comma-separated values in <file>.

Exports

  • -exportresults <file[:<options>]>: Export the results of model checking to a file

    Exports the results of model checking to <file> (or to the screen if <file>="stdout"). The default behaviour is to export a list of results in text form, using tabs to separate items. If provided, <options> is a comma-separated list of options taken from:

    • csv: Export results as comma-separated values
    • matrix: Export results as one or more 2D matrices (e.g. for surface plots)
    • dataframe: Export results as dataframe in comma-separated values
    • comment: Export results in comment format for regression testing
  • -exportvector <file>: Export results of model checking for all states to a file

  • -exportmodel <files[:<options>]>: Export the built model to file(s)

    Export the built model to file(s) (or to the screen if <file>="stdout"). Use a list of file extensions to indicate which files should be generated, e.g.:

    -exportmodel out.tra,sta
    -exportmodel out.umb
    

    Possible extensions are: .tra, .srew, .trew, .lab, .sta, .obs, .dot, .umb, .drn Use extension .all to export all explicit files (.tra/srew/trew/lab/sta/obs), e.g.:

    -exportmodel out.all
    

    Omit the file basename to use the basename of the model file, e.g.:

    -exportmodel .all
    

    Use extension .rew to export both .srew/.trew files

    If provided, <options> is a comma-separated list of options taken from:

    • format (=explicit/matlab/dot/drn/umb): model export format
    • rewards (=true/false, or bare for true): whether to include rewards
    • labels (=true/false, or bare for true): whether to include labels
    • states (=true/false, or bare for true): whether to include state definitions
    • obs (=true/false, or bare for true): whether to include observation definitions
    • actions (=true/false, or bare for true): whether to include actions on choices/transitions
    • precision (=<n>): use <n> significant figures for floating point values (in text)
    • zip (=true/false/gzip/xz): whether to zip UMB files
    • text: show binary formats in textual form
    • matlab: same as format=matlab
    • rows: export matrices with one row/distribution on each line
    • proplabels: also export labels from a properties file into the same file, too
    • headers (=true/false, or bare for true): include headers in explicit model files
  • -exporttrans <file>[:<options>]: Export the transition matrix to a file

    If provided, <options> is a comma-separated list of options taken from:

    • precision (=<n>): use <n> significant figures for floating point values (in text)
    • headers (=true/false, or bare for true): include headers in explicit model files
  • -exportstaterewards <file>[:<options>]: Export the state rewards vector to a file

    If provided, <options> is a comma-separated list of options taken from:

    • precision (=<n>): use <n> significant figures for floating point values (in text)
    • headers (=true/false, or bare for true): include headers in explicit model files
  • -exporttransrewards <file>[:<options>]: Export the transition rewards matrix to a file

    If provided, <options> is a comma-separated list of options taken from:

    • precision (=<n>): use <n> significant figures for floating point values (in text)
    • headers (=true/false, or bare for true): include headers in explicit model files
  • -exportrewards <file1[:<options>]> <file2[:<options>]>: Export state/transition rewards to files 1/2

    Export state/transition rewards to files 1/2 (or to the screen if <file>="stdout").

    If provided, <options> is a comma-separated list of options (for either file) taken from:

    • precision (=<n>): use <n> significant figures for floating point values (in text)
    • headers (=true/false, or bare for true): include headers in explicit model files
  • -exportstates <file>[:<options>]: Export the list of reachable states to a file

    If provided, <options> is a comma-separated list of options taken from:

    • precision (=<n>): use <n> significant figures for floating point values (in text)
    • headers (=true/false, or bare for true): include headers in explicit model files
  • -exportobs <file>[:<options>]: Export the list of observations to a file

    If provided, <options> is a comma-separated list of options taken from:

    • precision (=<n>): use <n> significant figures for floating point values (in text)
    • headers (=true/false, or bare for true): include headers in explicit model files
  • -exportlabels <file[:<options>]>: Export the list of labels and satisfying states to a file

    If provided, <options> is a comma-separated list of options taken from:

    • precision (=<n>): use <n> significant figures for floating point values (in text)
    • headers (=true/false, or bare for true): include headers in explicit model files
    • matlab: export data in Matlab format
    • proplabels: export labels from a properties file into the same file, too
  • -exportproplabels <file[:<options>]>: Export the list of labels and satisfying states from the properties file to a file

    If provided, <options> is a comma-separated list of options taken from:

    • precision (=<n>): use <n> significant figures for floating point values (in text)
    • headers (=true/false, or bare for true): include headers in explicit model files
    • matlab: export data in Matlab format
  • -exportstrat <file[:<options>]>: Generate and export a strategy to a file

    Generate and export a strategy to a file (or to the screen if "stdout"). Use file extension .tra, .pexp, .umb or .dot to export as an induced model. The default (e.g. for file extension .txt) is a list of state-action choices.

    If provided, <options> is a comma-separated list of options taken from:

    • type (=actions/indices/induced/dot): type of strategy export
    • mode (=restrict/reduce): mode to use for building induced model (or Dot file)
    • reach (=true/false, or bare for true): whether to restrict the strategy to its reachable states
    • states (=true/false, or bare for true): whether to include full state information
    • mergeobs (=true/false, or bare for true): for partially observable models, whether to merge observationally equivalent states
    • undefined (=stop/loop/first/all/error): how to resolve undefined choices, for all reasons except unknown
    • unknown (=stop/loop/first/all/error): how to resolve undefined choices when there is no information about them
    • arbitrary (=stop/loop/first/all/error): how to resolve undefined choices where any choice is equally good
    • satisfied (=stop/loop/first/all/error): how to resolve undefined choices after the objective is satisfied
    • unsatisfiable (=stop/loop/first/all/error): how to resolve undefined choices when the objective can no longer be satisfied
    • horizon (=stop/loop/first/all/error): how to resolve undefined choices after a step bound
    • unreachable (=stop/loop/first/all/error): how to resolve undefined choices in states not reachable under the strategy
    • showundef (=true/false, or bare for true): whether to also show undefined choices (and why) when exporting actions/indices
    • format (=explicit/dot/drn/umb): model export format for induced model export
    • rewards (=true/false, or bare for true): whether to include rewards for induced model export
    • labels (=true/false, or bare for true): whether to include labels for induced model export
    • actions (=true/false, or bare for true): whether to include actions on choices/transitions for induced model export
    • obs (=true/false, or bare for true): whether to include observation details for induced model export
    • precision (=<n>): use <n> significant figures for floating point values (in text) for induced model export
    • zip (=true/false/gzip/xz): whether to zip files for induced model export
    • text: show binary formats in textual form for induced model export
    • headers (=true/false, or bare for true): include headers in explicit model files for induced model export
  • -exportmatlab: When exporting matrices/vectors/labels/etc., use Matlab format

  • -exportrows: When exporting matrices, put a whole row on one line

  • -exporttransdot <file>: Export the transition matrix graph to a dot file

  • -exporttransdotstates <file>: Export the transition matrix graph to a dot file, with state info

  • -exportdot <file>: Export the transition matrix MTBDD to a dot file

  • -exportsccs <file>: Compute and export all SCCs of the model

  • -exportbsccs <file>: Compute and export all BSCCs of the model

  • -exportmecs <file>: Compute and export all maximal end components (MDPs only)

  • -exportsteadystate <file>: Export steady-state probabilities to a file

  • -exporttransient <file>: Export transient probabilities to a file

  • -exportprism <file>: Export final PRISM model to a file

  • -exportprismconst <file>: Export final PRISM model with expanded constants to a file

Export options

  • -exportmodelprecision <n>: Export probabilities/rewards with n significant decimal places
  • -noexportheaders: Don't include headers when exporting rewards

Engines and methods

  • -mtbdd (or -m): Use the MTBDD engine

  • -sparse (or -s): Use the Sparse engine

  • -hybrid (or -h): Use the Hybrid engine [default]

  • -explicit (or -ex): Use the explicit engine

  • -exact: Perform exact (arbitrary precision) model checking

  • -ptamethod <name>: Specify PTA engine (games, digital, backwards) [default: games]

    Valid options: digital, games, backwards, bw.

  • -transientmethod <name>: CTMC transient analysis method (unif, fau) [default: unif]

    Valid options: unif, fau.

  • -heuristic <mode>: Automatic choice of engines/settings (none, speed, memory) [default: none]

    Valid options: none, speed, memory.

Model construction

  • -fixdl: Automatically put self-loops in deadlock states [default]
  • -nofixdl: Do not automatically put self-loops in deadlock states
  • -noprobchecks: Disable checks on model probabilities/rates
  • -buildall: Build/store all labels and rewards during model construction

Solution methods (linear equations)

  • -power (or -pow, -pwr): Use the Power method for numerical computation
  • -jacobi (or -jac): Use Jacobi for numerical computation [default]
  • -gaussseidel (or -gs): Use Gauss-Seidel for numerical computation
  • -bgaussseidel (or -bgs): Use Backwards Gauss-Seidel for numerical computation
  • -pgaussseidel (or -pgs): Use Pseudo Gauss-Seidel for numerical computation
  • -bpgaussseidel (or -bpgs): Use Backwards Pseudo Gauss-Seidel for numerical computation
  • -jor: Use JOR for numerical computation
  • -sor: Use SOR for numerical computation
  • -bsor: Use Backwards SOR for numerical computation
  • -psor: Use Pseudo SOR for numerical computation
  • -bpsor: Use Backwards Pseudo SOR for numerical computation
  • -omega <x>: Set over-relaxation parameter (for JOR/SOR/...) [default: 0.9]

Solution methods (MDPs)

  • -valiter: Use value iteration for solving MDPs [default]

  • -gaussseidel (or -gs): Use Gauss-Seidel value iteration for solving MDPs

  • -politer: Use policy iteration for solving MDPs

  • -modpoliter: Use modified policy iteration for solving MDPs

  • -intervaliter[:<options>] (or -ii): Use interval iteration to solve MDPs/MCs (see -help -ii)

    Use interval iteration to solve MDPs/MCs.

    If provided, <options> is a comma-separated list of options taken from:

    • boundmethod (=default/variant-1-coarse/variant-1-fine/variant-2/dsmpi): Select upper bound heuristic for reward computations
    • lower (=<d>): Manually specify lower bound for reward computations
    • upper (=<d>): Manually specify upper bound for reward computations
    • [no]boundverbose: Verbose output for upper bound computations (default = no)
    • [no]selectmidpoint: Select midpoint between upper and lower as the result (default = yes)
    • [no]monotonicbelow: Enforce monotonicity in iteration from below (default = yes)
    • [no]monotonicabove: Enforce monotonicity in iteration from above (default = yes)
    • [no]checkmonotonic: Check monotonicity, for testing (default = no)

    Example: boundmethod=default,upper=3.0,noselectmidpoint,checkmonotonic

  • -topological: Use topological value iteration

Solution method settings

  • -relative (or -rel): Use relative error for detecting convergence [default]
  • -absolute (or -abs): Use absolute error for detecting convergence
  • -epsilon <x> (or -e): Set value of epsilon (for convergence check) [default: 1e-6]
  • -maxiters <n>: Set max number of iterations [default: 10000]
  • -gridresolution <n>: Set resolution for fixed grid approximation (POMDP) [default: 10]

Model checking

  • -nopre: Skip precomputation algorithms (where optional)

  • -noprob0: Skip precomputation algorithm Prob0 (where optional)

  • -noprob1: Skip precomputation algorithm Prob1 (where optional)

  • -noprerel: Do not pre-compute/use predecessor relation, e.g. for precomputation

  • -fair: Use fairness (for model checking of MDPs)

  • -nofair: Don't use fairness (for model checking of MDPs) [default]

  • -sumroundoff <x>: Set probability sum threshold [default: 1-e5]

  • -nossdetect: Disable steady-state detection for CTMC transient computations

  • -sccmethod <name>: Specify (symbolic) SCC computation method (xiebeerel, lockstep, sccfind)

    Valid options: xiebeerel, lockstep, sccfind.

  • -symm <string>: Symmetry reduction options string

  • -aroptions <string>: Abstraction-refinement engine options string

    <string> is a comma-separated list of options regarding abstraction-refinement:

    • verbose=<n> (or v=<n>) - verbosity level
    • refine=<where,how>: which states to refine and how
        <where> = all, allmax, first, firstmax, last, lastmax
        <how> = all, val
    
    • epsilonref=<x> (or eref=<x>) - epsilon for refinement
    • nopre - disable precomputation
    • pre: use precomputation
    • noprob0: disable prob0 precomputation
    • noprob1: disable prob1 precomputation
    • epsilon=<x>: epsilon for numerical convergence
    • maxref=<n>: maximum number of refinements
    • opt: use optimisations
    • noopt: disable optimisations
    • exportdot: export dot files for each refinement
    • above: start numerical soluton from above
    • below: start numerical soluton from below
  • -pathviaautomata: Handle all path formulas via automata constructions

  • -nodasimplify: Do not attempt to simplify deterministic automata, acceptance conditions

  • -exportadv <file>: Export an adversary from MDP model checking (as a DTMC)

  • -exportadvmdp <file>: Export an adversary from MDP model checking (as an MDP)

  • -ltl2datool <exec>: Run executable <exec> to convert LTL formulas to deterministic automata

  • -ltl2dasyntax <x>: Specify output format for -ltl2datool switch (lbt, spin, spot, rabinizer)

    Valid options: lbt, spin, spot, rabinizer.

  • -exportiterations: Export vectors for iteration algorithms to file

  • -pmaxquotient: For Pmax computations in MDPs, compute in the MEC quotient

Multi-objective model checking

  • -linprog (or -lp): Use linear programming for MDP solution (explicit engine) and multi-objective model checking
  • -multimaxpoints <n>: Maximal number of corner points for (valiter-based) multi-objective
  • -paretoepsilon <x>: Threshold for Pareto curve approximation
  • -exportpareto <file>: When computing Pareto curves, export points to a file

Output

  • -verbose (or -v): Verbose mode: print out state lists and probability vectors
  • -extraddinfo: Display extra info about some (MT)BDDs
  • -extrareachinfo: Display extra info about progress of reachability

Sparse, hybrid and MTBDD engines

  • -nocompact: Switch off "compact" sparse storage schemes
  • -sbl <n>: Set number of levels (for hybrid engine) [default: -1]
  • -sbmax <n>: Set memory limit (KB) (for hybrid engine) [default: 1024]
  • -gsl <n> (or -sorl): Set number of levels for hybrid GS/SOR [default: -1]
  • -gsmax <n> (or -sormax): Set memory limit (KB) for hybrid GS/SOR [default: 1024]
  • -cuddmaxmem <n>: Set max memory for CUDD package, e.g. 125k, 50m, 4g [default: 1g]
  • -cuddepsilon <x>: Set epsilon value for CUDD package [default: 1e-15]
  • -ddsanity: Enable internal sanity checks (causes slow-down)
  • -ddextrastatevars <n>: Set the number of preallocated state vars [default: 20]
  • -ddextraactionvars <n>: Set the number of preallocated action vars [default: 20]

Parametric model checking

  • -param <vals>: Do parametric model checking with parameters (and ranges) <vals>

  • -paramprecision <x>: Set max undecided region for parameter synthesis [default: 5/100]

  • -paramsplit <name>: Set method to split parameter regions (longest,all) [default: longest]

    Valid options: longest, all.

  • -parambisim <name>: Set bisimulation minimisation for parameter synthesis (weak,strong,none) [default: weak]

    Valid options: strong, weak, none.

  • -paramfunction <name>: Set function representation for parameter synthesis (jascached,jas) [default: jascached]

    Valid options: jascached, jas, dag.

  • -paramelimorder <name>: Set elimination order for parameter synthesis (arb,fw,fwrev,bw,bwrev,rand) [default: bw]

    Valid options: arb, fw, fwrev, bw, bwrev, rand.

  • -paramrandompoints <n>: Set number of random points to evaluate per region [default: 5]

  • -paramsubsumeregions <b>: Subsume adjacent regions during analysis [default: true]

  • -paramdagmaxerror <b>: Maximal error probability allowed for DAG function representation [default: 1E-100]

Fast adaptive uniformisation (FAU)

  • -fauepsilon <x>: Set probability threshold of birth process in FAU [default: 1e-6]
  • -faudelta <x>: Set probability threshold for irrelevant states in FAU [default: 1e-12]
  • -fauarraythreshold <x>: Set threshold when to switch to sparse matrix in FAU [default: 100]
  • -fauintervals <x>: Set number of intervals to divide time intervals into for FAU [default: 1]
  • -fauinitival <x>: Set length of additional initial time interval for FAU [default: 1.0]

Simulation

  • -sim: Use the PRISM simulator to approximate results of model checking

  • -simmethod <name>: Specify the method for approximate model checking (ci, aci, apmc, sprt)

    Valid options: ci, aci, apmc, sprt.

  • -simsamples <n>: Set the number of samples for the simulator (CI/ACI/APMC methods)

  • -simconf <x>: Set the confidence parameter for the simulator (CI/ACI/APMC methods)

  • -simwidth <x>: Set the interval width for the simulator (CI/ACI methods)

  • -simapprox <x>: Set the approximation parameter for the simulator (APMC method)

  • -simmanual: Do not use the automated way of deciding whether the variance is null or not

  • -simvar <n>: Set the minimum number of samples to know the variance is null or not

  • -simmaxrwd <x>: Set the maximum reward -- useful to display the CI/ACI methods progress

  • -simpathlen <n>: Set the maximum path length for the simulator