Main Widget

pyspMonitor3.py listens to a Sardana Door and automatically displays the 0D and 1D data. The Door delivers data when Macros are executed on the MacroServer, invoked from spock or by executing runMacro on a Door. The program is launched by:

$ pyspMonitor3.py

Figure 4.1 shows the main widget. The checkbox in front of the GQE names control whether the GQEs are displayed.

Figure 4.1: pyspMonitor3.py, main widget

Figure 4.1 shows a typical graphical output displaying 0D and 1D data. It uses pyqtgraph, allowing you to zoom-in and so.

Figure 4.2: pyspMonitor3.py, graphics

In addition to the display functionality, pyspMonitor3.py can be used for other tasks. The following list is not complete.

• Move motors: if a single GQE, which was created by a Sardana scan, is displayed the mouse can be used to move motors.
• mvsa (move-scan-analysis): the macro is executed, the GQE related to SignalCounter is displayed and a green arrow is displayed to mark the peak position. This happens before the user is prompted to move to the peak.
• Launch a cursor widget, see 4.2.
• Mesh scans: a MeshImage is filled with SignalCounter readings, see 4.3.
• Launch tools: Nxselector (define the measurement group), jive, astor, TngGui, PyMCA, SardanaMacroExecutor.
• Create .pdf files and print them.
• Inspect macros, see 4.4.
• Inspect errors in log files, see 4.5.
• Inspect log files using LogFiles pop-up menu.
• The program may also receive data and commands sent from the user via toPyspMonitor(). In fact, this function feeds all connected monitors. They are stored in the Macroserver environment variable RegisteredPyspMonitors. Notice that the Monitor-Door connections do not function across Debian-9, Debian-10 boundaries. See 7.2.
• The examples pop-up menu demonstrates various PySpectra features, with or without pyspMonitor. The related code can be viewed.

$ pyspMonitor3.py 

$ pyspMonitor3.py --help
usage: pyspMonitor3.py [-h] [-d DOORNAME] [-m] [-n] [-p ZMQPORT]
                      [--fs FONTSIZE]

PySpectra Sardana Monitor

optional arguments:
  -h, --help     show this help message and exit
  -d DOORNAME    name of a door, e.g.: pyspMonitor3.py -d p99/door/haspp99.01
  -m             graphics from matplotlib, def.: pyqtgraph
  -n             do not receive data from a door, instead toPyspMonitor() is
                 used
  -p ZMQPORT     zmq port for toPyspMonitor(), def.: 7779
  --fs FONTSIZE  font size

Examples:
 pyspMonitor3.py 
   the default command

 pyspMonitor3.py -p 7780
   if the default zmq port (7779) is already used

 pyspMonitor3.py -d p99/door/haspp99.02
   connect to a specific door

 export TANGO_HOST=haspp77:10000 && pyspMonitor3.py -d p77/door/haspp77.01 
   imports data from a door running on another TANGO_HOST 

 pyspMonitor3.py -d firstDoor 
 pyspMonitor3.py -d secondDoor 
 pyspMonitor3.py -d thirdDoor