v1.5 Latest version: v16r2 Panoramix: Interactive Data Visualization for LHCb Author: Guy Barrand (Framework) + contribution from many individuals

Transcription

1 v1.5 from a physicist Panoramix: Interactive Data Visualization for LHCb Author: Guy Barrand (Framework) + contribution from many individuals lhcb-panoramix@cern.ch Web page: Getting started Environment, run, local installation, option file Basic Menus and Commands Detector tree, Event tree Predefined views Controlling and Customizing Panoramix OnX menus Callbacks Python scripts More Useful Things Latest version: v16r2

2 Setup the environment: Getting started I using an already existing Panoramix installation This part only for local installations: linux: source $MYSITEROOT/scripts/ExtCMT.csh windows: call %MYSITEROOT%\scripts\ExtCMT.bat SetupProject Panoramix v16r1 Specify your use case : python $mypanoramix -h

3 Getting started II using an already existing Panoramix installation Example python $mypanoramix -f /afs/cern.ch/lhcb/group/tracking/vol1/bsjpsiphi_ _ _5.dst The last configuration is stored in last_settings.py. Can be directly used for another session or edited and changed: python $mypanoramix -c last_settings.py MDF files are also supported by checking the file type, raw or mdf.

4 Panoramix Configuration Tasks Default LHCb configuration Visualization Input data set Options for your specific use case Read DST, raw data decoding, unpack MC Read DIGI, run full reconstruction Read DST, run HLT Read DST, run your favourite Physics selections No input file, only detector visualization

5 Making your local Panoramix installation It is recommended to run on your local machine for speed reasons, although at CERN it is not so bad anymore running on lxplus. Use install script, Requires following environment variables to be set: Installation: $MYSITEROOT: full path to the top level directory of this installation e.g. C:\LHCb_Software $CMTCONFIG: binary directory name e.g. win32_vc71_dbg or slc4_ia32_gcc34 Copy install_project.py to $MYSITEROOT Run: python install_project.py p Panoramix v v16r1 b Have a coffee

6 Basic Menus Detector Tree Some useful buttons Event Tree OnX data accessor Special Views Printout

7 Detector Tree Useful for quick overview of detector geometry, material inventory, XML debugging,

8 Basic Operations Viewing mode Picking mode Rotation wheels Zoom wheel Free Rotation: Left mouse Translation: Ctrl + left mouse

9 Basic Operations II Picking mode Right mouse button Viewing mode Home Set Home View All: Map to window size Torch or Seek: ask for picking and center the scene over a picked point orthographic to perspective

10 Opening and Closing Opening volumes: ctrl/pick Closing volumes: shift/pick Picking mode

11 Opening and Closing II Opening volumes: ctrl/pick Closing volumes: shift/pick Picking mode

12 Deleting Picking mode 2. Deleting selected objects or all the rest 1. Selecting objects with left mouse click

13 Deleting II

14 Online Mode When running at the Pit and receiving events from the data manager, the Panoramix GUI is configured to show only the most important menus: All other menus are hidden behind Panoramix menus

15 Reading Events Single event Stop loop Loop over events Fast Stop of Panoramix After Panoramix is started, first event is read by clicking on single event arrow. (In online mode, this is done automatically.) If the current view is known to Panoramix, the next event will be displayed with the same view. Views are created by Python scripts and can be registered in a Python dictionary.

16 Reading Events II Direct jump to a given event, via event and run (optional) number. Rewind file, back to first event. Write current event to disk.

17 Event Tree Useful for quick overview of transient event store Whatever has a converter is displayed Otherwise, attempt is made to print information (next page)

18 Event Tree II Useful for quick overview of transient event store Whatever has a converter is displayed Otherwise, attempt is made to print information

19 Event Tree III Decoding of all raw data and unpacking of MC Particles only on demand

20 Detector Tree Access to Geometry (logical volumes) and Structure (physical volumes). Objects in the structure tree are displayed in the LHCb global coordinate system, whereas objects in the geometry tree are displayed in their local coordinate system.

21 Conditions Access to Conditions. The print method of the object is called.

22 Conditions II Access to Conditions. The print method of the object is called.

23 Material Information about Materials.

24 Properties of Objects Pick mode By clicking on displayed objects, their properties are printed. Properties are defined in SoEvent, Types.cpp Output format controlled by session().setparameter('accessormanager.dumpmode', 'raw/table') or via Scene/Dump mode raw/table

25 Colours With Qt: $mypanoramix --qt

26 OnX data accessor

27 New Page

28 New Page II Clone Viewer_1: Standard 3d page New Plane page: Only translations and zoom, no rotations

29 Pages and Regions Create two regions on one page Switch from one region to another: Change to picking mode Use left and right mouse key

30 Root Histograms 1 st step: Initialize 2 nd step: New canvas 3 rd step: Plot histogram With right mouse click, access to all ROOT gadgets

31 Printout GL2PS gives best quality JPEG for smaller files

32 Saving 3d files Currently supported iv, hiv: Inventor file, can be read back by Panoramix wrl: VRML file, can be viewed using external viewers, see htm

33 Predefined Views: Detectors

34 Predefined Views: Detectors II

35 MC Particle Viewer Select Decay Use predefined color coding of MCParticles Explains all

36 MC Particle Viewer II zx projection, z-axis scaled by 1:8

37 Ruler and Frame Not yet perfect, but better than nothing

38 Track Viewer

39 Track Viewer II Only works with track reconstruction on: #include "$PANORAMIXROOT/options/PanoramixFullRec.opts" Explains all

40 Calo Viewer Explains all

41 Rich Photons 1st step 2nd step Only works with track reconstruction on: #include "$PANORAMIXROOT/options/PanoramixFullRec.opts"

42 Rich Rings Only works with track reconstruction on: #include "$PANORAMIXROOT/options/PanoramixFullRec.opts"

43 Velo RZ Projection RZ projection: R = sqrt(x 2 + y 2 ), x>0 R = -sqrt(x 2 + y 2 ), x<0 Scale: R:Z = 1:8.4 Tracks crossing VELO halves might look strange, however less busy plot compared to +RZ projection Projection only makes sense around VELO R-strips points Phi-strips vertical lines Selected MCParticles can be displayed in 3d with corresponding detector hits and reconstructed track(s)

44 Velo RZ Projection II

45 Velo RZ Projection III

46

47 Colour codings Vertices: Production vertex: Interaction vertex: MCParticles: e,u,,k,p from B : red Other particles associated to tracks : golden

48 Colour codings VELO clusters: Used R-clusters : red Unused R-clusters : white Phi clusters: magenta Tracks: VELO back VELO back : green yellow VELO VELO-TT : green : cyan VELO Velo-TT Forward Match Forward : blue Match : skyblue

49 Background Color Using python: Region().setBackgroundolor(,aColor) # acolor could be a common name like 'red', 'blue', etc... # or a string with RGBS, for example '1 1 0' for a yellow.

50 Details about the Display of Mcparticles and Tracks MCParticles: Production vertex inside Velo and decay vertex outside VELO: Straight line defined by momentum vector Production vertex outside Velo and decay vertex outside VELO: Straight line connecting production vertex and decay vertices Production vertex inside Velo and decay vertex inside VELO: Straight line connecting production vertex and decay vertex Tracks: Use of parabolic extrapolator if states with momentum information available, otherwise straight line between states

51 Associations Select objects, right mouse click in picking mode

52 Event Information

53 Primary Vertex Information

54 Trigger Information Needs to be extended for the HLT-Alley summaries

55 Particle Information

56 Online Views Support for viewing and searching cosmics in the muon stations and calorimeter

57 Controlling and Customizing Panoramix

58 Defining your menus and buttons OnX scripts \scripts\onx\panoramix.onx \Examples\Python\Examples.onx

59 Defining your menus and buttons II Starting Python scripts \Examples\Python\Examples_detviews.onx Starting cpp code \scripts\rich.onx will trigger void RICH_Digits_Rings in Rich.cpp in Panoramix\src

60 Object Properties Properties of a Panoramix object XXX are usually defined in XXXType.h and XXXType.cpp. Most of the definitions are in SoEvent, SoCalo, SoRich and SoDet. These properties are printed by clicking on an object and can also be used for filtering. Example: TrackType.cpp in SoEvent: Clicking on a track object:

61 Object Properties II Filter objects for display: cpp Python

62 Python Scripts Three ways of operating: 1. Python prompt Exit Panoramix: >>> Back to Panoramix by typing >>> toui() 2. Menu button Triggered by OnX script from a menu button, see page Panoramix command line Enter script name x( your script.py ) Execute any script

63 Panoramixmodule, basics from panoramixmodule import * toui(): ui(): da(): session(): return to gui access to OnX access to OnX access to session parameters Page(), Region() : access to page and region for modifying their attributes Camera(): control camera settings Object_visualize(anyObject): visualizes any displayable object in the current page ui().synchronize(): synchronize display with recent changes Style(): Onx: HEPVis: control style settings OnX module coin module

64 Panoramixmodule, Style Style() settextsize(avalue), showtext(), hidetext() setcolor(astring), setrgb(r,g,b) setlinewidth(avalue) setmarkersize(avalue), setmarkerstyle() dontusevissvc(): overwrite default visualization attributes usevissvc(): use default visualization attributes setopened(), setclosed(), settransparency() setwireframe(), setsolid()

65 Panoramixmodule, Parameters session() session().availableparameters() session().setparameter(aparameter,avalue) session(). parametervalue(aparameter)

66 Panoramixmodule, data manipulation adata = MCParticle, Track, da().collect(adata,cuts) da().filter(adata,filters) da().dump() da().values(aparameter): properties of the adata object da().visualize()

67 Panoramixmodule, Camera Camera() lookat(x,y,z) pointat(x,y,z) setheight(height) setnearfar(near,far) setorientation(x,y,z,phi) setposition(x,y,z)

68 Panoramixmodule, Gaudi related appmgr: det : evt: sel: partsvc: toolsvc: rootsvc: application manager detector service event service event selector particle service tool service display of AIDA histograms with ROOT linkedfrom and linkedto: Linker relations doxygen(anyobject): open webbrowser of doxygen page nodes(adatasvc,force,<leave>) : Get list of nodes from data service (det or evt), force=true, force to read all leaves, <leave> optional start if not root.

69 Associations in Panoramix Plot xxx associated with yyy session.setparameter('modeling.what', 'xxx') data_collect('yyy',filter) data_visualize() session.setparameter('modeling.what','no') Example: Plot long tracks with pt > 1 GeV/c and their clusters

70 Other Python Examples x('truf_recpart_o')

71 Other Python Examples Most predefined views are made by Python scripts Event MC Particle Viewer Track Viewer Calo Viewer Examples

72 Another Example sys_import('truf_richhpd') sys_import( truf_richrec ) Taken from layouts.cpp, made by Chris Jones

73 Algorithms Useful for finding out properties of the algorithms used in your program.

74 Using $mypanoramix script: Panoramix Online If input file is specified with extension mdf/raw, the right options for mdf files are used If input file == online, then events are read from buffer manager

75 End