Current version of the UATree code at https://svnweb.cern.ch/cern/wsvn/totem/branches/CMSTotemLowPU2015/UATree/.

Reference CMSSW release: CMSSW_7_4_15

To compile:

cd $CMSSW_BASE/src
svn co svn+ssh://svn.cern.ch/reps/totem/branches/CMSTotemLowPU2015/UATree UATree

cd UATree/UADataFormat/
bash dictionary.sh

cd $CMSSW_BASE/src/
scram b -r -j8

Example (see https://svnweb.cern.ch/cern/wsvn/totem/branches/CMSTotemLowPU2015/CMS-TOTEM-Ntuples/Config/):

from UATree.UABaseTree.UABaseTree_forward_all_cfg import process

process.source.fileNames = [
    '<file 1>',
    '<file 2>',
    ...
]

process.uabasetree.hlt_paths = [
    'HLT_L1DoubleJet20_v1',
    'HLT_L1DoubleJet28_v1',
    'HLT_L1DoubleJet32_v1',
    'HLT_L1DoubleMuOpen_v1',
    'HLT_L1TOTEM1_MinBias_v1',
    'HLT_L1TOTEM2_ZeroBias_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part0_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part1_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part2_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part3_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part4_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part5_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part6_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part7_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part0_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part1_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part2_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part3_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part4_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part5_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part6_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part7_v1',
    'HLT_Physics_v1',
    'HLT_Random_v1',
    'HLT_ZeroBias_v1'
]

process.uabasetree.outputfilename = "<output file>"

Optionally select events that pass a list of HLT paths:

process.load("UATree.UABaseTree.hltFilter_cfi")
process.hlt = process.hltFilter.clone(HLTPaths = ['HLT_L1TOTEM1_MinBias_*'])
process.p.replace(process.uabasetree, process.hlt+process.uabasetree)

Writing only metadata

Example (see https://svnweb.cern.ch/cern/wsvn/totem/branches/CMSTotemLowPU2015/CMS-TOTEM-Ntuples/Config/):

from UATree.UABaseTree.UABaseTree_forward_metadata_cfg import process

process.source.fileNames = [ '' ]

process.maxEvents.input = -1
# Set Global Tag
process.GlobalTag.globaltag = '74X_dataRun2_Prompt_v2'

process.uabasetree.hlt_paths = [
    'HLT_L1DoubleJet20_v1',
    'HLT_L1DoubleJet28_v1',
    'HLT_L1DoubleJet32_v1',
    'HLT_L1DoubleMuOpen_v1',
    'HLT_L1Muon_NotMinimumBiasHF2AND_v1',
    'HLT_L1TOTEM1_MinBias_v1',
    'HLT_L1TOTEM2_ZeroBias_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part0_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part1_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part2_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part3_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part4_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part5_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part6_v1',
    'HLT_L1TOTEM0_RomanPotsAND_PixelClusters5_part7_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part0_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part1_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part2_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part3_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part4_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part5_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part6_v1',
    'HLT_L1TOTEM3_RomanPotsTTBB_part7_v1',
    'HLT_Physics_v1',
    'HLT_Random_v1',
    'HLT_ZeroBias_v1'
]

process.uabasetree.outputfilename = "UABaseTree_PromptReco-metadata.root"

RomanPots N-tuples

Show Hide

ZeroBias N-tuples

Show Hide

Totem3(RP_TopTop/BotBot) N-tuples

Show Hide

EmptyBX N-tuples

Show Hide

ToTOTEM( Muons )N-tuples

Show Hide

cd Merge
$PWD/mergeNtuples <TOTEM data file> <CMS data file> <output file> <CMS run number> <offset> [<first CMS lumi>] [<last CMS lumi>]

cd Scripts
./createScript.py \
--totemDir=<EOS TOTEM dir> \
--cmsDir=<EOS CMS dir> \
--totemFileType=<TOTEM file type> \
--outputDir=<EOS output dir> \
--cmsRunNumber=<CMS Run number> \
--orbitOffset=<CMS/TOTEM orbit offset> \
--cmsFirstLumi=<CMS first lumi to process> \
--cmsLastLumi=<CMS last lumi to process> \
--submitDir=<Dir. with job definitions>

Example:

cd Scripts
./createScript.py \
--totemDir=/eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/version1/ \
--cmsDir=/eos/totem/data/cmstotem/2015/90m/CMS/TOTEM_romanPots2_X/Run259352/version_uatree_updated/ \
--totemFileType=9940 \
--outputDir=/eos/totem/data/cmstotem/90m/Totem/CMSTotemLowPU2015/Merge-test/ \
--cmsRunNumber=259352 \
--orbitOffset=21 \
--submitDir=submit-test-v1

cd <submit dir>
./submit.sh

Full list of options:

./createScript.py -h
Usage: createScript.py [options]

Options:
  -h, --help            show this help message and exit
  --totemDir=TOTEMDIR   TOTEM directory
  --totemFileType=TYPE  Select files matching TYPE
  --cmsDir=CMSDIR       CMS directory
  --cmsFileType=TYPE    Select files matching TYPE
  --outputDir=OUTPUTDIR
                        Output directory
  --submitDir=SUBMITDIR
                        Local directory where LSF jobs are defined
  --queue=QUEUE         LSF queue name
  --cmsRunNumber=CMSRUNNUMBER
                        CMS Run number
  --orbitOffset=ORBITOFFSET
                        Orbit offset
  --cmsFirstLumi=CMSFIRSTLUMI
                        First CMS lumi section
  --cmsLastLumi=CMSLASTLUMI
                        Last CMS lumi section

• Note that the offset can be found with a fraction of the data, as long as the Run periods between the CMS and TOTEM files overlap. If merging files is needed, see below.

• Needed only once:

     svn co svn+ssh://svn.cern.ch/reps/totem/branches/CMSTotemLowPU2015/CMS-TOTEM-Ntuples CMS-TOTEM-Ntuples
     cd CMS-TOTEM-Ntuples
     source setup.csh
     cd Merge
     make
     

• Calculate orbit offset. Output log gives calculated orbit offset. Histograms saved in output ROOT file.

     cd Merge
     $PWD/findOrbitOffset <TOTEM data file> <CMS data file> <output file> [<first CMS lumi>] [<last CMS lumi>] [<TOTEM Tree name>] [<CMS Tree name>]
     

• Needed only once:

     svn co svn+ssh://svn.cern.ch/reps/totem/branches/CMSTotemLowPU2015/CMS-TOTEM-Ntuples CMS-TOTEM-Ntuples
     cd CMS-TOTEM-Ntuples
     source setup.csh
     cd Merge
     make
     

• Merging CMS files. Full paths to ROOT files (including EOS path and prefix) assumed. Only event metadata information is saved.

     cd Merge
     $PWD/mergeCMSFiles <Output file name> <CMS data file 1> [<CMS data file 2>,...]
     

• Merging TOTEM files (if needed). Full paths to ROOT files (including EOS path and prefix) assumed. Only event metadata information is saved.

     cd Merge 
     $PWD/mergeTOTEMFiles <Output file name> <TOTEM data file 1> [<TOTEM data file 2>,...]
     

• Example:

     $PWD/mergeTOTEMFiles TOTEM_9836-metadata-v1.root `listFilesEOS.py -d /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/version1 --prefix='root://eostotem/' | grep 9836`
     

• The listFilesEOS.py script is available under https://svnweb.cern.ch/cern/wsvn/totem/branches/CMSTotemLowPU2015/CMS-TOTEM-Ntuples/Scripts/

Totem Datasets: /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/version2/<fill_number>
Warning for RUNs 9920 9940 9950 9976 9985 9998: use /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/v_resynch/<fill_number>
CMS Datasets: /eos/totem/data/cmstotem/2015/90m/CMS/TOTEM_romanPots2_X/RunXXX/

(*) = Track reconstruction optimized with RP210.; Datasets in eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/v_resynch/<fill_number>

Totem Datasets: /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/version2/<fill_number>
Warning for RUNs 9920 9940 9950 9976 9985 9998: use /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/v_resynch/<fill_number>
CMS Datasets: /eos/totem/data/cmstotem/2015/90m/CMS/TOTEM_romanPots2_X_rereco/ (UATrees)
from RECO files: /eos/totem/data/cmstotem/2015/90m/CMS/RECO/TOTEM_romanPots2_X/

(*) = Track reconstruction optimized with RP210.; Datasets in eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/v_resynch/<fill_number>

Totem Datasets: /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/version2/<fill_number>
() Warning for RUNs 9920 9940 9950 9976 9985 9998: use /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/v_resynch/<fill_number>
CMS Datasets: /eos/totem/data/cmstotem/2015/90m/CMS/ZeroBias/RunXXX/

Totem Datasets: /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/version2/<fill_number>
() Warning for RUNs 9920 9940 9950 9976 9985 9998: use /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/v_resynch/<fill_number>
CMS Datasets: /eos/totem/data/cmstotem/2015/90m/CMS/Muons/RunXXX/

Totem Datasets: /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/version2/<fill_number>
() Warning for RUNs 9920 9940 9950 9976 9985 9998: use /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/v_resynch/<fill_number>
CMS Datasets: /eos/totem/data/cmstotem/2015/90m/CMS/TOTEM_romanPots2_X/RunXXX/

Totem Datasets: /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/version2/<fill_number>
() Warning for RUNs 9920 9940 9950 9976 9985 9998: use /eos/totem/data/cmstotem/2015/90m/Totem/Ntuple/v_resynch/<fill_number>
CMS Datasets: /eos/totem/data/cmstotem/2015/90m/CMS/DoubleJet32/RunXXX/