Warning, /RecoTBCalo/HcalPlotter/scripts/README is written in an unsupported language. File is not indexed.
0001 ------------------------------------
0002 Instructions for use of CMSSWPlotAll
0003 ------------------------------------
0004
0005 ===============================================================================
0006 Release: 2.4.0
0007 ===============================================================================
0008
0009 P. Dudero (dudero@physics.umn.edu)
0010 K. Klapoetke (klapoetke@physics.umn.edu)
0011
0012 Compatibility: CMSSW_1_4_X
0013
0014 Changes
0015 -------
0016
0017 - New electronics-centric plotting capability; plots can be selected by
0018 crate/slot/fiber/etc.
0019 - Calibration channels can be plotted by their electronics id's
0020
0021 Setup and Running
0022 -----------------
0023
0024 - Same as in the previous version. Note that the new "reco_setup.rc" has
0025 an additional "DO_CALIB" variable, so you can control whether calibration
0026 channels are reconstructed and plottable, or not.
0027
0028 ===============================================================================
0029 Release: 2.3.0
0030 ===============================================================================
0031
0032 P. Dudero (dudero@physics.umn.edu)
0033
0034 Compatibility: CMSSW_1_3_0
0035
0036 Changes
0037 -------
0038
0039 - New mode "USC" - attempts to reconstruct all available HCAL FED blocks.
0040 - "Mean/RMS" radio button - controls what gets displayed in the Visual
0041 Selector windows.
0042 - New Pedestal/ADC plots.
0043 - HF ieta=29 is now preferred over HE ieta=29 (which cannot now be plotted)
0044 - Unconnected/unrepresented channels are colored white in the Visual Selector
0045 windows.
0046 - Compatible with teststand and offline operation (slc3 architecture).
0047
0048 Setup - HCAL teststands
0049 -----
0050
0051 1) Create a work area any old place you like.
0052
0053 > mkdir myPlotAllWorkArea
0054 > cd myPlotAllWorkArea
0055
0056 2) copy the PlotAll scripts into the work area (and README if you want)
0057
0058 > cp $HCALDAQ_SW_LOC/src/$HCAL_CMSSW_RELEASE/src/RecoTBCalo/HcalPlotter/scripts/*.* .
0059 > cp $HCALDAQ_SW_LOC/src/$HCAL_CMSSW_RELEASE/src/RecoTBCalo/HcalPlotter/scripts/README .
0060
0061 3) You're good to go! Proceed to the "Running" instructions below.
0062
0063 -----
0064
0065 Setup - offline (SLC3 architecture - cmsru2, lxslc3, etc.)
0066 -----
0067
0068 1) Create a CMSSW_1_3_0 working area using the "scramv1 project" command:
0069
0070 > scramv1 project CMSSW CMSSW_1_3_0
0071
0072 2) Under this area, check out from CMSSW CVS the following tags:
0073 (assumes you have "cms-cvs-utils" installed):
0074
0075 > cd CMSSW_1_3_0/src
0076 > cmscvsroot CMSSW
0077 > cvs co -r V00-01-01 RecoTBCalo/HcalPlotter
0078 > cvs co -r V00-01-14 RecoTBCalo/HcalTBObjectUnpacker
0079 > scramv1 build
0080
0081 3) Create a work area for yourself and copy the PlotAll scripts to this area.
0082 The instructions under "Running" below assume that this work area is a
0083 subdirectory under CMSSW_1_3_0/src.
0084
0085 > mkdir myPlotAllWorkArea
0086 > cp RecoTBCalo/HcalPlotter/scripts/*.* myPlotAllWorkArea
0087 > cp RecoTBCalo/HcalPlotter/scripts/README myPlotAllWorkArea # this readme
0088
0089 Running
0090 -------
0091
0092 Same as for previous instructions below, with the following additions/changes:
0093
0094 - "cd" to the work area created in the instructions above, and there type the
0095 "eval" command.
0096 - "reco_setup.rc" file has new mode "USC". All modes are described in the file.
0097
0098 ===============================================================================
0099 Release: 2.0.0 beta
0100 ===============================================================================
0101
0102 P. Dudero (dudero@physics.umn.edu)
0103
0104 Compatibility: CMSSW_1_1_1
0105
0106 Setup
0107 -----
0108
0109 1) Create a CMSSW_1_1_1 working area using the "scramv1 project" command.
0110 Examples for previous versions are given below. (At most teststands,
0111 this will be done by user daqowner.)
0112 2) Under this area, check out from CMSSW CVS the package
0113 RecoTBCalo/HcalPlotter. No specific tag is needed for the present.
0114 3) Execute
0115
0116 eval `scramv1 runtime -csh` [if you run tcsh or csh as shell, as daq does]
0117 eval `scramv1 runtime -sh` [if you run bash or zsh as shell]
0118
0119 in the CMSSW_1_1_1/src directory. This must be done once per login.
0120
0121 4) "cd" to "RecoTBCalo/HcalPlotter" and build this package by executing
0122 "scramv1 build".
0123 5) Under the CMSSW_1_1_1/src directory, create an area that will hold the
0124 CMSSWPlotAll files.
0125 6) Now you can edit the "reco_setup.rc" file to select the appropriate
0126 map file for the data you are interested in, and to specify a pedestal
0127 file or gains file if you have one to use. In addition, to use the
0128 "Process run number" feature, specify a printf-style format string
0129 that gives the full path to the directory where raw data files will be
0130 placed. Examples include
0131
0132 FORMAT="/somedir/someotherdir/HTB_%06d.root" # full path
0133 FORMAT="HTB_%06d.root" # current working dir
0134 FORMAT="../siblingdir/HTB_%06d.root" # relative to the working dir
0135
0136 (The "%06d" part of the format string indicates where the run number will be
0137 placed, and that it will have 6 total digits zero-padded on the left. This
0138 is a common filename format used at Hcal test stands.)
0139
0140 Running
0141 -------
0142
0143 1) Before you do anything, you must go to "CMSSW_1_1_1/src" and run
0144
0145 eval `scramv1 runtime -csh` [if you run tcsh or csh as shell, as daq does]
0146 eval `scramv1 runtime -sh` [if you run bash or zsh as shell]
0147
0148 This must be done once per login.
0149
0150 2) To plot:
0151
0152 root
0153 root[0] .x PlotAll.C()
0154
0155 Then, enter a run number and click "Process", or click "Browse..." to browse
0156 to the file that you want to look at. The tool will automatically spawn a
0157 reconstruct job and then load the resulting histograms into its internal memory.
0158 From there you can then make plots from the menu.
0159
0160 Hint: Try the visual selector! You can double click on a cell to get a plot
0161 of the values for that cell.
0162
0163 To Adjust Plotting
0164 ------------------
0165
0166 You can easily adjust the range and bins for the various flavors of histograms
0167 by editing the "reco_setup.rc" file. All the bin counts and ranges
0168 are defined at the bottom of this file.
0169
0170 ===============================================================================
0171 Release: 1.3.0
0172 ===============================================================================
0173
0174 E. Dahlman (dahlman@physics.umn.edu)
0175 A. Kubik (akubik1@yahoo.com)
0176 J. Mans (jmmans@physics.umn.edu)
0177
0178 Compatibility: CMSSW_0_6_0 --> CMSSW_0_8_1
0179
0180 Setup
0181 -----
0182
0183 1) You will need a working area of CMSSW. You only need to make a working area
0184 once. For example, if your login name was "fred":
0185
0186 On a MOE machine:
0187
0188 mkdir /home/daq/fred
0189 cd /home/daq/fred
0190 scramv1 project CMSSW CMSSW_0_8_1
0191
0192 On LXPLUS
0193 scramv1 project CMSSW CMSSW_0_8_1
0194
0195 2) Next, copy all the files in the CMSSWPlotAll package to a personal working
0196 area. This could be CMSSW_0_8_1/src or another directory.
0197
0198 3) Now, you can edit the "reco_setup.rc" file to select the appropriate
0199 map file for the data you are interested in, and to specify a pedestal
0200 file or gains file if you have one to use. You may have to edit
0201 runCMSSWReco.sh in certain cases (to change which samples are pulled from
0202 the file, etc.)
0203
0204
0205 Running
0206 -------
0207
0208 1) Before you do anything, you must go to "CMSSW_0_8_1/src" and run
0209
0210 eval `scramv1 runtime -csh` [if you run tcsh or csh as shell, as daq does]
0211 eval `scramv1 runtime -sh` [if you run bash or zsh as shell]
0212
0213 This must be done once per login.
0214
0215 2) There are different scripts to reconstruct from HCALdaq files or
0216 from centrally-produced CMSSSW files.
0217
0218 To reconstruct a file from the HCAL daq:
0219
0220 ./runCMSSWReco.sh [the file]
0221
0222 So ./runCMSSWReco.sh /data/spool/HTB_024019.root will produce
0223 "HTB_024019-cmsswreco.root" in your local directory. You should delete these
0224 processed files when you no longer need them. (There may be automated
0225 cleanup in the future).
0226
0227 To reconstruct a centrally produced CMSSW file:
0228
0229 ./runCMSSWRecoGlobal.sh [the file]
0230
0231 ** NOTE : If the CMSSW file has already been reconstructed, you can skip
0232 ** right to step (3) and ignore the "runCMSSWRecoGlobal.sh" step.
0233
0234
0235 3) To plot:
0236
0237 root
0238 root[0] .x PlotAll.C
0239
0240 Then, "Load POOL File" on the file you want. You can then make plots
0241 from the menu.
0242
0243 Hint: Try the visual selector! You can double click on a cell to get a plot
0244 of the values for that cell.
0245
0246
0247 To Adjust Plotting
0248 ------------------
0249
0250 You can easily adjust the range and bins for the various flavors of histograms
0251 by editing the "HistoManager.cc". All the bin counts and ranges
0252 are defined at the top of this file.
0253
0254
0255 TB06 Specific
0256 -------------
0257
0258 PlotAllBeamCounters will make various plots of TB06 beam counters. To use,
0259 click the Plot Beam Counters button, and choose a POOL file which has unpacked
0260 TB06 beam counter information. Histo ranges and binning can be adjusted at the
0261 top of PlotAllBeamCounters.C
