View source for ProB2-UI

'''ProB2-UI''' is the new Java-based user interface for ProB. __NOTOC__

== Download ==

* The latest stable version and current snapshots of this new UI  [[Download#ProB2_UI_using_Java_FX|are available for download]]; see also the [[ProB2UI Release History|release history]].
* The sources are available at [https://gitlab.cs.uni-duesseldorf.de/stups/prob/prob2_ui https://gitlab.cs.uni-duesseldorf.de/stups/prob/prob2_ui] which are mirrored to [https://github.com/hhu-stups/prob2_ui https://github.com/hhu-stups/prob2_ui]. You can also start the application from source using the Gradle run task (./gradlew run on Linux/macOS/etc., gradlew.bat --exclude-task createHelp run on Windows).

== Features ==

Compared to the original UI based on Tcl/Tk, this new UI has some unique new features:
* Visualisation of models using the SVG-based plugin VisB
* Projects which store formal models and ProB preferences
* Managing and storing multiple trace files for a model, being able to replay all traces
* MC/DC test-case generation
* An integrated view for all dot-based graph visualisations (state space, machine hierarchy, formulas, projection diagrams, enabling graphs, event refinement hierarchy, ....)
* An integrated view to access all table based statistics (event coverage, MC/DC coverage, read-write matrices, WD POs, ...)
* Visualization based on SVG graphics
* A view for managing LTL formulas for a model
* Load Rodin models from Rodin workspaces (without having to export them within Rodin)
* A multi-language interface, currently providing English, French, German and Russian

== The ProB2-UI Main Window ==


By default the main window is split into three vertical panes (see below).

* In the left pane, the Operations view , showing the operations whose preconditions and guards are true in this state (the view also uses a blue circular arrow icon when an operation does not change the state);
* In the middle the State View, containing the current state of the B machine, listing e.g., the current values of the machine variables;
* In the right pane there are a variety of subviews, which can be activated:
** [[History_View|The History of operations leading to this state (History)]]
** [[Project_View|The Project view]]
** [[Verification_View|The Verification view]]
** [[Statistics_View|The Statistics view]]

[[File:ProB2JavaFX_UI_Overview_New.png||1000px]]

== The ProB2-UI Main Menu Bar ==
The menu bar contains the various commands to access the features of ProB. It includes the menus
*File,
*Edit,
*Formula,
*Consoles,
*Perspectives,
*View,
*Window and
*Help
[[File:File.png|none]]
The File submenu allows you to create a new Project, open an existing project or a machine, open recent projects shown as list and/or clear the list of recent projects, close the ProB2-UI, save your project or reload the currently running machine.
[[File:Edit.png|none]]
The Edit submenu provides two ways to edit the current machine (either in the editor provided by the ProB2-UI or in the your operating systems standard editor) and allows to edit your general and global preferences by opening a seperate window.
[[File:Formula.png|none]]
Here you can add formulas for visualization and open the history chart window.
[[File:Consoles.png|none]]
This submenu leads to two consoles, one Groovy, one B.
[[File:Perspectives.png|none]]
The Perspectives submenu allows you to change the appearance of the main view. The default view is shown at the top and two additional perspectives (Seperated History and Seperated History and Statistics) are preset. By ''Detach Components'' the view can be shown in seperate windows. ''Load'' allows you to make your own perspective by providing an FXML file containing the views but be aware that this might ruin the ability to detach components.
[[File:View.png|none]]
This submenu allows you to adjust font and button size in the ProB2-UI.
[[File:Help.png|none]]
The Help submenu provides you with help about the ProB2-UI, information about the ProB2 UI, ProB2 kernel, ProB CLI and Java version used here and a way to report issues regarding the ProB2-UI.