S. Blessing
                                                               S. Hagopian
                                                               November 12, 1991
                                                               Version 1.0

                         CD_ELECTRONICSDIS  
                  
                 Event Display FOR CD Electronics      


 I. INTRODUCTION

      CD_ELECTRONICSDIS is the event display for Central Detector electronics.
    It is part of the PIXIE library and used in the D0 ONLINE program,
    EXAMINE2. It displays FADC traces and their fourier transforms.


II. GETTING a CD ELECTRONICS DISPLAY

 A. Making an .EXE file

    The package CD_ELECTRONICSDIS must be included with PIXIE in the package 
    list for EXAMINE2. The D0 PROGRAM BUILDER is used to make the user hooks.
    The .EXE can be made from the LINK file or by using MMS.
    (See D0$EXAMINE2:EXAMINE_GUIDE.DOC)



 B. 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 CD electronics display, the file needed is 
    D0$PIXIE:PX_CD_ELECTRONICSDIS.RCP. The corresponding logical is
    PX_CD_ELECTRONICSDIS_RCP. The user may redirect the RCP logicals 
    to their own files.


 C. RUNNING EXAMINE2

       After "BEGIN PROCESSING" in EXAMINE2, choose menu item
       "EVENT DISPLAY" in the INTERRUPT menu.



 III. CD_ELECTRONICSDIS MENU

     SUB_LEVEL: CD_ELECTRONICS Event Display    PIXIE
     Select: {command, #, HELP (#), MENU, BACK} > help

        1: CD Crate FADCs                      2: CD Fourier Trans
        3: CD VCrate FADCs                     4: NEXT Event
        5: ZOOM                                6: ROTATE
        7: PICK                                8: HARDCOPY
        9: MODIFY                             10: GO TO Event
       11: Change Display Mode                12: Superimpose(On/Off)
       13: Set Path                           14: Dump Event
       15: Write Event                        16: Other Options
       17: COMPACK System Menu

 For further information on menu items 4 - 17, see D0$PIXIE:PX_SYSTEM.DOC


--------------------------------------------------------------------------------
*CD_ELECTRONICSDIS Menu Title    * Function & Remark                          *
--------------------------------------------------------------------------------


   CD CRATE FADCS -  Electronic Crate/Card FADC trace display
   

   CD FOURIER TRANS  - Fourier transform of and FADC trace


   CD VCRATE FADCS - Electronics Crate/Card FADC trace display 
                     with a user setable scale


 IV. CD_ELECTRONICSDIS PARAMETERS in PX_CD_ELECTRONICSDIS.RCP:

--------------------------------------------------------------------------------
* Parameter Name    * Default[Type]  * Remark                                  *
--------------------------------------------------------------------------------
 'ELECT COLR GEN'           'FOR'  ' '
 'ELECT COLR HITS'          'RED'  ' '
 'ELECT COLR LABELS'        'CYA'  ' '
 'ELECT FIX SCALE'          400    ' '
 'ELECT VERT SCALE'           0    ' '
 'SET SCALE'                FALSE  ' '
 'STRING QUALITY'              1  ' '

V. CD_ELECTRONICSDIS SCREENS in PX_CD_ELECTRONICSDIS.RCP:
    
    Each basic menu has own screen parameters. Here we show an example,
    for CD CRATE FADC's. The window parameters are set to default values
    which are overwritten by values inside the plotting routines.

!---------------------------------------------------------
! Definition of CD_ELECTRONICSDIS Screens
!---------------------------------------------------------

 'NAME'        'CD CRATE FADCS'   'CD Crate FADCs'
 'PICKABLE'                    F  'TRUE if pickable'
 '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'          1000.0000  'X Max Window limit'
 'WINDOWYMIN'         -1000.0000  'Y Min Window limit'
 'WINDOWYMAX'          1000.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$EXAMINE2:EXAMINE_GUIDE.DOC - Users guide to EXAMINE,  the ONLINE
                                       event monitoring framework.

    4. D0$PIXIE:PIXIE_GUIDE.DOC - General guide to PIXIE Event Display