TaurusGui is not a GUI in itself but a framework for building Taurus graphical user interfaces in an efficient way (but not all Taurus-based applications are necessarily TaurusGui-based).
A specific TaurusGui-based application is defined in a “configuration directory” which is read by TaurusGui to construct the specific GUI.
From the user perspective the only important thing is that, while different TaurusGui-based applications may be very different, they all share some features and have a common look-and-feel. This document describes these common features. For documentation on specific aspects of a given TaurusGui-based application, please refer to the documentation of that application.
Normally you will be launching a specific GUI built on top of TaurusGUI (as opposed to launching TaurusGUI directly), so you should refer to the specific instructions for launching that GUI.
Still, you may want to launch TaurusGui directly for debugging an specific application or for creating a new GUI from scratch. For this, use the following command:
-h, --help show this help message and exit --config-dir=CONFIG_DIR use the given configuration directory for initialization --new-gui launch a wizard for creating a new TaurusGUI application --version show program's version number and exit Taurus Options: Basic options present in any taurus application --taurus-log-level=LEVEL taurus log level. Allowed values are (case insensitive): critical, error, warning/warn, info, debug, trace --taurus-polling-period=MILLISEC taurus global polling period in milliseconds --taurus-serialization-mode=SERIAL taurus serialization mode. Allowed values are (case insensitive): serial, concurrent (default) --tango-host=TANGO_HOST Tango host name
TaurusGui-based applications consist in a main window containing a number of panels.
You can re-arrange the panels by moving and resizing them in the window, or hide/show them or leave some of them floating as independent dialogs. You can even add new panels to the application “on-the-fly”, selecting them from a catalog of available widgets.
This is because a key feature of TaurusGui applications is that you can adapt them to your needs. But since your needs are not always the same, the TaurusGui- based applications allow you to save the panel arrangement and other user modifiable choices as a perspective. You can then easily switch to different application configurations.
Another characteristic element of Taurus-Gui based applications is the Applets area on the right side of the main window. This area is typically populated with small widgets providing quick access to some relevant information or control. It also contains the the logo of the institute (or some other general logo) and the logo of the application.
Other common components of TaurusGui-based applications (although not necessarily present) are:
In order to prevent accidental rearranging of panels, the view can be locked, which will disable the drag and drop of panels. You can lock/unlock the view from the View Menu
Panels can be moved around by dragging them from their title bar. When dropping a panel, you can choose whether to push other panels to make room for the new one, or to drop it on top of an existing panel (this will “tabify” the panels) or to leave it floating outside of the main window.
You can also modify the dimensions of a panel without changing its position: just drag the boundaries between panels.
If the view has not been locked, the title bar of each panel contains 2 buttons: one for switching from floating to docked state and another for hiding the panel. Hidden panels are not shown, but are still available in the application. You can show them again by using the View->Panels menu.
Also, some panels may be connected to a synoptic panel and will be shown (if hidden) when selecting a certain element in the synoptic. Refer to the Synoptic Panels section for more details.
If, for some reason, you changed the panels too much and would like to revert the changes, you can always load a previously saved perspective.
Typically, a TaurusGui-based application will come out-of-the-box with one or more pre-defined panels providing the application functionality. But you may want to extend the application by adding custom panels to provide more features (e.g., to add an extra plot panel, or a new form).
You can add a new panel by clicking in the “New Panel” button of the main tool bar (or selecting View->Panel->New Panel...). This will open a dialog offering a catalog of different panel types and options for your new panel. Once accepted, the new panel will appear floating, ready to be docked to the main window.
A common use case is creating a new form panel (empty) and then fill it by dropping elements from other existing forms in order to group together controls that are scattered over several panels
When you close the application (or when you save a perspective), a dialog will be shown if you have created any custom panels. In this dialog you can choose which of the custom panels you want to keep for future use and which are only meant for the current session.
You can also open this dialog from the Tools->Select panel Configuration option.
if you want to remove a custom panel from an application, just hide it and use the Select panel Configuration option for making it “temporary” so that it is not stored for future sessions.
Different tasks often require different application layouts and different control widgets to be at hand (e.g., casual use VS expert use, or equipment calibration VS equipment operation). TaurusGui-based applications typically provide a set of pre-defined perspectives which are just configurations that can be loaded at any moment to set a given panel arrangement suited for a given task.
All TaurusGui based applications provide a Perspectives Toolbar (if it is not shown, you can enable it from View->Toolbars, or you can access its functionalities from the View menu).
Switching to another perspective can be done using the Load perspectives drop- down button in the perspectives toolbar (or using the View->Load perspective option).
Apart from the pre-defined perspectives, you can always alter the panel re- arrange panels and store your preferred arrangement as a perspective using the Save perspective button in the perspectives toolbar (or using the View->Save perspective option).
If you want to backup your current perspectives, or you want to use some perspectives you created in one computer to another computer (or another user of the same computer) you can do so by using the File->Export Settings option. Similarly, use the File->Import Settings option to update the application perspectives with those contained in the imported file.
An special type of panel present in some TaurusGui-based applications is the Synoptics. Synoptics panels are typically used for providing a visual representation of the hardware that is controlled by the GUI. Some elements or areas of the synoptic panel may be active, meaning that they can be selected with the mouse.
A default feature of the TaurusGUI framework is that active elements of synoptic panels whose name matches that of an existing panel of the application will cause that panel to be shown (and conversely, if the panel is selected, the element in the synoptic will be highlighted). This is very useful because synoptic panels can be used as a sort of quick index or browser to navigate in panel-crowded applications.
Also note that you can find a button in the application toolbar for showing/hiding each synoptic panel.
Many TaurusGui-based applications are used to interact with a Sardana Pool and MacroServer in order to run macros (e.g. scans). In these cases several macro- related panels will be available:
You can run taurusgui macrogui for seeing an example of a TaurusGUI- based application that provides the aforementioned panels
In most specific GUIs the macroserver and door name to use are pre-configured and the user does not need to change them. Sometimes though, you may want to alter it. You can do so by using the Tools->Macro execution configuration option.
Some TaurusGui-based GUIs may also use information provided by the Pool Device Server about the Control System to automatically create TaurusForm panels containing all the controls related to the various instruments to be controlled by the GUI. An important characteristic is that, since these so-called instrument panels are created dynamically when launching the application, their number and/or contents may vary ,reflecting changes in the pool configuration.
Taurus includes examples of TaurusGUI-based applications for demonstration purposes.
|GUI name||launch command||Comment|
|example01||taurusgui example01||Included in Taurus (<taurus>/qt/qtgui/taurusgui/conf/tgconf_example01)|
|Macrogui||taurusgui macrogui||Included in Taurus (<taurus>/qt/qtgui/taurusgui/conf/tgconf_macrogui)|
|Alba’s beam lines control GUIs||ctblxx (xx is the beamline number)||Internal ALBA development|