| 1 |
------------------------------------
|
| 2 |
Instructions for use of CMSSWPlotAll
|
| 3 |
------------------------------------
|
| 4 |
|
| 5 |
===============================================================================
|
| 6 |
Release: 2.4.0
|
| 7 |
===============================================================================
|
| 8 |
|
| 9 |
P. Dudero (dudero@physics.umn.edu)
|
| 10 |
K. Klapoetke (klapoetke@physics.umn.edu)
|
| 11 |
|
| 12 |
Compatibility: CMSSW_1_4_X
|
| 13 |
|
| 14 |
Changes
|
| 15 |
-------
|
| 16 |
|
| 17 |
- New electronics-centric plotting capability; plots can be selected by
|
| 18 |
crate/slot/fiber/etc.
|
| 19 |
- Calibration channels can be plotted by their electronics id's
|
| 20 |
|
| 21 |
Setup and Running
|
| 22 |
-----------------
|
| 23 |
|
| 24 |
- Same as in the previous version. Note that the new "reco_setup.rc" has
|
| 25 |
an additional "DO_CALIB" variable, so you can control whether calibration
|
| 26 |
channels are reconstructed and plottable, or not.
|
| 27 |
|
| 28 |
===============================================================================
|
| 29 |
Release: 2.3.0
|
| 30 |
===============================================================================
|
| 31 |
|
| 32 |
P. Dudero (dudero@physics.umn.edu)
|
| 33 |
|
| 34 |
Compatibility: CMSSW_1_3_0
|
| 35 |
|
| 36 |
Changes
|
| 37 |
-------
|
| 38 |
|
| 39 |
- New mode "USC" - attempts to reconstruct all available HCAL FED blocks.
|
| 40 |
- "Mean/RMS" radio button - controls what gets displayed in the Visual
|
| 41 |
Selector windows.
|
| 42 |
- New Pedestal/ADC plots.
|
| 43 |
- HF ieta=29 is now preferred over HE ieta=29 (which cannot now be plotted)
|
| 44 |
- Unconnected/unrepresented channels are colored white in the Visual Selector
|
| 45 |
windows.
|
| 46 |
- Compatible with teststand and offline operation (slc3 architecture).
|
| 47 |
|
| 48 |
Setup - HCAL teststands
|
| 49 |
-----
|
| 50 |
|
| 51 |
1) Create a work area any old place you like.
|
| 52 |
|
| 53 |
> mkdir myPlotAllWorkArea
|
| 54 |
> cd myPlotAllWorkArea
|
| 55 |
|
| 56 |
2) copy the PlotAll scripts into the work area (and README if you want)
|
| 57 |
|
| 58 |
> cp $HCALDAQ_SW_LOC/src/$HCAL_CMSSW_RELEASE/src/RecoTBCalo/HcalPlotter/scripts/*.* .
|
| 59 |
> cp $HCALDAQ_SW_LOC/src/$HCAL_CMSSW_RELEASE/src/RecoTBCalo/HcalPlotter/scripts/README .
|
| 60 |
|
| 61 |
3) You're good to go! Proceed to the "Running" instructions below.
|
| 62 |
|
| 63 |
-----
|
| 64 |
|
| 65 |
Setup - offline (SLC3 architecture - cmsru2, lxslc3, etc.)
|
| 66 |
-----
|
| 67 |
|
| 68 |
1) Create a CMSSW_1_3_0 working area using the "scramv1 project" command:
|
| 69 |
|
| 70 |
> scramv1 project CMSSW CMSSW_1_3_0
|
| 71 |
|
| 72 |
2) Under this area, check out from CMSSW CVS the following tags:
|
| 73 |
(assumes you have "cms-cvs-utils" installed):
|
| 74 |
|
| 75 |
> cd CMSSW_1_3_0/src
|
| 76 |
> cmscvsroot CMSSW
|
| 77 |
> cvs co -r V00-01-01 RecoTBCalo/HcalPlotter
|
| 78 |
> cvs co -r V00-01-14 RecoTBCalo/HcalTBObjectUnpacker
|
| 79 |
> scramv1 build
|
| 80 |
|
| 81 |
3) Create a work area for yourself and copy the PlotAll scripts to this area.
|
| 82 |
The instructions under "Running" below assume that this work area is a
|
| 83 |
subdirectory under CMSSW_1_3_0/src.
|
| 84 |
|
| 85 |
> mkdir myPlotAllWorkArea
|
| 86 |
> cp RecoTBCalo/HcalPlotter/scripts/*.* myPlotAllWorkArea
|
| 87 |
> cp RecoTBCalo/HcalPlotter/scripts/README myPlotAllWorkArea # this readme
|
| 88 |
|
| 89 |
Running
|
| 90 |
-------
|
| 91 |
|
| 92 |
Same as for previous instructions below, with the following additions/changes:
|
| 93 |
|
| 94 |
- "cd" to the work area created in the instructions above, and there type the
|
| 95 |
"eval" command.
|
| 96 |
- "reco_setup.rc" file has new mode "USC". All modes are described in the file.
|
| 97 |
|
| 98 |
===============================================================================
|
| 99 |
Release: 2.0.0 beta
|
| 100 |
===============================================================================
|
| 101 |
|
| 102 |
P. Dudero (dudero@physics.umn.edu)
|
| 103 |
|
| 104 |
Compatibility: CMSSW_1_1_1
|
| 105 |
|
| 106 |
Setup
|
| 107 |
-----
|
| 108 |
|
| 109 |
1) Create a CMSSW_1_1_1 working area using the "scramv1 project" command.
|
| 110 |
Examples for previous versions are given below. (At most teststands,
|
| 111 |
this will be done by user daqowner.)
|
| 112 |
2) Under this area, check out from CMSSW CVS the package
|
| 113 |
RecoTBCalo/HcalPlotter. No specific tag is needed for the present.
|
| 114 |
3) Execute
|
| 115 |
|
| 116 |
eval `scramv1 runtime -csh` [if you run tcsh or csh as shell, as daq does]
|
| 117 |
eval `scramv1 runtime -sh` [if you run bash or zsh as shell]
|
| 118 |
|
| 119 |
in the CMSSW_1_1_1/src directory. This must be done once per login.
|
| 120 |
|
| 121 |
4) "cd" to "RecoTBCalo/HcalPlotter" and build this package by executing
|
| 122 |
"scramv1 build".
|
| 123 |
5) Under the CMSSW_1_1_1/src directory, create an area that will hold the
|
| 124 |
CMSSWPlotAll files.
|
| 125 |
6) Now you can edit the "reco_setup.rc" file to select the appropriate
|
| 126 |
map file for the data you are interested in, and to specify a pedestal
|
| 127 |
file or gains file if you have one to use. In addition, to use the
|
| 128 |
"Process run number" feature, specify a printf-style format string
|
| 129 |
that gives the full path to the directory where raw data files will be
|
| 130 |
placed. Examples include
|
| 131 |
|
| 132 |
FORMAT="/somedir/someotherdir/HTB_%06d.root" # full path
|
| 133 |
FORMAT="HTB_%06d.root" # current working dir
|
| 134 |
FORMAT="../siblingdir/HTB_%06d.root" # relative to the working dir
|
| 135 |
|
| 136 |
(The "%06d" part of the format string indicates where the run number will be
|
| 137 |
placed, and that it will have 6 total digits zero-padded on the left. This
|
| 138 |
is a common filename format used at Hcal test stands.)
|
| 139 |
|
| 140 |
Running
|
| 141 |
-------
|
| 142 |
|
| 143 |
1) Before you do anything, you must go to "CMSSW_1_1_1/src" and run
|
| 144 |
|
| 145 |
eval `scramv1 runtime -csh` [if you run tcsh or csh as shell, as daq does]
|
| 146 |
eval `scramv1 runtime -sh` [if you run bash or zsh as shell]
|
| 147 |
|
| 148 |
This must be done once per login.
|
| 149 |
|
| 150 |
2) To plot:
|
| 151 |
|
| 152 |
root
|
| 153 |
root[0] .x PlotAll.C()
|
| 154 |
|
| 155 |
Then, enter a run number and click "Process", or click "Browse..." to browse
|
| 156 |
to the file that you want to look at. The tool will automatically spawn a
|
| 157 |
reconstruct job and then load the resulting histograms into its internal memory.
|
| 158 |
From there you can then make plots from the menu.
|
| 159 |
|
| 160 |
Hint: Try the visual selector! You can double click on a cell to get a plot
|
| 161 |
of the values for that cell.
|
| 162 |
|
| 163 |
To Adjust Plotting
|
| 164 |
------------------
|
| 165 |
|
| 166 |
You can easily adjust the range and bins for the various flavors of histograms
|
| 167 |
by editing the "reco_setup.rc" file. All the bin counts and ranges
|
| 168 |
are defined at the bottom of this file.
|
| 169 |
|
| 170 |
===============================================================================
|
| 171 |
Release: 1.3.0
|
| 172 |
===============================================================================
|
| 173 |
|
| 174 |
E. Dahlman (dahlman@physics.umn.edu)
|
| 175 |
A. Kubik (akubik1@yahoo.com)
|
| 176 |
J. Mans (jmmans@physics.umn.edu)
|
| 177 |
|
| 178 |
Compatibility: CMSSW_0_6_0 --> CMSSW_0_8_1
|
| 179 |
|
| 180 |
Setup
|
| 181 |
-----
|
| 182 |
|
| 183 |
1) You will need a working area of CMSSW. You only need to make a working area
|
| 184 |
once. For example, if your login name was "fred":
|
| 185 |
|
| 186 |
On a MOE machine:
|
| 187 |
|
| 188 |
mkdir /home/daq/fred
|
| 189 |
cd /home/daq/fred
|
| 190 |
scramv1 project CMSSW CMSSW_0_8_1
|
| 191 |
|
| 192 |
On LXPLUS
|
| 193 |
scramv1 project CMSSW CMSSW_0_8_1
|
| 194 |
|
| 195 |
2) Next, copy all the files in the CMSSWPlotAll package to a personal working
|
| 196 |
area. This could be CMSSW_0_8_1/src or another directory.
|
| 197 |
|
| 198 |
3) Now, you can edit the "reco_setup.rc" file to select the appropriate
|
| 199 |
map file for the data you are interested in, and to specify a pedestal
|
| 200 |
file or gains file if you have one to use. You may have to edit
|
| 201 |
runCMSSWReco.sh in certain cases (to change which samples are pulled from
|
| 202 |
the file, etc.)
|
| 203 |
|
| 204 |
|
| 205 |
Running
|
| 206 |
-------
|
| 207 |
|
| 208 |
1) Before you do anything, you must go to "CMSSW_0_8_1/src" and run
|
| 209 |
|
| 210 |
eval `scramv1 runtime -csh` [if you run tcsh or csh as shell, as daq does]
|
| 211 |
eval `scramv1 runtime -sh` [if you run bash or zsh as shell]
|
| 212 |
|
| 213 |
This must be done once per login.
|
| 214 |
|
| 215 |
2) There are different scripts to reconstruct from HCALdaq files or
|
| 216 |
from centrally-produced CMSSSW files.
|
| 217 |
|
| 218 |
To reconstruct a file from the HCAL daq:
|
| 219 |
|
| 220 |
./runCMSSWReco.sh [the file]
|
| 221 |
|
| 222 |
So ./runCMSSWReco.sh /data/spool/HTB_024019.root will produce
|
| 223 |
"HTB_024019-cmsswreco.root" in your local directory. You should delete these
|
| 224 |
processed files when you no longer need them. (There may be automated
|
| 225 |
cleanup in the future).
|
| 226 |
|
| 227 |
To reconstruct a centrally produced CMSSW file:
|
| 228 |
|
| 229 |
./runCMSSWRecoGlobal.sh [the file]
|
| 230 |
|
| 231 |
** NOTE : If the CMSSW file has already been reconstructed, you can skip
|
| 232 |
** right to step (3) and ignore the "runCMSSWRecoGlobal.sh" step.
|
| 233 |
|
| 234 |
|
| 235 |
3) To plot:
|
| 236 |
|
| 237 |
root
|
| 238 |
root[0] .x PlotAll.C
|
| 239 |
|
| 240 |
Then, "Load POOL File" on the file you want. You can then make plots
|
| 241 |
from the menu.
|
| 242 |
|
| 243 |
Hint: Try the visual selector! You can double click on a cell to get a plot
|
| 244 |
of the values for that cell.
|
| 245 |
|
| 246 |
|
| 247 |
To Adjust Plotting
|
| 248 |
------------------
|
| 249 |
|
| 250 |
You can easily adjust the range and bins for the various flavors of histograms
|
| 251 |
by editing the "HistoManager.cc". All the bin counts and ranges
|
| 252 |
are defined at the top of this file.
|
| 253 |
|
| 254 |
|
| 255 |
TB06 Specific
|
| 256 |
-------------
|
| 257 |
|
| 258 |
PlotAllBeamCounters will make various plots of TB06 beam counters. To use,
|
| 259 |
click the Plot Beam Counters button, and choose a POOL file which has unpacked
|
| 260 |
TB06 beam counter information. Histo ranges and binning can be adjusted at the
|
| 261 |
top of PlotAllBeamCounters.C
|
