lpsinvelm
Given an LPS:
a formula of the form
is generated for each of the summands, where \(inv()\) is the expression passed using the option –invariant. This expression is an invariant of the LPS if it holds in the initial state and all the generated formulas are tautologies.
The invariant is used to eliminate summands as follows. A formula of the form
is generated for each of the summands or for the summand indicated using the
option –summand only. The tool uses a BDD based prover for expressions
of sort Bool
to see if the generated formula is a contradiction. If the
formula is a contradiction for some summand, this summand will be eliminated
from the LPS. If the formula is not a contradiction, the summand remains
unchanged unless the option –simplify-all is used.
The option –simplify-all will replace the conditions of all summands by the equivalent BDD of the condition in conjunction with the invariant passed using the option –invariant. This may enable other tools, like lpsconstelm and lpsparelm, to simplify the LPS even further.
In some cases it may be useful to use an SMT solver to assist the prover. The SMT solver can further reduce BDDs by removing inconsistent paths. A specific SMT solver can be chosen using the option –smt-solver=SOLVER`. Either the SMT solver Ario or CVC3 can be used. To use one of these solvers, the directory containing the corresponding executable must be in the path.
Without using the option –no-check, lpsinvelm will first check if the given expression is an invariant of the LPS. If this is not the case, no elimination or simplification will be done. In some cases the invariant may hold even though the prover is unable to determine this fact. In cases where an expression is an invariant of the LPS, but the prover is unable to determine this, the option –no-check can be used to eliminate or simplify summands anyway. Note that this also makes it possible to eliminate or simplify summands using an expression that is not an invariant of the LPS.
The option –verbose gives insight into what the prover is doing and can be used to see if rewrite rules have to be added to the specification, in order to enable the prover to determine the invariance of an expression.
Example of use
Consider a linear process specification
act a:Nat; b,c;
act a, b, c;
proc X(b1,b2:Bool) = b1 -> a.X(!b1,b2)
+ b2 ->b.X(true,b2 && b1)
+ (b1 && b2)->c.X(false,false);
init X(false,true);
If the lineariser is applied to this process using:
$ mcrl22lps -D infile.mcrl2 outfile.lps
the resulting LPS looks like
act c,b,a;
proc P(b1_X,b2_X: Bool) =
b1_X ->
a .
P(b1_X = !b1_X)
+ b2_X ->
b .
P(b1_X = true, b2_X = b2_X && b1_X)
+ (b1_X && b2_X) ->
c .
P(b1_X = false, b2_X = false)
+ delta;
init P(false, true);
Inspection of this linear process shows that b1_X
and b2_X
cannot both be true at the same time. So, we can define this in a file
invariant.inv
. This linear process specification has as an invariant
that
!(b1_X && b2_X)
See below for a detailed definition of an invariant.
Using:
$ lpsinvelm -v -iinvariant.inv outfile.lps outfile1.lps
it is possible to check the invariant. Moreover, by default the summand with
conditions that in conjunction with the invariant are false
are
removed. In the example above, the summand with action c
is removed.
Using the -l flag, the invariant is put into conjunction with the condition of
each summand, and the resulting condition is simplified using the eq-BDD prover.
So, applying:
$ lpsinvelm -v -l -iinvariant.inv outfile.lps outfile1.lps
yields the following:
act c,b,a;
proc P(b1_X,b2_X: Bool) =
if(b1_X, if(b2_X, false, true), false) ->
a .
P(b1_X = !b1_X)
+ if(b1_X, false, if(b2_X, true, false)) ->
b .
P(b1_X = true, b2_X = b2_X && b1_X)
+ if(b1_X, if(b2_X, false, true), true) ->
delta;
init P(false, true);
Note that the conditions now have an if-then-else structure, due to the eq-BDD
prover. Also note that the summand with action c
has been removed.
Sometimes, this result is unreadable or the simplifications of the conditions in conjunction with the invariant is extremely time consuming. This is for instance the case if many non-boolean data types are used. In such a case the application of the tool lpsbinary can be helpful, by replacing finite data domains by boolean data domains. Using the -e flag it is possible to add the invariants to the summands, without simplifying the summands. So, by applying:
$ lpsinvelm -v -e -iinvariant.inv outfile.lps outfile1.lps
the result becomes
act c,b,a;
proc P(b1_X,b2_X: Bool) =
(!(b1_X && b2_X) && b1_X) ->
a .
P(b1_X = !b1_X)
+ (!(b1_X && b2_X) && b2_X) ->
b .
P(b1_X = true, b2_X = b2_X && b1_X)
+ (!(b1_X && b2_X) && b1_X && b2_X) ->
c .
P(b1_X = false, b2_X = false)
+ !(b1_X && b2_X) ->
delta;
init P(false, true);
Note that the c
summand is now still present.
The usage of lpsinvelm can be useful as a preprocessing step for symbolic reduction tools such as lpsconfcheck and lpsrealelm.
When an invariant is being checked, but turns out to be false, then counterexamples are very helpful (use the -c flag. Counterexamples can also be presented in dot format.
When the data types that are used in a process are complex, the prover is not able to prove that the invariant is actually an invariant. This for instance happens when inequalities are used. In such a case, the flag -n can be used to skip the check that the invariant indeed satisfies the invariant properties.
- orphan:
Usage
lpsinvelm [OPTION]... --invfile=INVFILE [INFILE [OUTFILE]]
Description
Checks whether the boolean formula (an mCRL2 data expression of sort Bool) provided as invariant is an invariant of the linear process specification (LPS) in INFILE. If this is the case, the tool eliminates all summands of the LPS whose condition violates the invariant, and writes the result to OUTFILE. If INFILE is present, stdin is used. If OUTFILE is not present, stdout is used.
The tool can also be used to simplify the conditions of the summands of the given LPS.
Command line options
-y
, --all-violations
do not terminate as soon as a single violation of the invariant is found, but report all violations instead
-c
, --counter-example
display a valuation indicating why the invariant could possibly be violated if it is uncertain whether a summand violates the invariant
-o
, --induction
apply induction on lists
-iINVFILE
, --invariant=INVFILE
use the boolean formula (an mCRL2 data expression of sort Bool) in INVFILE as invariant
-n
, --no-check
do not check if the invariant holds before applying the invariant
-e
, --no-elimination
do not eliminate or simplify summands, but add the invariant to each condition. This implies setting the flag –simplify-all.
-pPREFIX
, --print-dot=PREFIX
save a .dot file of the resulting BDD if it is impossible to determine whether a summand violates the invariant; PREFIX will be used as prefix of the output files
-QNUM
, --qlimit=NUM
limit enumeration of universal and existential quantifiers in data expressions to NUM iterations (default NUM=10, NUM=0 for unlimited).
-rNAME
, --rewriter=NAME
use rewrite strategy NAME:
jitty
jitty rewriting
jittyc
compiled jitty rewriting
-l
, --simplify-all
simplify the conditions of all summands, instead of just eliminating the summands whose conditions in conjunction with the invariant are contradictions
-zSOLVER
, --smt-solver=SOLVER
use SOLVER to remove inconsistent paths from the internally used BDDs (by default, no path elimination is applied):
cvc
the SMT solver CVC3
z3
the SMT solver Z3
-tLIMIT
, --time-limit=LIMIT
spend at most LIMIT seconds on proving a single formula
--timings[=FILE]
append timing measurements to FILE. Measurements are written to standard error if no FILE is provided
Standard options
-q
, --quiet
do not display warning messages
-v
, --verbose
display short log messages
-d
, --debug
display detailed log messages
--log-level=LEVEL
display log messages up to and including level; either warn, verbose, debug or trace
-h
, --help
display help information
--version
display version information
--help-all
display help information, including hidden and experimental options