S. Hagopian November 8, 1991 Version 1.0 SAMDIS - SAMUS Event Display I. INTRODUCTION SAMDIS is the D0 Small Angle Muon System (SAMUS) event display. It is part of the PIXIE library, which can be run in various frameworks. Hooks are set up for PIXIE in D0USER and EXAMINE2. (See .DOCs) It displays module outlines, hits, and tracks in cut views, where a cross-section of the detector is displayed and hits and tracks from these modules are projected onto this plane. Not all tracks and hits are displayed in a cut view. Tracks are color-coded according to whether all their hits are from SAMUS, WAMUS or combined WAMUS+SAMUS. II. GETTING a SAMUS DISPLAY A. Program builder The package SAMDIS must be included in the package list to get the SAMUS event display. To get combined displays, including CAL and ZTRAKS as well as WAMUS and SAMUS, use the package ALL_DISPLAY_COMBINED. (The % indicates it is a combined package). B. LINK The normal D0USER link does not include the event display package. One needs to do: $@SAMUS_D0USER.LNK DI3000. Also, it is usually best to do a $LIBT PIXIE in order to pick up the latest event display routines and parameters. C. Setup for RUN 1. DI3000 logicals If the DI3000 logicals are not automatically setup, do $SETUP DI3000 or find out where DI3000 is stored on your node and execute DILOGIN.COM The sharable version of DI3000 should be requested by the command: $ DISETSHR EXT HI $SETDRV cod1 cod2 ! to setup the DI3000 device Drivers. The first driver should correspond to the type of terminal you are logged on to; the second one to a hardcopy device[ e.g. TLP ]. For more information see D0$DOCS:DI3000_GUIDE.DOC 2. PIXIE logicals. The event display needs a RCP file to define the views to be displayed and the interactive parameters which control them. For the SAMUS display, the file needed is D0$PIXIE:PX_SAMDIS.RCP. The corresponding logical is PX_SAMDIS_RCP. The user may redirect the RCP logicals to their own files. It also needs STP files to define the geometry. Logicals pointing to the default files are defined in the program builder file, SAMUS_USER.COM. If the user has included the package ALL_DISPLAY, the command file D0$D0USER:EVENT_DISPLAY.COM must also be executed. (This procedure does $SETDRV and sets up the STP files.) D. RUNNING 1. Running EXAMINE2 After "BEGIN PROCESSING" in EXAMINE2, choose menu item "EVENT DISPLAY" in the INTERRUPT menu. 2. Running D0USER. There are two ways to use event display. The first is to turn on the interactive menu and then, while analyzing events, do a DISPLAY EVENT. This will start at a random event. One can also turn on the automatic event display by doing EVENT DISPLAYS (7) before starting the run. It will ask how many events and their particular IDs (if -1 then assumes consecutive). III. SAMDIS MENU SUB_LEVEL: SAMUS Event Display PIXIE Select: {command, #, HELP (#), MENU, BACK} > help 1: YZ VIEW SAMUS 2: XY VIEW SAMUS 3: ZX VIEW SAMUS 4: YZ SAMUS N 5: XY N A SAMUS 6: XY N B SAMUS 7: XY N C SAMUS 8: ZX SAMUS N 9. YZ SAMUS S 10. XY S A SAMUS 11. XY S B SAMUS 12. XY S C SAMUS 13. ZX SAMUS S 14: NEXT Event 15: ZOOM 16: ROTATE 17: PICK 18: HARDCOPY 19: MODIFY 20: GO TO Event 21: Change Display Mode 22: Superimpose(On/Off) 23: Set Path 24: Dump Event 25: Write Event 26: Other Options 27: COMPACK System Menu For further information on menu items 14 - 27, see D0$PIXIE:PX_SYSTEM.DOC -------------------------------------------------------------------------------- *SAMDIS Menu Title * Function & Remark * -------------------------------------------------------------------------------- YZ VIEW SAMUS - Cross-section of SAMUS in Y-Z plane at X=0. (SAMUS SIDE VIEW). Hits and tracks that go thru these modules (and modules parallel to them) are projected onto this plane. (Not all hits and tracks are displayed) XY VIEW SAMUS - Cross-section of SAMUS in X-Y plane at Z=0. (SAMUS END VIEW). Hits and tracks that go thru these modules (and modules parallel to them) are projected onto this plane. (Not all hits and tracks are displayed) XZ VIEW SAMUS - Cross-section of SAMUS in X-Z plane at Y=0. (SAMUS TOP VIEW). Hits and tracks that go thru these modules (and modules parallel to them) are projected onto this plane. (Not all hits and tracks are displayed) YZ SAMUS N - North stations of SAMUS, Y-Z cut view Displays module outlines and hits in Y and U-V planes. XY N A SAMUS - North side of SAMUS, A station, X-Y cut view Displays module outlines and hits in the X,Y and U-V planes. XY N B SAMUS - North side of SAMUS, B station, X-Y cut view Displays module outlines and hits in the X,Y and U-V planes. XY N C SAMUS - North side of SAMUS, C station, X-Y cut view Displays module outlines and hits in the X,Y and U-V planes. ZX SAMUS N - North stations of SAMUS, Z-X cut view Displays module outlines and hits in X and U-V planes. YZ SAMUS S - South stations of SAMUS, Y-Z cut view Displays module outlines and hits in Y and U-V planes. XY S A SAMUS - South side of SAMUS, A station, X-Y cut view Displays module outlines and hits in the X,Y and U-V planes. XY S B SAMUS - South side of SAMUS, B station, X-Y cut view Displays module outlines and hits in the X,Y and U-V planes. XY S C SAMUS - South side of SAMUS, C station, X-Y cut view Displays module outlines and hits in the X,Y and U-V planes. ZX SAMUS S - South stations of SAMUS, Z-X cut view Displays module outlines and hits in X and U-V planes. IV. SAMDIS PARAMTERS in PX_SAMDIS.RCP: -------------------------------------------------------------------------------- * Parameter Name * Default[Type] * Remark * -------------------------------------------------------------------------------- 'SAMUS ONLY' .TRUE. ' SAMUS Only' 'SAMUS DRAW HITS' 1 '1 = DRAW HITS, 0 = NO HITS DRAWN' 'SAMUS DRAW TRACKS' 1 '1 = DRAW TRACKS, 0 = NO TRACKS' 'SAMUS HITS ON TKS' 1 '1 = DRAW HITS ON TRACKS, 0 = NO' 'SAMUS DRAW XY HITS' 1 '0=NO HITS,1= NO isol. hits,2=all XY hits' 'SAMUS DRAW UV HITS' 0 '0=NO HITS,1= NO isol. hits,2=all UV hits' 'SAMUS TRIG COUNTER' 0 '1 = ON, 0 = OFF ' 'SAMUS DRAW MAGNET' 0 '1 = DRAW MAGNET, 0 = NO MAGNET' 'SAMUS LABEL CHAM' 1 '1 = Label chambers, 0 = no labels' 'TRACK PTMIN' 1.0000 ' ' 'TRACK DPT' 5.0000 ' ' 'COSMIC RAY' FALSE ' ' 'MUON DRAW SAMUS' TRUE ' If FALSE, do not draw SAMUS hits or detector' V. SAMDIS SCREENS in PX_SAMDIS.RCP: Each basic menu has own screen parameters. Here we show an example, for the YZ cut. !--------------------------------------------------------- ! Definition of SAMDIS Screens !--------------------------------------------------------- 'NAME' 'YZ SAMUS N' 'YZ SAMUS N' 'PICKABLE' F 'Pickable switch' 'VIEW3D' .FALSE. ' True if eD viewport' 'KEEPCIRCLE' .TRUE. ' True if circles are kept' 'VPORTXMIN' -1.0000 ' X min Viewport' 'VPORTXMAX' 1.0000 ' X max Viewport' 'VPORTYMIN' -1.0000 ' Y min Viewport' 'VPORTYMAX' 1.0000 ' Y max Viewport' 'WINDOWXMIN' -1000.0000 ' X Min Window limit' 'WINDOWXMAX' 0.0000 ' X Max Window limit' 'WINDOWYMIN' -500.0000 ' Y Min Window limit' 'WINDOWYMAX' 500.0000 ' Y Max Window limit' 'VIEWREFX' 0.0000 ' X View reference pnt' 'VIEWREFY' 0.0000 ' Y View reference pnt' 'VIEWREFZ' 0.0000 ' Z View reference pnt' 'UPVECX' 0.0000 ' X Up vector' 'UPVECY' 1.0000 ' Y Up vector' 'UPVECZ' 0.0000 ' Z Up vector' 'CAMX' 0.0000 ' X Camera point' 'CAMY' 0.0000 ' Y Camera point' 'CAMZ' 1.0000 ' Z Camera point' VI. DOCUMENTATION 1. D0$DOCS:GRAPHICS_GUIDE.DOC - gives an introduction to D0 graphics and references to other documentation. 2. D0$DOCS:DI3000_GUIDE.DOC - gives an introduction to the use of the commercial graphics package, DI3000, and hints on using it on various devices. 3. D0$D0USER:D0USER_GUIDE.MEM - gives more than introduction to D0USER which provides an offline framework. 4. D0$EXAMINE2:EXAMINE_GUIDE.DOC - Users guide to EXAMINE, the ONLINE event monitoring framework. 5. D0$PIXIE:PIXIE_GUIDE.DOC - General guide to PIXIE Event Display