VeloView Offline GUI User Guide Outline Setting up a Remote Desktop (optional) Installation Starting the GUI Loading a Run Plot Actions Daniel Saunders
Setting up remote desktop (Skip if running locally) The offline Velo DQM GUI (VView) can be ran locally, or remotely. This slide outlines the latter case, using remote desktop, using lxplus and vnc as an example. For more info, see: https://twiki.cern.ch/twiki/bin/view/lhcb/remotelxplusconsolehowto Follow these steps: For first time only: If the directory ~/.vnc exists, empty it. Set your vnc password: [lxplusxxxx]$ vncpasswd Next copy over the server start-up file included in the VView directory and make it an executable: [lxplusxxxx]$ cp VView/xstartup ~/.vnc/ [lxplusxxxx]$ chmod a+x ~/.vnc/xstartup Start the vnc server from lxplus: [lxplusxxxx]$ vncserver New 'lxplusxxxx.cern.ch:7 (username)' desktop is lxplusxxxx.cern.ch:7 Note the display ID (7 in this case). Alternatively, start the server from the local machine terminal with: [localmachine]$ ssh username@lxplus.cern.ch vncserver
Setting up remote desktop (Skip if running locally) The server side on lxplus is now setup. From the local terminal, connect with: [localmachine]$ ssh username@lxplusxxxx.cern.ch -L580[devID]:localhost:580[devID] -L590[devID]:localhost:590[devID] (Replace the devid and XXXX as appropriate with that noted above, so in our case devid = 7, we do): [localmachine]$ ssh username@lxplus403.cern.ch -L5807:localhost:5807 -L5907:localhost:5907 We can now connect with a vnc viewer - there are many to choose from, see: https://twiki.cern.ch/twiki/bin/view/lhcb/remotelxplusconsolehowto The following example uses TigerVNC, which is suitable for macs and graphics performance (and easy install) Open TigerVNC, add the appropriate device ID, and click connect: daniel.saunders@cern.ch
Setting up remote desktop (Skip if running locally) Something similar to the following screen should pop-up: Continue as usual.
Installation VView uses Qt with QCustomPlot (latter included with VView). Requirements: Qt - Minimum version 4.8 (lower not tested) ROOT. To install with source files, from the VView directory (in any terminal), do: qmake make Note, on lxplus, qmake is located at: /afs/cern.ch/sw/lcg/external/qt/4.8.4/ x86_64-slc6-gcc48-opt/bin/qmake Dummy run (from remote desktop terminal if not running locally):./vview 4 Figure 1: VView in dummy configuration (fake data)
Starting the GUI To launch the GUI for a normal Velo Run, do:./vview Figure 2: Initial GUI screen for Velo Run
Loading a Run The available runs to load are displayed in this drop down box (retrieved from the analysis framework). Note: autocomplete is enabled - if a run appears unavailable, try emptying the box via the keyboard. Click load to open this run. Runs can also be reloaded via this method. Corresponding graphs are retrieved and viewed upon request from the user. Figure 2: Initial GUI screen for Velo Run
Plot Actions The VView graphs offer many new features compared to standard (eg ROOT) plots. Zoom and Panning The plot can be panned by hold click and dragging. There are two zoom methods: the mouse wheel can zoom in on an area, or just along one axes if it is highlighted blue (click on the ticks). Alternatively, right click to drag an area over the plot to zoom into. daniel.saunders@cern.ch
Plot Actions The module selector is used to inspect graphs that are related to a particular module. The Plot Options box on the left gives the available options to the currently selected plot (marked by the black border). The log check boxes can be used to switch between a linear and log scale for any axis. The currently selected can be shown separately in a pop-out window. The refresh button will re-draw the graph using default options. Statistics are shown for the currently selected plot.