Here is the detailed instruction for using SmtExamine.
Note: If EXAMINE is already installed you have to omit steps
3,5-9, 11-15.
1. You must be on node D0MINO to run Examine.
2. Execute "setup n32"
3. Execute "setup d0cvs"
4. Execute "setup D0RunII t01.21.00" (current release)
5. Go to the directory where you would like SmtExamine to be installed.
6. Execute "newrel -t t01.21.00 examine"
7. Execute "cd examine"
8. Execute "addpkg -h smt_examine"
9. Execute "d0setwa"
10. Execute "gmake"
It may take up to 5 minutes while SmtExamine will be compiling.
12. Execute "cd smt_examine/bin"
13. Execute "ExamineSetup.sh"
14. Execute "cd ../.."
15. The installation of SmtExamine is now finished.
16. Now decide on the following SMTRAW options. To change these options, edit
"smtraw/rcp/SmtRawUnp2Data.rcp" file.
a. CalibrationMode:
STATIC - Substract a fixed pedestal for all event.
DYNAMIC - Event-by-event pedestal substraction.
b. AdcToEnergy - MeV to ADC counts. Set it to 1 to view the ADC counts.
The default is 0.00352567 MeV/ADC counts.
c. GlobalPedestal -Fixed pedestal to be substructed away in STATIC
calibration mode. Set it to 0 to view the raw pedestal.
d. PrintPedestal - Set to true to output ADC pedestal in each chip for
each event. This works only in DYNAMIC calibration mode.
e. PedestalFileName - Name of the file to which to dump the pedestal levels
f. MinimumADC - All strips with ADC count below this value will not appear
in the Examine histograms
17. Decide on the following SmtExamine options. To change these options, edit
"smt_examine/rcp/smt_examine.rcp" file.
a. Accumulate ADC - Set it to "true" to accumulate ADC counts as events
are processed.
b. hbk_file - HBOOK file where the histograms will be stored.
18. Decide whether to run SmtExamine in the FILE or the NET mode.
In the FILE mode, events are read in from an event file.
In the NET mode, events are read in from the data distributor from the
network (usually host "d0ola").
If you choose FILE mode, edit "io_packages/rcp/ReadEvent.rcp" file to
set the following parameters:
InputFile - Name of the file containing events.
InputFormat - EVPACK (usual) or DSPACK. Format of the event file.
By default Examine will read the data from file "input". If you
don't want to change rcp execute "ln -s your_data_file input" in
the direcory "bin/IRIX6-KCC_3_3/"
If you choose NET mode, edit "read_event_daq/rcp/ReadEventDaq.rcp" file
to set the following parameters:
Host - host name of the data distributor ( usually "d0ola").
Port - Port number from which the events are flowing out. Now set to
52100.
19. There are 3 configuration files one must change following the change
of the setup configuration.
a. edit "bin/IRIX6-KCC_3_3/cfg.dat". This file contains the CrateID
number and the number of VRBs in the crate.
The format of cfg.dat is the following:
//
0x63 SMT_FE 2 ( CrateID SMT_FE Number of VRBs)
0x76 SMT ( 1st VRBaddress )
0x77 SMT ...
b. edit "bin/IRIX6-KCC_3_3/translation.map". This file contains
the map of VRBaddresses and connected ladders/barrels or
wedges/disks.
The format of translation.map is the following:
0x76 0 0x80 6 2 4 2 0 2
0x77 0 0x80 8 2 4 2 0 1
( 'VRBaddress#' 'chain#' 'ChipID of 1st chip' 'Number of chips'
'Detector type' 'Barrel/Disk#' 'Layer/Wedge#' 'Ladder# (0 for disks)'
'View')
Here 'Detector type' is 1 for barrels, 2 for F-disks, 3 for H-disks
c. edit "smt_examine/rcp/test_config.rcp". This file contains the list
of histograms to be filled.
There are the following parameters you must change:
testChips - set it to "true" if you wish to see histograms
for each chip.
testLadders - set it to "true" if you test the ladders.
Ladders = ("3 3 5 1", ... ) - barrel#, layer#, ladder#, view#.
It is a list of ladders under test.
testFWedges - set it to "true" if you test the f-wedges
FWedges = ("4 2 1", ... ) - disk#, wedge#, view#.
It is a list of F wedges under test
testHWedges - set it to "true" if you test the h-wedges.
HWedges = ("4 2 1", ... ) - disk#, wedge#, view#.
It is a list of H wedges under test
20. Change dir to "bin/IRIX6-KCC_3_3" subdirectory
21. Execute "rm *.hbook"
22. Execute "histo &"
23. To run SmtExamine in FILE mode, execute:
"testSmtExamine -rcp frameworkFILE.rcp"
To run SmtExamine in NET mode, execute:
"testSmtExamine -rcp frameworkNET.rcp -log errors.log"
24. Wait 1 or 2 minutes.
25. In "histoscope" program, select File->ConnectToProcess.
26. Connect to "Smt-histos(your-login-name)" process.
27. Double click "EXAMINE.HBOOK" in SubCategories to see a list of histograms.
28. Double click on histograms you wish to see.
29. As SmtExamine processes each event, it updates histograms file and pedestal
output file. The default names for them are "examine.hbook" and
"Pedestal.txt", respecively.
30. END