Difference between revisions of "Accessing Proof Obligations"

From Event-B
Jump to navigationJump to search
imported>Mathieu
m (cat)
imported>Mathieu
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
{{TOCright}}
 +
 
==File Types==
 
==File Types==
For each machine and each context there exists one of each of the following files:
+
For each machine and each context there exists one of each of the following roots:
  
*IPSFile (.bps): This file contains the statuses (IPSStatus) of the proof obligations.
+
*IPSRoot: This root contains the statuses (IPSStatus) of the proof obligations. It is contained in a file with the extension .bps.
  
*IPOFile (.bpo): This file contains the sequents (IPOSequent) of the proof obligations.
+
*IPORoot: This root contains the sequents (IPOSequent) of the proof obligations. It is contained in a file with the extension .bpo.
  
==The Connection==
+
==The Connection between different root types==
An IPSFile, an IPOFile and an IMachineFile or IContextFile are connected through the name. For example machine ''m0'' has IMachineFile ''m0.bum'', IPSFile ''m0.bps'' and IPOFile ''m0.bpo''. The name of each of these files is accessible via <code>file.getBarName()</code>.
+
An IPSRoot, an IPORootand an IMachineRoot or IContextRoot are connected through the name. For example machine ''m0'' has IMachineRoot that is in file ''m0.bum'', IPSRoot in ''m0.bps'' and IPORoot in ''m0.bpo''. If one has any of these roots, one get the others though the functions <code>getMachineRoot()</code>, <code>getContextRoot()</code>, <code>getPSRoot()</code> and <code>getPORoot()</code>.
If one has any of these files, one get the others though the functions <code>getMachineFile()</code>, <code>getContextFile()</code>, <code>getPSFile()</code> and <code>getPOFile()</code>.
 
  
==Accessing the sequents of an IPOFile==
+
==Accessing the sequents of an IPORoot==
*All sequents of ''file'': <code>IPOSequent[] sequents =  file.getSequents()</code>
+
*All sequents of ''root'': <code>IPOSequent[] sequents =  root.getSequents()</code>
*A specific sequent (e.g. INITIALISATION/inv1/INV) of ''file'': <code>IPOSequent sequent =  file.getSequent("INITIALISATION/inv1/INV")</code>
+
*A specific sequent (e.g. INITIALISATION/inv1/INV) of ''root'': <code>IPOSequent sequent =  root.getSequent("INITIALISATION/inv1/INV")</code>
  
==Accessing the statuses of an IPSFile ==
+
==Accessing the statuses of an IPSRoot ==
*All statuses of ''file'': <code>IPSStatus[] statuses =  file.getStatuses()</code>
+
*All statuses of ''root'': <code>IPSStatus[] statuses =  root.getStatuses()</code>
*A specific status (e.g. INITIALISATION/inv1/INV) of ''file'': <code>IPSStatus status =  file.getStatus("INITIALISATION/inv1/INV")</code>
+
*A specific status (e.g. INITIALISATION/inv1/INV) of ''root'': <code>IPSStatus status =  root.getStatus("INITIALISATION/inv1/INV")</code>
  
 
==Finding the corresponding status to a given sequent==
 
==Finding the corresponding status to a given sequent==
*1. Find the IPOFile that contains ''sequent'': <code>IPOFile poFile = sequent.getAncestor(IPOFile.ELEMENT_TYPE);</code>
+
*1. Find the IPORoot that contains ''sequent'': <code>IPORoot poRoot = sequent.getParent;</code>
*2. Find the matching IPSFile: <code>IPSFile isFile = poFile.getPSFile();</code>
+
*2. Find the matching IPSRoot: <code>IPSRoot psRoot = poRoot.getPSRoot();</code>
*3. Find the machting status: <code>IPSStatus status =  psFile.getStatus(sequent.getElementName);</code>
+
*3. Find the machting status: <code>IPSStatus status =  psRoot.getStatus(sequent.getElementName);</code>
  
 
==Finding the corresponding sequent to a given status==
 
==Finding the corresponding sequent to a given status==
Use the function <code>getPOSequent()</code> in IPSStatus
+
Use the function <code>getPOSequent()</code> in IPSStatus.
 
 
==Accessing all proof obligations of a project==
 
*All IPOFiles of ''project'': <code>IPOFile[] pofiles = project.getChildrenOfType(IPOFile.ELEMENT_TYPE);</code>
 
 
 
*All IPSFiles of ''project'': <code>IPSFile[] psfiles =  project.getChildrenOfType(IPSFile.ELEMENT_TYPE);</code>
 
  
 
==Accessing the proof obligations of a given machine or context==
 
==Accessing the proof obligations of a given machine or context==
*1. Find the machting IPOFile for ''machine'' (IMachineFile): <code>IPOFile poFile = machine.getPOFile();</code>
+
*1. Find the machting IPORoot for ''machine'' (IMachineRoot): <code>IPORoot poRoot = machine.getPORoot();</code>
*2. Get all sequents: [[Accessing_Proof_Obligations#Accessing_the_sequents_of_an_IPOFile | Accessing the sequents of an IPOFile]]
+
*2. Get all sequents: [[Accessing_Proof_Obligations#Accessing_the_sequents_of_an_IPORoot | Accessing the sequents of an IPORoot]]
 
*1. Find the machting IPSFile for ''machine'': <code>IPSFile psFile = machine.getPSFile();</code>
 
*1. Find the machting IPSFile for ''machine'': <code>IPSFile psFile = machine.getPSFile();</code>
*3. For each sequent access the status with the same name in the IPSFile: [[Accessing_Proof_Obligations#Accessing_the_statuses_of_an_IPSFile | Accessing the statuses of an IPSFile]]
+
*3. For each sequent access the status with the same name in the IPSRoot: [[Accessing_Proof_Obligations#Accessing_the_statuses_of_an_IPSRoot | Accessing the statuses of an IPSRoot]]
  
 
==The sources of a proof obligations==
 
==The sources of a proof obligations==
Line 41: Line 37:
 
They can be accessed from the IPOSequent: <code>IPOSource[] sources = sequents[i].getSources();</code>
 
They can be accessed from the IPOSequent: <code>IPOSource[] sources = sequents[i].getSources();</code>
  
An IPOSource can be an instance of IInvariant, ITheorem etc.
+
An IPOSource can be an instance of an element like IInvariant, ITheorem etc or it can be an IAction, IWitness or IGuard.
  
 
==Finding all the proof obligations for a given Invariant==
 
==Finding all the proof obligations for a given Invariant==
Line 49: Line 45:
 
[[Category:Developer documentation]]
 
[[Category:Developer documentation]]
 
[[Category:Rodin Platform]]
 
[[Category:Rodin Platform]]
 +
[[Category:Proof]]

Latest revision as of 12:53, 12 August 2009

File Types

For each machine and each context there exists one of each of the following roots:

  • IPSRoot: This root contains the statuses (IPSStatus) of the proof obligations. It is contained in a file with the extension .bps.
  • IPORoot: This root contains the sequents (IPOSequent) of the proof obligations. It is contained in a file with the extension .bpo.

The Connection between different root types

An IPSRoot, an IPORootand an IMachineRoot or IContextRoot are connected through the name. For example machine m0 has IMachineRoot that is in file m0.bum, IPSRoot in m0.bps and IPORoot in m0.bpo. If one has any of these roots, one get the others though the functions getMachineRoot(), getContextRoot(), getPSRoot() and getPORoot().

Accessing the sequents of an IPORoot

  • All sequents of root: IPOSequent[] sequents = root.getSequents()
  • A specific sequent (e.g. INITIALISATION/inv1/INV) of root: IPOSequent sequent = root.getSequent("INITIALISATION/inv1/INV")

Accessing the statuses of an IPSRoot

  • All statuses of root: IPSStatus[] statuses = root.getStatuses()
  • A specific status (e.g. INITIALISATION/inv1/INV) of root: IPSStatus status = root.getStatus("INITIALISATION/inv1/INV")

Finding the corresponding status to a given sequent

  • 1. Find the IPORoot that contains sequent: IPORoot poRoot = sequent.getParent;
  • 2. Find the matching IPSRoot: IPSRoot psRoot = poRoot.getPSRoot();
  • 3. Find the machting status: IPSStatus status = psRoot.getStatus(sequent.getElementName);

Finding the corresponding sequent to a given status

Use the function getPOSequent() in IPSStatus.

Accessing the proof obligations of a given machine or context

The sources of a proof obligations

The sources of a proof obligations describe where that proof obligation comes from (e.g. Invariants, Events). They can be accessed from the IPOSequent: IPOSource[] sources = sequents[i].getSources();

An IPOSource can be an instance of an element like IInvariant, ITheorem etc or it can be an IAction, IWitness or IGuard.

Finding all the proof obligations for a given Invariant

It is not possible to directly find the proof obligations for a given invariant or any other element. Instead check if the sources of the proof obligations contain the invariant.