Download: Difference between revisions

Latest Release

Below are links for downloading the latest stable release of probcli (the command line version of ProB) and ProB Tcl/Tk (ProB with a graphical user interface written in Tcl/Tk). Note: please use the provided start scripts (StartProB.sh or StartProBWin.bat) to start ProB. The list of changes can be found in the ProB release history.

Details of the ProB Licence can be found here. ProB is free to use and open source. For commercial support contact Michael Leuschel. In particular, we can provide access to the validation report for using ProB as a tool of class T2 or T3 within the European norm EN50128.

The B parser of ProB requires Java 8 or newer. More details are available below.

The Graphical User Interface of ProB Tcl/Tk requires Tcl/Tk 8.5 or 8.6. More details are available below. The default Tcl/Tk on macOS is broken and will result in black windows, and you have to install another version of Tcl/Tk. All releases include the command-line version probcli which does not require Tcl/Tk.

Releases are compiled for the x86_64 architecture (64-bit Intel). macOS releases of ProB 1.12.0 and later also support aarch64 (64-bit ARM/Apple Silicon). The last version built for x86 (32-bit Intel) is ProB 1.8.0 (see prior versions). If you are using an unsupported architecture or system, you may still be able to run ProB from source.

Note that: on macOS you still have to right-click on the application and use "Open", even though ProB Tcl/Tk (and probcli and all libraries) are signed and notarized.

Latest Beta Release

The latest beta release is 1.13.1-beta1. An official beta release always passes all of ProB's tests. However, we do not follow the stringent checklist for final releases (e.g., checking SICStus Prolog Spider warnings, checking coverage and additional manual UI tests). Also, we do not store coverage reports and other information necessary for T2 certification.

Nightly Builds

More current nightly integration builds are also available. These releases are usually updated every night and old versions are not stored.

Note for macOS users: Nightly builds of ProB are not signed or notarized, so macOS 10.15 and later (Catalina, Big Sur or Monterey, Ventura) will refuse to run them. As a workaround, you will need to run xattr -r -d com.apple.quarantine * inside the ProB directory before launching ProB. The stable and beta releases listed above are signed and notarized, so they will run without extra steps.

Automatically generated test coverage reports are also available. They are usually updated once per week.

Sourcecode

You can download the latest Prolog sourcecode snapshot from: https://stups.hhu-hosting.de/downloads/prob/source/

The source code for the ProB parsers (B, LTL, ...) can be obtained from: https://github.com/hhu-stups/probparsers

Prior Versions

Prior Versions of ProB going back to 1.3.1 are available for download here. If you are interested in still earlier releases, please have a look at the Download directory.

Other ProB tools

ProB Jupyter Kernel

You can now create Jupyter Notebooks in B using the ProB Jupyter kernel. Downloads, instructions, and source code can be found on its own page.

You can try out the ProB Jupyter kernel in your browser without installing it first. Note that notebooks are not saved permanently in this online version! To keep your notebooks, you must download them before closing the page.

ProB for Rodin

To install ProB for Rodin, first download a current version of Rodin (e.g., Rodin 3.8). Inside Rodin, choose Help -> Install New Software and choose the pre-configured ProB update site.

More detailed installation instructions and a brief tutorial are available.

• Nightly builds of ProB for Rodin 3 can be obtained from within Rodin by using the update site https://stups.hhu-hosting.de/rodin/prob1/nightly.

ProB2-UI (based on JavaFX)

Version 1.2.1 of the new JavaFX-based ProB2-UI is available. See the release history for what's new. You can use these stand-alone versions which come bundled with the right Java runtime environment:

• Windows installer
• macOS (Apple Silicon) application DMG (not signed/notarized yet! see below)
• macOS (Intel) application DMG (not signed/notarized yet! see below)
• Debian package

You can also download a multi-platform jar, which works Java 11 or later (and with Java 8 versions which have JavaFX included) on all platforms (Windows, macOS, Linux).

Details about new features and improvements can be found in the release history, along with download links for older versions.

Snapshot builds of the current development version of ProB2-UI (1.2.2-SNAPSHOT) are also available:

• Windows installer snapshot
• macOS (Apple Silicon) application DMG snapshot (not signed/notarized! see below)
• macOS (Intel) application DMG snapshot (not signed/notarized! see below)
• Debian package snapshot
• Multi-platform jar snapshot

The source code for ProB2-UI is available at https://github.com/hhu-stups/prob2_ui and can be built by following these instructions.

The underlying ProB Java API of ProB2-UI (aka the ProB 2 kernel) is available to Java developers via Maven Central. Its source code can be obtained from: https://github.com/hhu-stups/prob2_kernel.

macOS issues

When you run the macOS app for the first time, you might have to open the app twice for ProB 2 UI to start properly. This should only happen once.

The ProB 2 UI macOS app releases are signed and notarized, so they should run without issues on current macOS versions. However, the multi-platform jar and snapshot app builds are not signed or notarized, so newer macOS versions will refuse to run them or say that the application is damaged. As a workaround, right-click the app, select "Open", and confirm the security dialog. If the dialog still doesn't give you an option to open the app, click "Cancel" and do the same thing again.

To run the multi-platform jar on macOS, we recommend using Java 15 or later. Older Java/JavaFX versions may lead to an incorrect system font resulting in gibberish text display. Alternatively, use the macOS app build, which comes with Java 17 and does not have this issue.

Editor Support

• A VIM plugin for ProB is available. It shows a quick fix list of parse and type errors for classical B machines (.mch) using the command line tool probcli. VIM has builtin syntax highlighting support for B.

• There is a B/ProB Language Support extension for the VSCode editor. It integrates with command line tool probcli to obtain error markers for syntax and type errors. It can also be used for well-definedness checking.

• Some BBedit Language modules for B, TLA+, CSP and Prolog are available; these do not use command line tool probcli.

Java Requirements for B Parser

The B parser of ProB requires Java 8 or newer. Java 11, 17, etc. are also fully supported. ProB 1.9.3 is the last version to support Java 7. ProB 1.5.0 is the last version to support Java 6.

You can install a Java Runtime Environment (JRE) from various sources, such as Eclipse Adoptium, Azul Zulu, or your system package manager.

Note: on some systems (macOS) you may have to install the full Java Development Kit (JDK), and not just the JRE, so that Java 8 becomes available to the command-line tools. Type java -version to check which version is used by default for command-line tools; see also this discussion on StackOverflow. In case you have trouble starting the Java parser you can now set the JAVA_PATH preference of ProB to point to the java tool (or java.exe on Windows).

To check whether ProB can correctly use its Java parser you can type the following (using probcli.exe on Windows):

probcli -version -v

This will try and start the parser and obtain the parser version. In case Java is not correctly installed you should get an error message. If you see the error message

Unsupported major.minor version 52.0

this means you do not have Java 8 or newer installed. You can try setting the path to the correct java version by setting the JAVA_PATH preference as follows:

probcli -p JAVA_PATH path/to/java -version -v

Tcl/Tk Requirements for ProB Tcl/Tk

ProB Tcl/Tk requires an installation of Tcl/Tk 8.5 or Tcl/Tk 8.6. The command-line tool probcli does not require this.

Tcl/Tk on macOS

Important note: macOS comes pre-installed with a version of Tcl/Tk which is broken. This may result in the display of unreadable black windows or crashes in the standard file dialogs. There are various options to install Tcl/Tk:

• with Homebrew using the tcl-tk formula
• with MacPorts
• use the ActiveTcl version of Tcl/Tk

You should probably start ProB using the StartProB.sh script: it will auto-detect Tcl/Tk versions and set the SP_TCL_DSO environment variable. Below are more details:

Tcl/Tk from Homebrew or MacPorts

You can install a newer Tcl/Tk (e.g., 8.6.13) using Homebrew or MacPorts. Note: In the earlier release 8.6.11 file open and file save dialogs will not work. For Homebrew the command to install thetcl-tk formula is:

 brew install tcl-tk

However, as the location of the libraries is not standard, you have to define the variable SP_TCL_DSO. The StartProB.sh script should set SP_TCL_DSO automatically. You can also define and export this variable yourself before starting ProB from the Terminal by typing this (you may have to adapt the link if you are using another version of Tcl/Tk):

export SP_TCL_DSO=/usr/local/Cellar/tcl-tk/8.6.13_5/lib/libtcl8.6.dylib

If you have uses MacPorts the path is probably /opt/local/lib/libtcl.dylib. You can also set the variable by adding -DSP_TCL_DSO=/usr/local/Cellar/tcl-tk/8.6.12/lib/libtcl8.6.dylib to the command starting ProB. You may also have to install tk-table package yourself (it is bundled with Active Tcl).

Active Tcl

The the ActiveTcl version of Tcl/Tk is automatically recognised by ProB and you do not have to set SP_TCL_DSO.

However, in Active Tcl/Tk 8.6 on macOS the double click in the "Operations View" or other views is not working correctly. You have to hit the RETURN key in the "Operations View" or right-click on an operation and select "Perform ..." to execute an operation until this is fixed. The older ersion 8.5.12 has a bug related to copying text, see also here).

Other Notes

Note: on macOS Catalina or later the Tcl/Tk menu bar is sometimes not working. Switching to another application and then back to ProB seems to solve the problem. If you see the message "macOS 11 or later required !" in the terminal when launching prob you should re-install Tcl/Tk as described above.

Tcl/Tk on Windows

We currently provide two downloads of ProB, one for Tcl/Tk 8.6 (which we recommend) and a version for Tcl/Tk 8.5. You can use for example the ActiveTcl releases. Note: For the 64 bit version of ProB for Windows, you have to install the 64 bit Tcl/Tk 8.5 version! ProB 1.12 (currently available as nightly build) works with both Tcl/Tk 8.5 and 8.6. You may have to point the environment variable SP_TCL_DSO to the correct DLL before starting ProB. For Tcl/Tk 8.5 this is typically base-tcl8.5-thread-win32-x86_64.dll. You can either go to System -> Settings -> Advanced -> Environment Variables or use the setx command for this:

setx SP_TCL_DSO C:\Tcl\bin\base-tcl8.5-thread-win32-x86_64.dll

Tcl/Tk on Linux

On Linux you can typically install Tcl/Tk using sudo apt-get install tcl8.5 tk8.5.

On very recent Linux systems (such as Ubuntu 20.04) you may want to download (and compile) Tcl/Tk 8.5 or use packages from earlier releases.

On Linux OpenSuse (12.3) you may have to perform the following for ProB to work:

ln -s /usr/lib/libtk8.5.so /usr/lib/libtk8.5.so.0
ln -s /usr/lib/libtcl8.5.so /usr/lib/libtcl8.5.so.0

Also, some of the feature require the table extension, which can be installed like this:

sudo apt install tk-table

Finally, support for .png ANIMATION_IMG declarations requires the Img package:

sudo apt install libtk-img

Graphviz Requirements

If you wish to view various visualizations generated by ProB Tcl/Tk or probcli you will need GraphViz. ProB generates various graphs (state space, custom graph, machine hierarchy,...) as .dot files and then uses the command-line tool dot to layout the graph and convert it to PDF.

ProB Tcl/Tk can also use dot-file viewer such as the dotty program from GraphViz in Linux. On macOS and Windows it is more difficult to obtain a good viewer application for dot files. VS Code with the Graphviz Interactive Preview extension is a candidate. The commercial OmniGraffle macOS application can import .dot files. A free alternative on macOS may be graphviz-gui by MacPorts. To install the application do this

• sudo port install graphviz-gui

The viewer can now be found in /Applications/MacPorts/Graphviz.app (you may have to set the ProB graphical viewer preference dot_viewer to this path). If you do not manage to install a viewer, you should select Preferences -> Graphical Viewer -> PDF within ProB Tcl/Tk. Indeed, many ProB commands work directly with the command-line tool dot which you can install on macOS with MacPorts like this:

• sudo port install graphviz

On Mac you can now install the latest version of Graphviz using HomeBrew:

1. brew uninstall graphviz
2. brew install graphviz --with-gts
3. brew link --overwrite graphviz

Step 1. is optional; you only need to use it if you have a prior version of Graphviz installed. Step3 links the binaries to /usr/local/bin. This is probably better than using the older version from Pixelglow.

You can also manually set the DOT (path_to_dot) preference if ProB cannot find the Graphviz dot binary you have installed.

Short Release History

The full ProB release history can be found here.

2024-02-20 ProB 1.13.0 is available. Better Rodin theory support. Template strings. Unicode improvements. READ_JSON and other new external functions. VisB support for groups and "use" element. MCTS game play.

2024-02-03 ProB 1.12.2-fix1 is available.

2023-08-10 ProB 1.12.2 is available. VisB improvements.

2023-04-04 ProB 1.12.0 is available. Call stack infos, performance improvements in parser and solver, new LTL operators, VisB improvements, reals/floats for Rodin theories.

2021-12-29 ProB 1.11.1 is available. Highlights: identifiers between backquotes, flexible JSON trace replay, DPLLT solving command, improvements to Z3 backend.

2021-10-06 ProB 1.11.0 is available. Highlights: improved support for infinite sets, operation caching (OPERATION_REUSE), faster LTL checking for safety formulas, more compact .prob files, VisB HTML export, constructive Z3 translation.

2020-12-15 ProB 1.10.0 is available. Highlights: well-definedness prover, REAL datatype, -lint comand for VSCode and Atom, improved unsat core and error messages.

2020-02-19 ProB 1.9.3 is available. Highlights: performance improvements, new external functions, performance monitoring.

2019-11-11 ProB 1.9.2 is available. Minor bugfix release.

2019-11-08 ProB 1.9.1 is available. Maintenance release.

2019-07-12 ProB 1.9.0 is available. Highlights: improved error feedback, improved Unicode support, regular expression library, memoization.

2018-10-01 ProB 1.8.2 is available. Highlights: improved error feedback, support Jupyter kernel, first support for Alloy models.

2018-03-20 ProB 1.8.0 is available. Highlights: terminal colour support, performance improvements for displaying very large values, improved symmetry breaking and constraint solving.

2017-10-05 ProB 1.7.1 is available. Highlights: performance, non-deterministic assigned variables shown, Z improvements, export history to HTML.

2017-07-11 ProB 1.7.0 is available. Highlights: improved Latex document generation, improved XML/CSV data import and export, RULE DSL language, many improvements in constraint solver.

2016-10-20 ProB 1.6.1 is available. Highlights: Latex document generation, LET and IF-THEN-ELSE for expressions and predicates, XML logging, XML data import, performance improvements.

2016-04-22 ProB 1.6.0 is available. Highlights: directed model checking, Z3 available as backend, B line comments and unicode symbols, improved error messages, performance improvements.

2015-02-19 ProB 1.5.0 is available. Highlights: improved random enumeration, MACE/SEM style static symmetry reduction for deferred set elements, MC/DC coverage analysis for guards and invariants, improved TLC interface, bug fixes and improvements including but not limited to the constraint solver.

2014-08-29 ProB 1.4.1, a small bugfix-only release is available. For a list of new features in 1.4.0 see below.

2014-08-18 ProB 1.4.0 is available. Highlights: CLP(FD)-based constraint solver enabled by default, kernel can handle more operations symbolically, integration of the TLC model checker, bug fixes and performance improvements.

2013-03-04 ProB 1.3.6 is available. Highlights: improved constraint propagation for division, modulo, intervals, model checking progress bar, performance improvements, improved Kodkod backend and use within REPL, and many more.

2012-10-08 ProB 1.3.5 is available. Highlights: support for external and recursive functions, optional Kodkod backend, TLA+ support, performance improvements, pragmas, units inference, and many more.

2012-03-30 A first prototype of an online ProB Logic Calculator is available.

2011-11-21 ProB 1.3.4 is available. Highlights: Evaluation View and Eval window, CSP assertion checking, improved editor, 64-bit version for Mac and Linux, performance improvements, and many more.

2011-02-10 ProB 1.3.3 and ProB for Rodin 2.3 is available. Highlights: improved performance, constrained-based deadlock checking, record detection, and many more.

2010-07-30 ProB 1.3.2 is available. Highlights: improved performance, constraint solving over integers (enable in Advanced Preferences), much improved Z support, and many more.

2009-12-07 ProB 1.3.1 is available. Highlights: new data-structure for large sets and relations (see FM 2009), multi-level validation for Event-B, improved constraint propagation for boolean connectives, and many more.

2009-03-20 ProB 1.3.0 is available for download. Highlights: New parser and integrated typechecker, install as AtelierB plugin, improved kernel with support for large sets/relations, improved CSP support, faster LTL model checker, Undo/Redo in text editor, graphical formula viewer, user definable custom animations with gifs.