SMT Solvers Plug-in: Difference between revisions

From Event-B
Jump to navigationJump to search
← Older edit
imported>YGU
imported>Nicolas
 
(106 intermediate revisions by 5 users not shown)
Line 1: Line 1:
''For developer support, see [[SMT Solvers Plug-in Developer Support]]''
{{TOCright}}
==Introduction==
==Introduction==
The SMT plug-in allows users to use SMT solvers within Rodin. It is still in developpment (See sources [https://rodin-b-sharp.svn.sourceforge.net/svnroot/rodin-b-sharp/trunk/_exploratory/fages/]).
The SMT plug-in allows users to use SMT solvers within Rodin.  
This plug-in is maintained by SYSTEREL (See sources [https://sourceforge.net/p/rodin-b-sharp/smt/ci/master/tree/]).


'''Since version 0.8:'''<br />
* '''Some SMT solvers (veriT and Cvc3) are bundled within the plug-in. Therefore, it is not necessary (but still possible) to install another copy of these solvers.'''
* '''An Auto-Tactic with SMT profile is available. Thus, it is not necessary (but still possible) to create a new profile to use SMT solvers tactics (see [[#Selecting_an_SMT_Auto-Tactic_Profile|Selecting an SMT auto-tactic profile]] to use this profile).'''


==Installation==
==Installation==
You'll need to:
You will need to:
* Install the Eclipse Platform.
* Install the Rodin Platform.
* Install the Subclipse plug-in to use SVN in Eclipse.
* Install the SMT Solvers Plug-in into Rodin.
* Download Rodin sources into Eclipse.
* Install any additional SMT-solvers you want to use.
* Download SMT plug-in sources into Eclipse.
 
* Install the SMT solvers you want to use.
=== Installing the Rodin Platform ===
Download the latest Rodin (Core) Platform corresponding to your operating system and install it [http://www.event-b.org/install.html].
 
=== Installing the SMT Solvers Plug-in ===
Launch Rodin and go to ''Help > Install New Software...''.
 
[[Image:Install_new_software.png|450px]]
 
 
Select the Rodin Platform Update Site: Rodin - http://rodin-b-sharp.sourceforge.net/updates.
 
[[Image:Select_update_site.png|450px]]
 
 
Unfold the ''Prover Extensions'' category, and select the ''SMT Solvers'' feature. Click ''Next''.
 
[[Image:Select_smt_feature.png|449px]]
 
 
Review the item to be installed and click ''Next''.
 
[[Image:Review_install_details.png|449px]]
 
 
Read and accept the terms of the license agreement to install the plug-in. Then click ''Finish''.
 
[[Image:Review_licenses.png|449px]]
 


=== Installing the Eclipse Platform ===
A security warning appears because the feature content is unsigned. Click ''Ok''.
Download Eclipse Classic (SDK) (169 MB) at http://www.eclipse.org/downloads/ . Install it [http://wiki.eclipse.org/FAQ_Where_do_I_get_and_install_Eclipse%3F].


=== Installing the Subclipse plug-in ===
[[Image:Security_warning.png|450px]]
Launch Eclipse and go to ''Help > Install New Software...''.


Click the ''Add'' button and type:


http://subclipse.tigris.org/update_1.6.x
Click ''Restart Now''.


Name it (ex: SUBCLIPSE 1.6).
The SMT Solvers Plug-in is now installed.


Then select the same items as in the following image:
== Usage ==


[[Image:Subclipse_selection.png|600px]]
Since version 0.8.0, the SMT solver veriT and CVC3 are bundled within the plug-in.
To use additional solvers, see [[#Installing additional SMT solvers]].


Under Linux, in order to use JNI, you'll need to install the following packages:
=== Discharging a Sequent ===
    * libsvn-java
We give an example of Event-B model of which proof obligation can be discharged using an SMT solver:
    * subversion
    * libsvn1
and to link the installation directory in eclipse.ini, by adding:


''-Djava.library.path=/usr/lib/jni''
[[Image:PrettyPrinted context.png|300px]]
[[Image:Hypothesis and goal.png|400px]]


then restart Eclipse and select ''JavaHL'' in ''Window > Preferences > Team > SVN''.
''thm1'' is a theorem which must be proved given axioms ''axm2..axm5''.


=== Downloading the Rodin Sources ===
Open the ''SVN Repository Exploring'' perspective.


Right-clic in the ''SVN Repositories'' view, then ''New > Repository Location''. Enter the following URL : https://rodin-b-sharp.svn.sourceforge.net/svnroot/rodin-b-sharp
Since we installed SMT Solvers Plug-in into the Rodin Platform, the SMT tactic button is now accessible in the ''Proof Control'' bar.


Select all projects in ''trunk > RodinCore'' then right-clic and ''Checkout...''.
[[Image:SMT button.png|450px]]


[[Image:Rodin selection checkout.png|400px]]


''Check out into the workspace as projects'' must be selected. Then click ''Finish''.
Clicking on this button will show the list of all available SMT solver configurations.


The download might be long (might take around 15min), do not interrupt.
[[Image:SMT dropdown.png|450px]]


Once all the sources are downloaded, get back to the ''Java'' perspective. ''org.eventb.core.seqprover'' and ''org.eventb.core.seqprover.tests'' projects might need to be recompiled: select the former and press ''F5''.


=== Downloading the SMT Plug-in Sources ===
The first one, "All enabled SMT", will call successively every enabled SMT solver configurations.
Do the same as to dowload Rodin sources, with projects in ''trunk > exploratory > fages'':
Others are all individual configurations, which may be enabled or not.
* fr.systerel.smt.provers.core
Clicking one of them will discharge the proof obligation if possible:
* fr.systerel.smt.provers.help
* fr.systerel.smt.provers.tests
* fr.systerel.smt.provers.ui


=== Installing the SMT solvers ===
[[Image:Tactic applied successfully.png|450px]]
 
 
When the tactic is applied successfully, this means that the reasonner created the new proof rule:
 
[[Image:Proof Tree and Rule Details.png]]
 
If the solver used to discharge the sequent is able to extract an unsatisfiable core, the proof rule will be produced using it. This is the case for veriT.
 
== Installing additional SMT solvers ==
Currently, the SMT plug-in has been tested with the following solvers:
Currently, the SMT plug-in has been tested with the following solvers:
* veriT (Loria Nancy and UFRN)
* Alt-Ergo (INRIA Saclay)
* Alt-Ergo (INRIA Saclay)
* CVC3 (New York and Iowa Universities)
* CVC3 (New York and Iowa Universities)
* CVC4 (Stanford and Iowa Universities)
* veriT (Loria Nancy and UFRN)
* Z3 (Microsoft Research)
* Z3 (Microsoft Research)


==== Installing veriT ====
=== Installing veriT ===
veriT solver can be downloaded at http://www.verit-solver.org/veriT-download.php. Compilation and installation instructions are in the ''INSTALL'' file. The following tools are used in the installation process (Debian/Ubuntu platforms):
The veriT solver can be downloaded from [http://www.verit-solver.org/veriT-download.php]. Compilation and installation instructions are in the ''INSTALL'' file.<br>
If you want the plug-in to extract unsatisfiable cores from veriT proofs, make sure that the proof production is on in ''Makefile.config'' :
# PROOF_PRODUCTION = NO
PROOF_PRODUCTION = YES
 
The following tools are needed by the installation process (Debian/Ubuntu platforms):
* gcc, g++: compilers
* gcc, g++: compilers
* make, ar, ranlib: build process
* make, ar, ranlib: build process
Line 75: Line 113:
Do not forget to install the E-prover as well[http://eprover.org/] (''eprover'' package on Ubuntu platforms).
Do not forget to install the E-prover as well[http://eprover.org/] (''eprover'' package on Ubuntu platforms).


==== Installing Alt-Ergo ====
=== Installing Alt-Ergo ===
alt-ergo solver can be downloaded at http://alt-ergo.lri.fr/, or installed using the Ubuntu repository: ''alt-ergo'' package.
The alt-ergo solver can be downloaded from http://alt-ergo.lri.fr/, or installed using the Ubuntu repository: ''alt-ergo'' package.
 
=== Installing CVC3 ===
The CVC3 solver can be downloaded from http://cs.nyu.edu/acsys/cvc3/download.html, or installed using the Ubuntu repository: ''cvc3'' package.
 
=== Installing CVC4 ===
The CVC4 solver can be downloaded from http://cvc4.cs.nyu.edu/cvc4-builds .
 
=== Installing Z3 ===
The Z3 solver can be downloaded from https://github.com/Z3Prover/z3/wiki .
 
== Connect added solvers to the Rodin Platform ==
In order to use some SMT Solver, you must connect it to the Rodin platform by adding it to the list of known solvers, and adding SMT configurations to be used by the SMT tactic.<br/>
There can be several configurations (i.e. parameterization) targetting the same SMT solver.<br/>
 
Since version 0.8.0, some SMT solvers are bundled within the plug-in, and some default configurations are already available. To use the plug-in right now with these solvers, see [[#Usage]].
 
To display the SMT solvers page, open the ''Preferences'' window: ''Window > Preferences'', and unfold the SMT section in order to display the ''Configurations'' page.
 
[[Image:SMT_Solvers_Configurations.png|650px]]
 
=== Adding a new solver to Rodin ===
 
To use a new SMT solver in Rodin, click the ''Add'' button next to the list of known solvers.
 
[[Image:SMT_Solvers_AddSolver.png]]
 
* Fill the ''Name'' field with the name you want to give to this solver.
* Select the kind of the solver if it appears in the combo box. In this case, this will let the plug-in use some specific options of the solver to improve its integration. If it does not appear in the list, just select ''unknown''.
* Click ''Browse'' to enter the path to the solver executable.
* Click ''OK''.
 
=== Editing SMT Solver information ===
You can edit the information given when adding a SMT solver by clicking the ''Edit...'' button after having selected the solver information to edit in the list.<br/>
Note that the bundled solver connections cannot be edited.
 
=== Removing an SMT Solver information ===
You can remove location information on a ''selected'' solver by clicking the ''Remove'' button next to the list of known solvers.<br/>
Note that bundled solvers connections cannot be removed.
 
=== Restoring Default Solvers ===
Bundled solvers are set as default solvers. A click on the ''Restore Defaults'' button will remove all the solvers which are not bundled within the plugin.
 
== Customizing SMT Solvers Configurations ==
In order to run the various solvers from the SMT tactic, one has to define solver configurations.<br/>
We call ''SMT solver configuration'' a settled configuration of a solver, with ad-hoc properties such as its parameters and the SMT-LIB version of the benchmarks it will execute.<br>
For example, such configurations can execute a given solver with specific options, or specific versions of the solver.<br>
 
Since version 0.8.0, some SMT solvers are bundled within the plug-in. Some configurations of these solvers is already available in the plug-in : for example, the bundled veriT configuration launches the veriT solver (without e-prover), using the translation to SMT-LIB 2.0 and with the unsat-core extraction enabled. To use the plug-in right now with these configurations, see [[#Usage]].
 
To display the SMT solvers page, open the Preferences window: Window > Preferences, and unfold the SMT section in order to display the Configurations page.
 
[[Image:SMT_Solvers_Configurations.png|500px]]
 
=== Adding a New Solver Configuration ===
 
In order to run the various solvers from the SMT tactic, one has to define solver configurations.<br/>
A configuration contains :
* its name,
* its status from ''enabled'', ''not enabled'',
* the name of the solver from the list of known solvers,
* the parameterization of the solver under the form of command line arguments',
* the Rodin to SMT-LIB translator to be used (either PP or veriT),
* the version of the SMT-LIB to be used ( V1.2 or V2.0).
 
A configuration is a preset (e.g. customization) of one solver binary which appears in the list of known solvers.<br/>
Thus there can be several configurations (i.e. parameterization) targetting the same SMT solver.<br/>
[[Image:SMT_Solvers_AddConfiguration.png]]
 
To add a new SMT solver configuration into Rodin, just click the ''Add'' button next to the list of solver configurations.
 
* Fill the ''Name'' with the name you want to give to this configuration.
* Choose whether this configuration shall be run or not when calling the SMT tactic by checking the ''Enable'' checkbox. This value can be changed directly in the ''Configurations'' page too.
* Select the solver you want to use in this configuration. A solver to choose among the connected solvers of the ''Solvers'' page.
* Fill the ''Solver arguments'' if needed. For example, you must enter here the solver option which sets the version of SMT-LIB to be used by the solver.
* Select which SMT translator to used (just select PP unless you know why).
* Select which version of SMT-LIB must be used by the plug-in (just select V2.0 unless you know why).
* Enter the value of the time out delay, which is, the time (in milliseconds) after which the platform will terminate the solver if it has not yet answered.


==== Installing CVC3 ====
* Click ''OK''.
CVC3 solver can be downloaded at http://cs.nyu.edu/acsys/cvc3/download.html, or installed using the Ubuntu repository: ''cvc3'' package.


==== Installing Z3 ====
=== Enabling/Disabling a Solver Configuration ===
Z3 solver can be downloaded at http://research.microsoft.com/en-us/um/redmond/projects/z3/download.html.
When you will call the SMT tactic, only the enabled configurations will be executed.<br/>
One can enable or disable a configuration from the configurations page.<br/>
To do this, just tick or untick the checkbox corresponding to a given configuration.


[[Image:SMT_configuration_enablement_status.png|500px]]


== Configuration ==
=== Editing a Solver Configuration ===
You can edit all the informations given when setting a new solver configuration by clicking the ''Edit'' button. The bundled configurations cannot be edited.


You'll need to:
=== Removing a Solver Configuration ===
* Launch the Rodin platform as to set the default ''Run Configuration''.
You can remove the selected configuration by clicking the ''Remove'' button. The bundled configurations cannot be removed.
* Add the SMT plug-ins to this configuration.
* Set the SMT solvers you want to use within Rodin.


=== Launching the Rodin Platform ===
=== Duplicating a Solver Configuration ===
Once we have downloaded the Rodin sources, and built it within Eclipse, we can launch the Rodin platform.
You can duplicate any configuration by clicking the ''Duplicate'' button. This will open the configuration dialog with the information of the original configuration. Just edit them and click ''OK'' to add the duplicated configuration.


Enter the ''org.rodinp.platform'' project and right-clic ''Rodin.product'' file then choose ''Run As... > Eclipse Application''.
=== Restoring Default Solvers Configurations ===
The default configurations are the bundled ones. A click on the ''Restore Defaults'' button will remove all the configurations which are not bundled within the plugin.


[[Image:Run As EclipseApp.png|450px]]
== Customizing the SMT-LIB translation settings ==
To display the SMT translation page, open the ''Preferences'' window: ''Window > Preferences'' and select the ''SMT'' node.


The Rodin platform is launched and ready.
[[Image:SMT_TranslationConfig.png|450px]]
=== Setting the Temporary Directory Path ===
The plug-in needs to store some temporary files to interact with the external SMT Solver.<br>
By default, this is set to the system temporary directory path.<br/>
You can change the directory to use for this purpose, by clicking the corresponding ''Browse'' button, and selecting the target directory.


=== Adding the SMT plug-ins to the Run Configuration ===
=== Setting the veriT Path ===
Close the Rodin Platform. Back in the Eclipse Platform, go to the Run Configuration: ''Run > Run Configurations...''.
Since version 1.3, this setting has disappeared, as the translation is always performed through PP.
It was made to use veriT instead of ppTrans to translate Event-B sequents into SMT-LIB benchmarks.


Select the ''Rodin.product'' configuration, and go to the ''Plug-ins'' tab. Check all the SMT Plug-ins except ''fr.systerel.smt.provers.tests''.
=== Setting the SMT auto tactic timeout ===
Since version 1.1.0, the timeout of SMT solvers within "All enabled SMT configurations" can be customized.
The timeout (in ''milliseconds'') applies to each SMT solver individually. It is used in particular in the "Default Auto Tactic with SMT" profile.


[[Image:Plug-ins to select.png|450px]]
=== Restoring Default Translation Settings ===
You can restore the default translation settings values by clicking the ''Restore Defaults'' button.<br/>
The default veriT path is the path of the bundled veriT solver.<br/>
The default translation directory path is the system temporary directory path.<br/>
The default timeout is 1000.


Now, you can launch the Rodin platform extended with the SMT plug-in.
== SMT Auto-Tactic Profile ==
Since version 0.8.0 of the plug-in, an Auto-Tactic profile using SMT solvers is available in the plug-in. To use this profile, see [[#Selecting an SMT auto-tactic profile]].


=== SMT solvers settings ===
One might also want to set-up one or several custom configurations of SMT solver to be used automatically to discharge Event-B sequents in the Rodin platform.<br>
To use the plug-in, you must set up the SMT Solvers preferences by reaching the SMT solvers section: ''Windows > Preferences > SMT Solver''.
For more information about tactic profiles, see ''Advanced Profile Customisation'' in [[Rodin_Platform_2.3_Release_Notes]] and ''3.1.8.4 Sequent Prover / Auto/Post Tactic'' in [http://handbook.event-b.org/current/html/preferences.html the preference page of the Rodin User’s Handbook v.2.4].<br>


Add a new SMT solver configuration into Rodin by clicking the ''Add'' button:
=== Selecting an SMT Auto-Tactic Profile ===
* Fill the ''Solver ID'' with the name of the solver
* Click ''Browse'' to fill the solver path
* Fill the ''Solver arguments'' if needed. For now, veriT, Alt-Ergo and Z3 do not need any argument. CVC3 must be used with ''-lang smt'' argument.
* Select which version of SMT-LIB must be used by the plug-in (Currently, version 1.2 is the only one covered by the plug-in).
* Click ''OK''


Then you must select which solver will be used when calling SMT tactic by selecting this solver's line and click ''Select'':
One may want to use the new SMT auto-tactic profile (available since version 0.8.0 of the plug-in), or a user-defined profile using SMT solvers.


[[Image:Selected solver.png|450px]]
To set it on, go to the ''Auto/Post Tactic'' tab.


The selected solver is the blue one.
[[Image:Smt auto tactic profile selected.png|450px]]


=== SMT-LIB translation settings ===
Set the tactic profile to be used for auto-tactics up to the one combining the SMT tactic, by using the drop-down menu.
If you want to use veriT instead of ppTrans to translate Event-B sequents into SMT-LIB benchmarks, select ''prepro'' option, and click ''Browse'' to fill veriT's path.


Then click ''Ok''.


== Usage  ==
Now, the combined tactics of your new profile, including the SMT tactic, will be automatically launched when auto-provers are called.
We give an example of Event-B model of which proof obligation can be discharge using an SMT solver:


[[Image:PrettyPrinted context.png|225px]]
=== Creating a New SMT Auto-Tactic Profile ===
[[Image:Hypothesis and goal.png|225px]]


''thm1'' is a theorem which must be proved given axioms ''axm2..axm5''.
A reasonable combination using the SMT tactic is an SMT tactic queued to the default auto tactic combination. We show here how to create such a ''profile''.
 
First, open the ''Preferences'' window of the Rodin platform: ''Window > Preferences''.
 
[[Image:Preferences_menu.png|450px]]
 
 
Open the ''Auto/Post Tactic'' preferences page: ''Event-B > Sequent Prover > Auto/Post Tactic''. Go to the ''Profiles'' tab.
 
[[Image:Duplicating_auto_tactic_profile.png|450px]]
 
Select the default auto tactic profile, and click ''Duplicate'' to duplicate it.
 
Then, select the duplicated profile, and click ''Edit'' to edit it.
 
[[Image:Auto_tactic_profile_duplicated.png|450px]]
 
In the tactic profile window, rename the profile, and drag and drop the chosen SMT tactic from the tactics list (in the first column) to the end of the combined tactics (in the second column).
 
[[Image:Adding_smt_tactic_in_profile.png|450px]]
 
Then click ''Finish''.
 
Now a new profile combining the SMT tactic with other tactics is created.


== Bugs and Features Request ==
* SMT-LIB 2.0 support with the veriT translation approach in developpment
* Full set theory support in progress
* Support of division, modulo and exponentiation


Since we installed SMT Plug-in into the Rodin Platform, the SMT tactic button is now accessible in the ''Proof Control'' bar.
== Releases Notes ==


[[Image:SMT button.png|450px]]
'''Version 1.4.0'''
* Upgrade veriT (v2016)
* Upgrade CVC4 (v1.4)
* Upgrade Z3 (v4.5)
* See [[SMT 1.4 Performance Results]]


'''Version 1.3.0'''
* Add CVC4 and Z3, decreasing manual POs by 40% !
* Simplify preferences:
** always translate through PP
** assume SMT-lib 2.0


Clicking on this button will call the previously selected SMT solver, which will discharge the proof obligation if possible:
'''Version 1.2.0'''
* Port to Rodin 3.0
* Shortcut to solver configurations in Proof Control


[[Image:Tactic applied successfully.png|450px]]
'''Version 1.1.0'''
* Preference for auto tactic timeout.


'''Version 1.0.0'''
* Cvc3 SMT solver bundled with the plug-in
* User Interface entirely refactored for more intuitive experience: solvers preferences, configurations preferences and translation preferences are now separated into three preferences pages. This change is not backward compatible with previous versions of the plug-in.
* Notably added a button for duplicating a configuration


When the tactic is applied successfully, this means that the reasonner created the new proof rule:
'''Version 0.8.0'''
* Support of SMT-LIB 2.0 in the PP translation approach
* Inclusion of the SMT solver veriT in the plug-in
* Addition of an SMT auto-tactic
* Auto-Tactic profile containing the SMT auto-tactic
* Possibility to parameterize a new SMT tactic
* Integration of solvers successfully tested with:
** Alt-Ergo 0.93
** Cvc3 2011-11-21
** veriT (included in the plug-in)
** z3 3.2
** Cvc4 2011-12-11 (but few theories are available for now)
* Good results in the field of linear integer arithmetic with uninterpreted sort and function symbols
* Good support of basic set theory
* Full set theory support needs to be improved
* Results showed the SMT Solvers Plug-in was a good alternative to the Atelier-B provers


[[Image:Proof Tree and Rule Details.png|450px]]
'''Version 0.1.0'''
* Initial beta-release.
* Two approaches for translating Event-B to SMT-LIB 1.2:
** with ppTrans (included in Rodin official releases)
** with veriT (must be installed)
* Integration of solvers successfully tested with: ''(notice that no solver will be included in the plug-in at all)''
** Alt-Ergo 0.93
** Cvc3 2011-07-14
** veriT 201107
** z3 2.19
* Good results in the field of linear integer arithmetic with uninterpreted sort and function symbols
* Good support of basic set theory
* Full set theory support needs to be improved
* No SMT-LIB 2.0 support in this release


For now, the proof tree doesn't contain any detail because SMT-LIB 1.2 doesn't implement a proof witnesses system.
[[Category:Plugin]]
[[Category:User documentation]]

Latest revision as of 15:41, 2 October 2017

For developer support, see SMT Solvers Plug-in Developer Support

Introduction

The SMT plug-in allows users to use SMT solvers within Rodin. This plug-in is maintained by SYSTEREL (See sources [1]).

Since version 0.8:

  • Some SMT solvers (veriT and Cvc3) are bundled within the plug-in. Therefore, it is not necessary (but still possible) to install another copy of these solvers.
  • An Auto-Tactic with SMT profile is available. Thus, it is not necessary (but still possible) to create a new profile to use SMT solvers tactics (see Selecting an SMT auto-tactic profile to use this profile).

Installation

You will need to:

  • Install the Rodin Platform.
  • Install the SMT Solvers Plug-in into Rodin.
  • Install any additional SMT-solvers you want to use.

Installing the Rodin Platform

Download the latest Rodin (Core) Platform corresponding to your operating system and install it [2].

Installing the SMT Solvers Plug-in

Launch Rodin and go to Help > Install New Software....


Select the Rodin Platform Update Site: Rodin - http://rodin-b-sharp.sourceforge.net/updates.


Unfold the Prover Extensions category, and select the SMT Solvers feature. Click Next.


Review the item to be installed and click Next.


Read and accept the terms of the license agreement to install the plug-in. Then click Finish.


A security warning appears because the feature content is unsigned. Click Ok.


Click Restart Now.

The SMT Solvers Plug-in is now installed.

Usage

Since version 0.8.0, the SMT solver veriT and CVC3 are bundled within the plug-in. To use additional solvers, see #Installing additional SMT solvers.

Discharging a Sequent

We give an example of Event-B model of which proof obligation can be discharged using an SMT solver:

thm1 is a theorem which must be proved given axioms axm2..axm5.


Since we installed SMT Solvers Plug-in into the Rodin Platform, the SMT tactic button is now accessible in the Proof Control bar.


Clicking on this button will show the list of all available SMT solver configurations.


The first one, "All enabled SMT", will call successively every enabled SMT solver configurations. Others are all individual configurations, which may be enabled or not. Clicking one of them will discharge the proof obligation if possible:


When the tactic is applied successfully, this means that the reasonner created the new proof rule:

If the solver used to discharge the sequent is able to extract an unsatisfiable core, the proof rule will be produced using it. This is the case for veriT.

Installing additional SMT solvers

Currently, the SMT plug-in has been tested with the following solvers:

  • Alt-Ergo (INRIA Saclay)
  • CVC3 (New York and Iowa Universities)
  • CVC4 (Stanford and Iowa Universities)
  • veriT (Loria Nancy and UFRN)
  • Z3 (Microsoft Research)

Installing veriT

The veriT solver can be downloaded from [3]. Compilation and installation instructions are in the INSTALL file.
If you want the plug-in to extract unsatisfiable cores from veriT proofs, make sure that the proof production is on in Makefile.config : 

# PROOF_PRODUCTION = NO
PROOF_PRODUCTION = YES

The following tools are needed by the installation process (Debian/Ubuntu platforms):

  • gcc, g++: compilers
  • make, ar, ranlib: build process
  • wget, tar, patch: to fetch GMP and Minisat
  • bison, flex, m4: build compilers and preprocessing

Do not forget to install the E-prover as well[4] (eprover package on Ubuntu platforms).

Installing Alt-Ergo

The alt-ergo solver can be downloaded from http://alt-ergo.lri.fr/, or installed using the Ubuntu repository: alt-ergo package.

Installing CVC3

The CVC3 solver can be downloaded from http://cs.nyu.edu/acsys/cvc3/download.html, or installed using the Ubuntu repository: cvc3 package.

Installing CVC4

The CVC4 solver can be downloaded from http://cvc4.cs.nyu.edu/cvc4-builds .

Installing Z3

The Z3 solver can be downloaded from https://github.com/Z3Prover/z3/wiki .

Connect added solvers to the Rodin Platform

In order to use some SMT Solver, you must connect it to the Rodin platform by adding it to the list of known solvers, and adding SMT configurations to be used by the SMT tactic.
There can be several configurations (i.e. parameterization) targetting the same SMT solver.

Since version 0.8.0, some SMT solvers are bundled within the plug-in, and some default configurations are already available. To use the plug-in right now with these solvers, see #Usage.

To display the SMT solvers page, open the Preferences window: Window > Preferences, and unfold the SMT section in order to display the Configurations page.

Adding a new solver to Rodin

To use a new SMT solver in Rodin, click the Add button next to the list of known solvers.

  • Fill the Name field with the name you want to give to this solver.
  • Select the kind of the solver if it appears in the combo box. In this case, this will let the plug-in use some specific options of the solver to improve its integration. If it does not appear in the list, just select unknown.
  • Click Browse to enter the path to the solver executable.
  • Click OK.

Editing SMT Solver information

You can edit the information given when adding a SMT solver by clicking the Edit... button after having selected the solver information to edit in the list.
Note that the bundled solver connections cannot be edited.

Removing an SMT Solver information

You can remove location information on a selected solver by clicking the Remove button next to the list of known solvers.
Note that bundled solvers connections cannot be removed.

Restoring Default Solvers

Bundled solvers are set as default solvers. A click on the Restore Defaults button will remove all the solvers which are not bundled within the plugin.

Customizing SMT Solvers Configurations

In order to run the various solvers from the SMT tactic, one has to define solver configurations.
We call SMT solver configuration a settled configuration of a solver, with ad-hoc properties such as its parameters and the SMT-LIB version of the benchmarks it will execute.
For example, such configurations can execute a given solver with specific options, or specific versions of the solver.

Since version 0.8.0, some SMT solvers are bundled within the plug-in. Some configurations of these solvers is already available in the plug-in : for example, the bundled veriT configuration launches the veriT solver (without e-prover), using the translation to SMT-LIB 2.0 and with the unsat-core extraction enabled. To use the plug-in right now with these configurations, see #Usage.

To display the SMT solvers page, open the Preferences window: Window > Preferences, and unfold the SMT section in order to display the Configurations page.

Adding a New Solver Configuration

In order to run the various solvers from the SMT tactic, one has to define solver configurations.
A configuration contains :

  • its name,
  • its status from enabled, not enabled,
  • the name of the solver from the list of known solvers,
  • the parameterization of the solver under the form of command line arguments',
  • the Rodin to SMT-LIB translator to be used (either PP or veriT),
  • the version of the SMT-LIB to be used ( V1.2 or V2.0).

A configuration is a preset (e.g. customization) of one solver binary which appears in the list of known solvers.
Thus there can be several configurations (i.e. parameterization) targetting the same SMT solver.

To add a new SMT solver configuration into Rodin, just click the Add button next to the list of solver configurations.

  • Fill the Name with the name you want to give to this configuration.
  • Choose whether this configuration shall be run or not when calling the SMT tactic by checking the Enable checkbox. This value can be changed directly in the Configurations page too.
  • Select the solver you want to use in this configuration. A solver to choose among the connected solvers of the Solvers page.
  • Fill the Solver arguments if needed. For example, you must enter here the solver option which sets the version of SMT-LIB to be used by the solver.
  • Select which SMT translator to used (just select PP unless you know why).
  • Select which version of SMT-LIB must be used by the plug-in (just select V2.0 unless you know why).
  • Enter the value of the time out delay, which is, the time (in milliseconds) after which the platform will terminate the solver if it has not yet answered.
  • Click OK.

Enabling/Disabling a Solver Configuration

When you will call the SMT tactic, only the enabled configurations will be executed.
One can enable or disable a configuration from the configurations page.
To do this, just tick or untick the checkbox corresponding to a given configuration.

Editing a Solver Configuration

You can edit all the informations given when setting a new solver configuration by clicking the Edit button. The bundled configurations cannot be edited.

Removing a Solver Configuration

You can remove the selected configuration by clicking the Remove button. The bundled configurations cannot be removed.

Duplicating a Solver Configuration

You can duplicate any configuration by clicking the Duplicate button. This will open the configuration dialog with the information of the original configuration. Just edit them and click OK to add the duplicated configuration.

Restoring Default Solvers Configurations

The default configurations are the bundled ones. A click on the Restore Defaults button will remove all the configurations which are not bundled within the plugin.

Customizing the SMT-LIB translation settings

To display the SMT translation page, open the Preferences window: Window > Preferences and select the SMT node.

Setting the Temporary Directory Path

The plug-in needs to store some temporary files to interact with the external SMT Solver.
By default, this is set to the system temporary directory path.
You can change the directory to use for this purpose, by clicking the corresponding Browse button, and selecting the target directory.

Setting the veriT Path

Since version 1.3, this setting has disappeared, as the translation is always performed through PP. It was made to use veriT instead of ppTrans to translate Event-B sequents into SMT-LIB benchmarks.

Setting the SMT auto tactic timeout

Since version 1.1.0, the timeout of SMT solvers within "All enabled SMT configurations" can be customized. The timeout (in milliseconds) applies to each SMT solver individually. It is used in particular in the "Default Auto Tactic with SMT" profile.

Restoring Default Translation Settings

You can restore the default translation settings values by clicking the Restore Defaults button.
The default veriT path is the path of the bundled veriT solver.
The default translation directory path is the system temporary directory path.
The default timeout is 1000.

SMT Auto-Tactic Profile

Since version 0.8.0 of the plug-in, an Auto-Tactic profile using SMT solvers is available in the plug-in. To use this profile, see #Selecting an SMT auto-tactic profile.

One might also want to set-up one or several custom configurations of SMT solver to be used automatically to discharge Event-B sequents in the Rodin platform.
For more information about tactic profiles, see Advanced Profile Customisation in Rodin_Platform_2.3_Release_Notes and 3.1.8.4 Sequent Prover / Auto/Post Tactic in the preference page of the Rodin User’s Handbook v.2.4.

Selecting an SMT Auto-Tactic Profile

One may want to use the new SMT auto-tactic profile (available since version 0.8.0 of the plug-in), or a user-defined profile using SMT solvers.

To set it on, go to the Auto/Post Tactic tab.

Set the tactic profile to be used for auto-tactics up to the one combining the SMT tactic, by using the drop-down menu.

Then click Ok.

Now, the combined tactics of your new profile, including the SMT tactic, will be automatically launched when auto-provers are called.

Creating a New SMT Auto-Tactic Profile

A reasonable combination using the SMT tactic is an SMT tactic queued to the default auto tactic combination. We show here how to create such a profile.

First, open the Preferences window of the Rodin platform: Window > Preferences.


Open the Auto/Post Tactic preferences page: Event-B > Sequent Prover > Auto/Post Tactic. Go to the Profiles tab.

Select the default auto tactic profile, and click Duplicate to duplicate it.

Then, select the duplicated profile, and click Edit to edit it.

In the tactic profile window, rename the profile, and drag and drop the chosen SMT tactic from the tactics list (in the first column) to the end of the combined tactics (in the second column).

Then click Finish.

Now a new profile combining the SMT tactic with other tactics is created.

Bugs and Features Request

  • SMT-LIB 2.0 support with the veriT translation approach in developpment
  • Full set theory support in progress
  • Support of division, modulo and exponentiation

Releases Notes

Version 1.4.0

Version 1.3.0

  • Add CVC4 and Z3, decreasing manual POs by 40% !
  • Simplify preferences:
    • always translate through PP
    • assume SMT-lib 2.0

Version 1.2.0

  • Port to Rodin 3.0
  • Shortcut to solver configurations in Proof Control

Version 1.1.0

  • Preference for auto tactic timeout.

Version 1.0.0

  • Cvc3 SMT solver bundled with the plug-in
  • User Interface entirely refactored for more intuitive experience: solvers preferences, configurations preferences and translation preferences are now separated into three preferences pages. This change is not backward compatible with previous versions of the plug-in.
  • Notably added a button for duplicating a configuration

Version 0.8.0

  • Support of SMT-LIB 2.0 in the PP translation approach
  • Inclusion of the SMT solver veriT in the plug-in
  • Addition of an SMT auto-tactic
  • Auto-Tactic profile containing the SMT auto-tactic
  • Possibility to parameterize a new SMT tactic
  • Integration of solvers successfully tested with:
    • Alt-Ergo 0.93
    • Cvc3 2011-11-21
    • veriT (included in the plug-in)
    • z3 3.2
    • Cvc4 2011-12-11 (but few theories are available for now)
  • Good results in the field of linear integer arithmetic with uninterpreted sort and function symbols
  • Good support of basic set theory
  • Full set theory support needs to be improved
  • Results showed the SMT Solvers Plug-in was a good alternative to the Atelier-B provers

Version 0.1.0

  • Initial beta-release.
  • Two approaches for translating Event-B to SMT-LIB 1.2:
    • with ppTrans (included in Rodin official releases)
    • with veriT (must be installed)
  • Integration of solvers successfully tested with: (notice that no solver will be included in the plug-in at all)
    • Alt-Ergo 0.93
    • Cvc3 2011-07-14
    • veriT 201107
    • z3 2.19
  • Good results in the field of linear integer arithmetic with uninterpreted sort and function symbols
  • Good support of basic set theory
  • Full set theory support needs to be improved
  • No SMT-LIB 2.0 support in this release
Retrieved from ‘https://wiki.event-b.org/index.php?title=SMT_Solvers_Plug-in&oldid=9242’