No edit summary |
|||
(21 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
[[Category:User Manual]] | [[Category:User Manual]] | ||
[[Category: Advanced Feature]] | [[Category: Advanced Feature]] | ||
= Symbolic Functions and Relations = | |||
Take the following function: | Take the following function: | ||
CONSTANTS parity | CONSTANTS parity | ||
Line 9: | Line 10: | ||
Here, ProB will complain that it cannot find a solution for parity. | Here, ProB will complain that it cannot find a solution for parity. | ||
The reason is that parity is a function over an infinite domain, but ProB | The reason is that parity is a function over an infinite domain, but ProB | ||
tries to represent the function as a finite set of maplets. | |||
There are basically | There are basically four solutions to this problem: | ||
* Write a finite function: | * Write a finite function: | ||
Line 26: | Line 27: | ||
Note, you have to remove the check <tt>parity : (NATURAL --> {0,1})</tt>, as this will currently cause expansion of the recursive function. We describe this new scheme in more detail below. | Note, you have to remove the check <tt>parity : (NATURAL --> {0,1})</tt>, as this will currently cause expansion of the recursive function. We describe this new scheme in more detail below. | ||
* Another solution is try and write your function constructively and non-recursively, ideally using a lambda abstraction: | * Another solution is try and write your function constructively and non-recursively, ideally using a lambda abstraction: | ||
parity : (NATURAL --> | parity : (NATURAL --> INTEGER) & | ||
parity = %x.(x:NATURAL|x mod 2) | parity = %x.(x:NATURAL|x mod 2) | ||
* Here ProB detects that parity is an infinite function and will keep it symbolic (if possible). With such an infinite function you can: | * Here ProB detects that parity is an infinite function and will keep it symbolic (if possible). With such an infinite function you can: | ||
** apply the function, e.g., <tt>parity(10001)</tt> is the value <tt>1</tt> | ** apply the function, e.g., <tt>parity(10001)</tt> is the value <tt>1</tt> | ||
** compute the image of the function, e.g., <tt>parity[10..20]</tt> is <tt>{0,1}</tt> | ** compute the image of the function, e.g., <tt>parity[10..20]</tt> is <tt>{0,1}</tt> | ||
** check if a tuple is a member of the function, e.g., <tt>20|->0 : parity</tt> | |||
** check if a tuple is not a member of the function, e.g., <tt>21|->0 /: parity</tt> | |||
** check if a finite set of tuples is a subset of the function, e.g., <tt>{20|->0, 120|->0, 121|->1, 1001|->1} <: parity</tt> | |||
** check if a finite set of tuples is not a subset of the function, e.g., <tt>{20|->0, 120|->0, 121|->1, 1001|->2} /<: parity</tt> | |||
** compose the function with a finite relation, e.g., <tt>(id(1..10) ; parity)</tt> gives the value <tt>[1,0,1,0,1,0,1,0,1,0]</tt> | ** compose the function with a finite relation, e.g., <tt>(id(1..10) ; parity)</tt> gives the value <tt>[1,0,1,0,1,0,1,0,1,0]</tt> | ||
** sometimes compute the domain of the function, here, <tt>dom(parity)</tt> is determined to be <tt>NATURAL</tt>. But this only works for simple infinite functions | ** sometimes compute the domain of the function, here, <tt>dom(parity)</tt> is determined to be <tt>NATURAL</tt>. But this only works for simple infinite functions. | ||
** sometimes check that you have a total function, e.g., <tt>parity: NATURAL --> INTEGER</tt> can be checked by ProB. However, if you change the range (say from <tt>INTEGER</tt> to <tt>0..1</tt>), then ProB will try to expand the function. | ** sometimes check that you have a total function, e.g., <tt>parity: NATURAL --> INTEGER</tt> can be checked by ProB. However, if you change the range (say from <tt>INTEGER</tt> to <tt>0..1</tt>), then ProB will try to expand the function. | ||
** In version 1.3.7 we are adding more and more operators that can be treated symbolically. Thus you can now also compose two symbolic functions using relational composition <tt>;</tt> or take the transitive closure (<tt>closure1</tt>) symbolically. | |||
You can experiment with those by using the [[Eval Console|Eval console]] of ProB, experimenting for example with the following complete machine. Note, you should use ProB 1.3.5-beta2 or higher. | You can experiment with those by using the [[Eval Console|Eval console]] of ProB, experimenting for example with the following complete machine. Note, you should use ProB 1.3.5-beta2 or higher. | ||
(You can also type expressions and predicates such as <tt>parity = %x.(x:NATURAL|x mod 2) & parity[1..10] = res</tt> directly into the online version of the [[Eval Console|Eval console]]). | |||
MACHINE InfiniteParityFunction | MACHINE InfiniteParityFunction | ||
Line 55: | Line 63: | ||
You may also want to look at the tutorial page on [[Tutorial_Modeling_Infinite_Datatypes|modeling infinite datatypes]]. | You may also want to look at the tutorial page on [[Tutorial_Modeling_Infinite_Datatypes|modeling infinite datatypes]]. | ||
= Recursive | == When does ProB treat a set comprehension or lambda abstraction symbolically ? == | ||
Currently there are four cases when ProB tries to keep a function such as <tt>f = %x.(PRED|E)</tt> symbolically rather than computing an explicit representation: | |||
* the domain of the function is obviously infinite; this is the case for predicates such as <tt>x:NATURAL</tt>; in version 1.3.7-beta5 or later this has been considerably improved. Now ProB also keeps those lambda abstractions or set comprehensions symbolic where the constraint solver cannot reduce the domain of the parameters to a finite domain. As such, e.g., <tt>{x,y,z| x*x + y*y = z*z}</tt> or <tt>{x,y,z| z:seq(NATURAL) & x^y=z}</tt> are now automatically kept symbolic. | |||
* <tt>f</tt> is declared to be an <tt>ABSTRACT_CONSTANT</tt> and the equation is part of the <tt>PROPERTIES</tt> with <tt>f</tt> on the left. | |||
* the preference <tt>SYMBOLIC</tt> is set to true (e.g., using a <tt>DEFINITION</tt> <tt>SET_PREF_SYMBOLIC == TRUE</tt>) | |||
* a pragma is used to mark the lambda abstraction as symbolic as follows: <tt>f = /*@ symbolic */ %x.(PRED|E)</tt>; this requires ProB version 1.3.5-beta10 or higher. In Event-B, pragmas are represented as Rodin database attributes and one should use the [[Tutorial_Symbolic_Constants|symbolic constants plugin]]. | |||
= Recursive Function Definitions in ProB = | |||
As of version 1.3.5-beta7 ProB now accepts recursively defined functions. | As of version 1.3.5-beta7 ProB now accepts recursively defined functions. | ||
For this: | For this: | ||
* the function has to be declared an <tt>ABSTRACT_CONSTANT</tt>. | * the function has to be declared an <tt>ABSTRACT_CONSTANT</tt>. | ||
* the function has to be defined using a <em>single</em> recursive equation with the name of the function | * the function has to be defined using a <em>single</em> recursive equation with the name of the function on the left of the equation | ||
* the right-hand side of the equation can make use of lambda abstractions, set comprehensions, set union and other finite sets | * the right-hand side of the equation can make use of lambda abstractions, set comprehensions, set union and other finite sets | ||
Here is a full example: | Here is a full example: | ||
Line 70: | Line 85: | ||
END | END | ||
There are the following restrictions: | As of version 1.6.1 you can also use IF-THEN-ELSE and LET constructs in the body of a recursive function. The above example can for example now be written as: | ||
MACHINE ParityIFTE | |||
ABSTRACT_CONSTANTS parity | |||
PROPERTIES | |||
parity : INTEGER <-> INTEGER & | |||
parity = %x.(x:NATURAL|IF x=0 THEN 0 ELSE 1-parity(x-1)END) | |||
END | |||
== Operations applicable for recursive functions == | |||
With such a recursive function you can: | |||
* apply the function to a given argument, e.g., <tt>parity(100)</tt> will give you 0; | |||
* compute the image of the function, e.g., <tt>parity[1..10]</tt> gives <tt>{0,1}</tt>. | |||
* composing it with another function, notably finite sequences: <tt>([1,2] ; parity)</tt> corresponds to the "map" construct of functional programming and results in the output <tt>[1,0]</tt>. | |||
Also, you have to be careful to avoid accidentally expanding these functions. For example, trying to check <tt>parity : INTEGER <-> INTEGER</tt> or <tt>parity : INTEGER +-> INTEGER</tt> will cause older version of ProB to try and expand the function. ProB 1.6.1 can actually check <tt>parity:NATURAL --> INTEGER</tt>, but it cannot check <tt>parity:NATURAL --> 0..1</tt>. | |||
There are the following further restrictions: | |||
* ProB does not support mutual recursion yet | |||
* the function is not allowed to depend on other constants, unless those other constants can be valued in a deterministic way (i.e., ProB finds only one possible solution for them) |
Take the following function:
CONSTANTS parity PROPERTIES parity : (NATURAL --> {0,1}) & parity(0) = 0 & !x.(x:NATURAL => parity(x+1) = 1 - parity(x))
Here, ProB will complain that it cannot find a solution for parity. The reason is that parity is a function over an infinite domain, but ProB tries to represent the function as a finite set of maplets.
There are basically four solutions to this problem:
parity : (NAT --> {0,1}) & parity(0) = 0 & !x.(x:NAT & x<MAXINT => parity(x+1) = 1 - parity(x))
parity : (NATURAL --> {0,1}) & parity(0) = 0 & !x.(x:NATURAL1 => parity(x) = 1 - parity(x-1))
parity : INTEGER <-> INTEGER & parity = {0|->0} \/ %x.(x:NATURAL1|1-parity(x-1))
Note, you have to remove the check parity : (NATURAL --> {0,1}), as this will currently cause expansion of the recursive function. We describe this new scheme in more detail below.
parity : (NATURAL --> INTEGER) & parity = %x.(x:NATURAL|x mod 2)
You can experiment with those by using the Eval console of ProB, experimenting for example with the following complete machine. Note, you should use ProB 1.3.5-beta2 or higher.
(You can also type expressions and predicates such as parity = %x.(x:NATURAL|x mod 2) & parity[1..10] = res directly into the online version of the Eval console).
MACHINE InfiniteParityFunction CONSTANTS parity PROPERTIES parity : NATURAL --> INTEGER & parity = %x.(x:NATURAL|x mod 2) VARIABLES c INVARIANT c: NATURAL INITIALISATION c:=0 OPERATIONS Inc = BEGIN c:=c+1 END; r <-- Parity = BEGIN r:= parity(c) END; r <-- ParityImage = BEGIN r:= parity[0..c] END; r <-- ParityHistory = BEGIN r:= (%i.(i:1..c+1|i-1) ; parity) END END
You may also want to look at the tutorial page on modeling infinite datatypes.
Currently there are four cases when ProB tries to keep a function such as f = %x.(PRED|E) symbolically rather than computing an explicit representation:
As of version 1.3.5-beta7 ProB now accepts recursively defined functions. For this:
Here is a full example:
MACHINE Parity ABSTRACT_CONSTANTS parity PROPERTIES parity : INTEGER <-> INTEGER & parity = {0|->0} \/ %x.(x:NATURAL1|1-parity(x-1)) END
As of version 1.6.1 you can also use IF-THEN-ELSE and LET constructs in the body of a recursive function. The above example can for example now be written as:
MACHINE ParityIFTE ABSTRACT_CONSTANTS parity PROPERTIES parity : INTEGER <-> INTEGER & parity = %x.(x:NATURAL|IF x=0 THEN 0 ELSE 1-parity(x-1)END) END
With such a recursive function you can:
Also, you have to be careful to avoid accidentally expanding these functions. For example, trying to check parity : INTEGER <-> INTEGER or parity : INTEGER +-> INTEGER will cause older version of ProB to try and expand the function. ProB 1.6.1 can actually check parity:NATURAL --> INTEGER, but it cannot check parity:NATURAL --> 0..1.
There are the following further restrictions: