What is d0ve_alldis?

Welcome aboard! d0ve_alldis is a control package for the DZero Detector Subsystems Event Display using the visualization package d0ve: D0 Visualization Environment. d0ve_alldis builds two binary files, d0ve_x for a current online event display in the control room and d0ve_lite for handy event scanning. To run these programs, you definitely need the D0RunII environment. It means that "% setup D0RunII pXX.XX.XX" command should work correctly for you [Recommendable pXX.XX.XX is p20.13.00 for run2b data].

Subsystems

• d0ve_caldis is a calorimeter system event display which draws energy deposited cells in 3D and creates a lego plot in eta-phi space.
• d0ve_muon is a muon system event display that can draw PDT and MDT modules with their hits, segments and (tracks).
• d0ve_cft is a central fiber tracker event display that handles fired axial fibers in both 2-D(XYview only) and 3-D views.
• d0ve_smt is a silicon tracker event display which shows barrels( as a ladder ) and disks with hits and draw selected(by CID: 401=global, 230=smt only, 101=cft only, 113=cft axial only and 10401=ElasticTrack) tracks.
• [Following four packages are beyond the d0ve_alldis.]
• d0ve_reco is a reconstructed physics object display and is not included.
• d0ve_vertex is a reconstructed vertices display and is not included.
• d0ve_l3 is a reconstructed L3 objects display and is used as one of L3 tools.
• d0ve_smt_detail is the full SMT strips display and is running in the control room for SMT shifters as an independent tool from d0ve_x.

How to run d0ve_lite/d0ve_x and Run Controls

d0ve_alldis has three control rcp files.

• d0ve_for_reco.rcp is for d0reco's output file as your input file when you run d0ve_lite. This is a default rcp file.

GO TO your working directory, then type "% d0setwa"

% d0ve_lite -TMB( for thumbnail file or -DST) -input_file your_input_file_name

• d0ve_for_raw.rcp is for the raw data file as your input file when you run d0ve_x. Since we recommend to process the raw data by the official d0reco, d0ve_x will not be saved in the release area anymore. Please try d0reco -> d0ve_lite chain instead of d0ve_x.

% newrel -t p00.00.00 your_work_dir [You need to do "% setup D0RunII p00.00.00" before this step, if you haven't already. If you want to build d0ve_x with maxopt libraries, you need to type "% srt_setup SRT_QUAL=maxopt" before "% gmake".]

% cd your_work_dir

% addpkg d0ve_alldis [You need to do "% setup d0cvs" before this step, if you haven't already.]

EDIT the file, d0ve_alldis/SUBDIR to change the line "#bin" to "bin", then

% gmake d0ve_alldis.all

% d0setwa

% cd d0ve_alldis/bin

% d0ve_x -raw -input_file your_input_file_name

• d0ve_for_daq.rcp is for also the raw data from the distributor which is running on one of d0online nodes. This is currently running on the "d0ol113" in the control room.

Have you ever seen the event?

This is a quad view in 3D windows. Keystroke 0(zero) toggles single/quad view. Muon segments are Matched BC segment(green) and Single, one layer segment(blue). And some typical 3D views.

d0ve_alldis application showing a MenuBar on the top of 3D window.

Basic d0ve_alldis Windows

This is a X-Y view up to CFT in the 3D window which has a MenuBar on the header.

XYview: SMT barrel hits(red), disk hits(green) and CFT axial fibers(red) are presented. In the CAL Energy(E)/Transverse Energy(ET) histogram, the red portion is for EM and the blue is for HAD energy.The E or ET scale is shown at upper-left corner of the window and the Eta selection for the CAL E/ET histogram is shown in the bottom-left corner. Muon segments are drawn by the following definitions. A box shape is for a PDT and a diamond is for an MDT. Colors are red(A-layer), orange(B-layer like) and green(C-layer like).

RZview: Both barrel(red) and disk(green) SMT hits are projected onto a R-Z plane. Color definitions in the CAL E/ET histogram, red for EM and blue for HAD are same as the XYview. Phi selection for the CAL E/ET histogram is shown in the bottom-left corner. The definitions for Muon segments are same as the XYview except for the MDT shape, which is now a box.

Legoplot: Calorimeter eta-phi space legoplot. The Lego hight is E/ET. Red corresponds to EM, blue is for HAD and the yellow lego shows Missing ET.

TriggerNames: This window shows trigger names. Default window is set to LegoPlot in TriggerDisplay.rcp of d0ve_alldis/rcp.

Basic Menus of d0ve_alldis

d0ve's SYSTEM Menus are File, EventLoop and Display. We describe them here step by step.

File is for File I/O, Print and Exit controls.

In the File menu,

• Open reco file... allows you to pick an input file without exiting the program.
• set print interval... selects events to create image files by all (separate files) of PS print submenu. If you set the number to 4, then the 4th, 8th, 12th ... event pictures are will be saved.
• PS print allows a user to save postscript files. "all" means 3Dview, LegoPlot, RZview and XYview so far.
• Exit is just to quit the program. You can also exit from the program by typing "Q" then "Enter/Return" key.

EventLoop is for event processing controls.

The EventLoop menu has:

• Start/Resume(cr) is to begin the event loop for scanning events.
• pause/step(space) is for interactively reading events. By typing "space" key, you can go to next event.
• set pause interval... allows a user to pause for a given time in second during the event loop mode.
• Set skip number... defines the number of events to be skipped.
• Edit CollisionID Listcan be used to interface io_packages via a run number and an event number in which you want to scan a specific event.

Display is for drawing parameter controls.

The Display menu has:

• axes is to display the axes.
• Reference point is to display the coordinates of the reference point. Default is off.
• Scale displays a scale bar. Default is off.
• Set ref. pt... brings up a dialog box to set the reference point.
• Set magnification... brings up a dialog box to set the magnification factor.
• System submenu has:
• 3D Enabled toggle to enable/disable the 3D display.
• 2D Enabled toggle to enable/disable the 2D display.
• clear issue a "clear" to all DisplayReps.
• update issue an "update" to all DisplayReps.
• Dump to ... save the current screen contents to a postscript file, "all.ps".
• Print instructions write the list of keystroke controls to the standard output.

DZERO is for subsystem controls.

The DZERO menu has:

• CAL is to control d0ve_caldis display.
• MUON is for d0ve_muon display.
• CFT is for d0ve_cft display.
• SMT is for d0ve_smt display.

CAL is for the Calorimeter Display(d0ve_caldis) controls.

The CAL menu has:

• 3-d threshold enabled toggle to enable/disable an energy threshold for calorimeter cells("3D hits" in this menu) setting by set threshold... menu.
• set threshold... brings up a dialog box to set the 3D hits'(CAL cells') energy threshold.
• 3D hits toggle to enable/disable drawing the calorimeter cells. A red cell belongs to the EM modules and a blue one is in the HAD modules.
• 2d threshold enabled toggle to enable/disable an energy threshold for calorimeter eta-phi space towers setting by set 2d threshold... menu.
• set 2d threshold... brings up a dialog box to set the CAL Towers' energy/Et threshold.
• convert to ET toggle to E/ET.
• set Lego E Scale... brings up a dialog box to set the Energy/Et scale for the Legoplot.
• Set Lego orientation... brings up a dialog box to set the viewpoint by angles.
• Lego Autoscale enabled toggle to enable/disable the autoscale. When it is disabled, Legoplot picks an E/Et scale of set Lego E Scale... menu.
• Lego stats enabled toggle to do visible/invisible statistics.
• LegoPlot toggle to enable/disable the LegoPlot.
• set eta limits... brings up a dialog box to set the eta region selection on the CAL XY view.
• XY view toggle to enable/disable the CAL XY view.
• set phi limits... brings up a dialog box to set the eta region selection on the CAL RZ view.
• RZ view toggle to enable/disable the CAL RZ view.

MUON is for the Muon system Display(d0ve_muon) controls.

The MUON menu has:

• geometry (See below.)
• Monte Carlo toggle to enable/disable MC data.
• Reconstructed hits toggle to enable/disable PDT, MDT and MSC hits.
• Reconstructed segments to enable/disable PDT and MDT segments.
• MuSeg RZ view is for 2-D window.
• MuSeg XY view is for 2-D window.

Its geometry menu can be used to enable/disable "Cosmic Caps", "WMSC", "FAMUS(MDT)", "WAMUS(PDT)" and "Pixels".

CFT is for the Central Fiber Tracker Display(d0ve_cft) controls.

The CFT menu has:

• geometry (See below.)
• Fibers toggle to enable/disable axial fibers.
• Axial fibers XY view

Its geometry menu can be used to enable/disable CFT's Layer 1 through 8(Doublet 1 through 16).

SMT is for the Silicon Tracker Display(d0ve_smt) controls.

The SMT menu has:

• geometry (See below.)
• MC Hits toggle to enable/disable MC hits.
• Barrel Hits toggle to enable/disable barrel hits.
• Disk Hits toggle to enable/disable disk hits.
• Tracks toggle to enable/disable tracks(GTrack with CID=401).
• tracks RZ view 2-D.
• tracks XY view 2-D.
• BHits XY view 2-D.
• BHits RZ view 2-D.
• DHits XY view 2-D.
• DHits RZ view 2-D.

Its geometry menu can be used to enable/disable "Barrels", "F Disks", "H Disks" and "Barrel Circles".

Installation

d0ve_alldis can be built in your working area under D0RunII environment. Consult the following links.

---

Link

• What is d0ve?
  
• How to build d0ve_x