1. cmsDriver.py guides/twikis:

SWGuideCmsDriver

SWGuideFastSimulationExamples

SWGuideGlobalHLT

2. General info/Usage:

Options overview

Input --> Output	Run1 Data	Run1 Cosmics Data	Run2 Data	Run2 Cosmics Data
Common	--process NAME --filein file:input.root --fileout file:output.root --python_filename test/TimingStudy_InputData_CMSSWX_cfg.py --dasquery=file dataset=/X/Y/Z run=N --no_exec -n 10
	--conditions auto:run1_data		--conditions auto:run2_data
		--scenario cosmics		--scenario cosmics
RAW --> RECO	--step RAW2DIGI ,RECO --eventcontent RECO
RECO/FEVT --> MINIAOD

Input	Run1 MC	Run2 MC
Common	--process NAME --filein file:input.root --fileout file:output.root --python_filename test/TimingStudy_InputData_CMSSWX_cfg.py --dasquery=file dataset=/X/Y/Z run=N --no_exec -n 10
	--conditions auto:run1_mc	--conditions auto:run2_mc --magField 38T_PostLS1 --beamspot NominalCollision2015 --customise SLHCUpgradeSimulations /Configuration/postLS1Customs.customisePostLS1,Configuration/DataProcessing/Utils.addMonitoring
--> GEN-SIM	cmsDriver.py MinBias _13TeV_cfi.py --step GEN,SIM --datatier GEN-SIM --eventcontent FEVTDEBUG or RAWSIM
GEN-SIM --> GEN-SIM-RAW	--step DIGI,L1,DIGI2RAW,HLT --datatier GEN-SIM-RAW --eventcontent RAWSIM --pileup NoPileUp or Flat_0_50_25ns or AVE_20_BX_25ns
GEN-SIM-RAW --> RECO	--step RAW2DIGI ,L1Reco,RECO --datatier RECOSIM AODSIM --eventcontent RECOSIM or AODSIM
RECO/AOD --> MINIAODSIM	--step PAT --eventcontent MINIAODSIM --runUnscheduled --conditions PHYS14_25_V1
FASTSIM

Info

- The best is to use a recent working config file before you want to make your first script using the cmsDriver

- Steps to do this:

1) Go to das: https://cmsweb.cern.ch/das/

- find a dataset of your choice, eg:

https://cmsweb.cern.ch/das/request?view=list&limit=100&instance=prod%2Fglobal&input=dataset%3D%2FMinBias*%2F*%2FGEN-SIM+|+sort+dataset.creation_time

2) Go to mcm: https://cms-pdmv.cern.ch/mcm/

- Go click on "Request" on the top of the page

- In the "Output dataset" field: type your chosen dataset

- In the "Actions column" click on "Get test command"

3) Find cmsDriver.py line, run it, modify script accordint to your likes, also use the CMSSW version there preferably

eg:
cmsDriver.py Configuration/GenProduction/python/FSQ-RunIIWinter15GS-00004-fragment.py --fileout file:FSQ-RunIIWinter15GS-00004.root --mc --eventcontent RAWSIM --customise SLHCUpgradeSimulations/Configuration/postLS1Customs.customisePostLS1,Configuration/DataProcessing/Utils.addMonitoring --datatier GEN-SIM --conditions MCRUN2_71_V1::All --beamspot NominalCollision2015 --step GEN,SIM --magField 38T_PostLS1 --python_filename FSQ-RunIIWinter15GS-00004_1_cfg.py --no_exec -n 183
 

2. Examples:

2.1 Generate MinBias GEN-SIM MC

cmsDriver.py MinBias_13TeV_cfi.py -s GEN,SIM --mc --conditions auto:run2_mc --beamspot NominalCollision2015 --magField 38T_PostLS1 -n 10

2.2 Generate MinBias GEN-SIM MC + HLT Step

- L1 and HLT should agree - L1 menu is specified in he GlobalTag

cmsDriver ... -s GEN,...,HLT:7E33v4 --conditions auto:startup_7E33v4

- Working recpe:

cmsDriver.py MinBias_13TeV_cfi.py -s GEN,SIM,DIGI,L1,DIGI2RAW,HLT --mc --conditions auto:run2_mc --pileup=NoPileUp --beamspot NominalCollision2015 --magField 38T_PostLS1 --customise SLHCUpgradeSimulations/Configuration/postLS1Customs.customisePostLS1 -n 10

2.3 ReReco Cosmics RAW data (53X) - Add Refitter and TimingStudy

• Make a config file with cmsDriver.py:

cmsDriver.py step1 --conditions GR_R_53_V21A::All -s RAW2DIGI ,RECO --scenario cosmics --process RawToDigiToReco --data --dasquery=file dataset=/Cosmics/Commissioning12-26Mar2013-v1/RECO run=186160 --eventcontent RECO --fileout file:Cosmics.root --no_exec --python_filename=test/TimingStudy_Cosmics_RawData_CMSSW53X_cfg.py

• Add a refitter, eg:

process.load("RecoTracker.TrackProducer.TrackRefitters_cff")
process.Refitter = process.TrackRefitterP5.clone()
process.Refitter.src = 'ctfWithMaterialTracksP5'
process.Refitter.TrajectoryInEvent = True

• Add TimingStudy module: process.TimingStudy = cms.EdAnalyzer("TimingStudy", ...
• Overwrite schedule:

process.TimingStudy_step = cms.Path(process.Refitter*process.TimingStudy)
process.schedule = cms.Schedule(process.raw2digi_step, process.reconstruction_step, process.TimingStudy_step)

2.4 ReReco Cosmics RAW data (73X) - Add Refitter and TimingStudy

• Make a config file with cmsDriver.py:

cmsDriver.py step1 -s RAW2DIGI ,RECO --scenario cosmics --conditions GR_P_V49 --process RawToDigiToReco --data --eventcontent RECO --customise Configuration/DataProcessing/RecoTLR.customiseCosmicDataRun2 --dasquery='file dataset=/Cosmics/Commissioning2015-v1/RAW run=233238' -n 100 --python_filename=test/TimingStudy_Cosmics_RawData_CMSSW73X_cfg.py --no_exec

• Add a refitter, eg:

process.load("RecoTracker.TrackProducer.TrackRefitters_cff")
process.Refitter = process.TrackRefitterP5.clone()
process.Refitter.src = 'ctfWithMaterialTracksP5'
process.Refitter.TrajectoryInEvent = True

• Add TimingStudy module: process.TimingStudy = cms.EdAnalyzer("TimingStudy", ...
• Overwrite schedule:

process.TimingStudy_step = cms.Path(process.Refitter*process.TimingStudy)
process.schedule = cms.Schedule(process.raw2digi_step, process.reconstruction_step, process.TimingStudy_step)

2.5 Do full reco on GEN-SIM MC - Add Flat Pileup [0,50] Mixing, Refitter and TimingStudy

• Make a config file with cmsDriver.py:

cmsDriver.py -s DIGI,DIGI2RAW,RAW2DIGI,RECO --mc --conditions auto:run2_mc --pileup=NoPileUp --beamspot NominalCollision2015 --magField 38T_PostLS1 --customise SLHCUpgradeSimulations/Configuration/postLS1Customs.customisePostLS1 --process GenSimToReco --filein=file:/data/store/user/hazia/minbias_13tev/ahazi/MinBias_13TeV_GEN_SIM_7_1_0/MinBias_13TeV_GEN_SIM_7_1_0/9cb32faabd78efe327c9c841fa706583/MinBias_13TeV_GENSIM_100_1_bOe.root -n 200 --no_exec --python_filename=test/TimingStudy_GenSimData_CMSSW7X_cfg.py

• Overwrite Mixing Module process with 0-50 flat pileup

from DPGAnalysis.PixelTimingStudy.PoolSource_13Tev_Andras import *
PileupInput = FileNames
PileupHistoInput = cms.untracked.string('file:PileupHistogram_201278_flatpileupMC.root') # Flat Pileup
PileupHistoName=cms.untracked.string('mc_input')
process.mix.input = cms.SecSource("PoolSource",
    type = cms.string('histo'),
    nbPileupEvents  = cms.PSet(
        fileName = PileupHistoInput,
        histoName = PileupHistoName,
    ),
    sequential = cms.untracked.bool(False),
    manage_OOT = cms.untracked.bool(True),
    OOT_type = cms.untracked.string('Poisson'),
    fileNames = PileupInput
)

• Add a refitter, eg:

process.load("RecoTracker.TrackProducer.TrackRefitters_cff")
process.Refitter = process.TrackRefitterP5.clone()
process.Refitter.src = 'generalTracks'
process.Refitter.TrajectoryInEvent = True

• Add TimingStudy module: process.TimingStudy = cms.EdAnalyzer("TimingStudy", ...
• overwrite schedule:

process.schedule = cms.Schedule(process.digitisation_step, process.digi2raw_step, process.raw2digi_step, process.reconstruction_step, process.TimingStudy_step)

-- JanosKarancsi - 2015-02-26