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
-
-mainlog <file>[:<options>]: Write the log to <file> instead of stdoutIf 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 simulatorGenerate 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> stepstime=<x>: generate a path of at least <x> time unitsdeadlock: generate a path until a deadlock is reachedrepeat=<n>: try <n> paths until a deadlock is foundsep=<val>: use <val> as column separator (space, tab, comma)vars=<x1,x2,...>: show values for variables x1,x2,.. onlyloopcheck=<true|false>: whether to detect deterministic loopssnapshot=<x>: view states at fixed timepoints of interval <x>probs=<true|false>: display probability (or rate) of transitions takenrewards=<true|false>: display state/transition rewardschanges=<true|false>: only display states where displayed variables change
-
-test[:<options>]: Enable "test" modeIf provided, <options> is a comma-separated list of options taken from:
umb: Enable UMB round trip testpexp: Enable explicit (.pexp) round trip test
-
-javamaxmem <x>: Set the maximum heap size for Java, e.g. 500m, 4g [default: 1g] -
-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,staPossible 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.allIf 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 -
-importresults <file>: Import results from a data frame stored in CSV fileImport results from a data frame stored as comma-separated values in <file>.
Exports
-
-exportresults <file[:<options>]>: Export the results of model checking to a fileExports 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 valuesmatrix: Export results as one or more 2D matrices (e.g. for surface plots)dataframe: Export results as dataframe in comma-separated valuescomment: 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.umbPossible 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.allOmit the file basename to use the basename of the model file, e.g.:
-exportmodel .allUse 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 formatrewards(=true/false, or bare for true): whether to include rewardslabels(=true/false, or bare for true): whether to include labelsstates(=true/false, or bare for true): whether to include state definitionsobs(=true/false, or bare for true): whether to include observation definitionsactions(=true/false, or bare for true): whether to include actions on choices/transitionsprecision(=<n>): use <n> significant figures for floating point values (in text)zip(=true/false/gzip/xz): whether to zip UMB filestext: show binary formats in textual formmatlab: same as format=matlabrows: export matrices with one row/distribution on each lineproplabels: also export labels from a properties file into the same file, tooheaders(=true/false, or bare for true): include headers in explicit model files
-
-exporttrans <file>[:<options>]: Export the transition matrix to a fileIf 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 fileIf 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 fileIf 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/2Export 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 fileIf 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 fileIf 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 fileIf 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 filesmatlab: export data in Matlab formatproplabels: 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 fileIf 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 filesmatlab: export data in Matlab format
-
-exportstrat <file[:<options>]>: Generate and export a strategy to a fileGenerate 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 exportmode(=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 statesstates(=true/false, or bare for true): whether to include full state informationmergeobs(=true/false, or bare for true): for partially observable models, whether to merge observationally equivalent statesundefined(=stop/loop/first/all/error): how to resolve undefined choices, for all reasons except unknownunknown(=stop/loop/first/all/error): how to resolve undefined choices when there is no information about themarbitrary(=stop/loop/first/all/error): how to resolve undefined choices where any choice is equally goodsatisfied(=stop/loop/first/all/error): how to resolve undefined choices after the objective is satisfiedunsatisfiable(=stop/loop/first/all/error): how to resolve undefined choices when the objective can no longer be satisfiedhorizon(=stop/loop/first/all/error): how to resolve undefined choices after a step boundunreachable(=stop/loop/first/all/error): how to resolve undefined choices in states not reachable under the strategyshowundef(=true/false, or bare for true): whether to also show undefined choices (and why) when exporting actions/indicesformat(=explicit/dot/drn/umb): model export format for induced model exportrewards(=true/false, or bare for true): whether to include rewards for induced model exportlabels(=true/false, or bare for true): whether to include labels for induced model exportactions(=true/false, or bare for true): whether to include actions on choices/transitions for induced model exportobs(=true/false, or bare for true): whether to include observation details for induced model exportprecision(=<n>): use <n> significant figures for floating point values (in text) for induced model exportzip(=true/false/gzip/xz): whether to zip files for induced model exporttext: show binary formats in textual form for induced model exportheaders(=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 -
-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
-
-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)
-
-gaussseidel(or-gs): Use Gauss-Seidel value 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 computationslower(=<d>): Manually specify lower bound for reward computationsupper(=<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
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
-
-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 -
-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.
-
-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 precomputationnoprob0: disable prob0 precomputationnoprob1: disable prob1 precomputationepsilon=<x>: epsilon for numerical convergencemaxref=<n>: maximum number of refinementsopt: use optimisationsnoopt: disable optimisationsexportdot: export dot files for each refinementabove: start numerical soluton from abovebelow: 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