Warning, /Alignment/OfflineValidation/README_PV.md is written in an unsupported language. File is not indexed.
0001 # Primary Vertex (PV) Validation
0002
0003 ## General info
0004 ```
0005 validations:
0006 PV:
0007 <step_type>:
0008 <step_name>:
0009 <options>
0010 ```
0011
0012 PV validation runs in 3 possible types of steps:
0013 - single (validation analysis by PV_cfg.py)
0014 - (optional) merge (PVmerge macro)
0015 - (optional) trends (PVtrends macro)
0016 Step name is arbitrary string which will be used as a reference for consequent steps.
0017 Merge job and trend jobs will only start if all corresponding single jobs are done.
0018 Trend and merge jobs can run in parallel.
0019 Averaged jobs are not yet implemented.
0020
0021 ## Single PV jobs
0022 Single jobs can be specified per run (IoV as well). In case of MC, IoV is specified to arbitrary 1.
0023
0024 Variable | Default value | Explanation/Options
0025 -------- | ------------- | --------------------
0026 IOV | None | List of IOVs/runs defined by integer value. IOV 1 is reserved for MC.
0027 Alignments | None | List of alignments. Will create separate directory for each.
0028 dataset | See defaultInputFiles_cff.py | Path to txt file containing list of datasets to be used. If file is missing at EOS or is corrupted - job will eventually fail (most common issue).
0029 goodlumi | cms.untracked.VLuminosityBlockRange() | Path to json file containing lumi information about selected IoV - must contain list of runs under particular IoV with lumiblock info. Format: `IOV_Vali_{}.json`
0030 maxevents | 1 | Maximum number of events before cmsRun terminates.
0031 maxtracks | 1 | Maximum number of tracks per event before next event is processed.
0032 trackcollection | "generalTracks" | Track collection to be specified here, e.g. "ALCARECOTkAlMuonIsolated" or "ALCARECOTkAlMinBias" ...
0033 tthrbuilder | "WithAngleAndTemplate" | Specify TTRH Builder
0034 usePixelQualityFlag | True | Use pixel quality flag?
0035 cosmicsZeroTesla | False | Is this validation for cosmics with zero magnetic field?
0036 vertexcollection | "offlinePrimaryVertices" | Specify vertex collection to be used.
0037 isda | True | Use DA algorithm (True) or GAP algorithm (False)
0038 ismc | True | Is validation for MC (True) or Data (False)?
0039 runboundary | 1 | Specify starting run number (can be also list of starting numbers in multirun approach).
0040 runControl | False | Enable run control
0041 ptCut | 3. | Probe tracks with pT > 3GeV
0042 etaCut | 2.5 | Probe tracks in abs(eta) < 2.5 region
0043 minPt | 1. | Define minimal track pT
0044 maxPt | 30. | Define maximum track pT
0045 doBPix | True | Do not run validation for BPix if needed
0046 doFPix | True | Do not run validation for FPix if needed
0047 forceBeamSpot | False | Force beam spot
0048 numberOfBins | 48 | Define histogram granularity
0049
0050 ## Merge PV job
0051 Its name do not need to match single job name but option `singles` must list all single jobs to be merged.
0052 PV merged plot style can be adjusted from global plotting style (see `Alignment/OfflineValidation/test/example_PV_full.yaml`)
0053
0054 Variable | Default value | Explanation/Options
0055 -------- | ------------- | --------------------
0056 singles | None | List of strings matching single job names to be merged in one plot.
0057 doMaps | false | Also plot 2D maps.
0058 stdResiduals | true | Plot std. residual plots.
0059 autoLimits | false | Take default values for limits in plotting?
0060 m_dxyPhiMax | 40 | If not take this...
0061 m_dzPhiMax | 40 | If not take this...
0062 m_dxyEtaMax | 40 | If not take this...
0063 m_dzEtaMax | 40 | If not take this...
0064 m_dxyPhiNormMax | 0.5 | If not take this...
0065 m_dzPhiNormMax | 0.5 | If not take this...
0066 m_dxyEtaNormMax | 0.5 | If not take this...
0067 m_dzEtaNormMax | 0.5 | If not take this...
0068 w_dxyPhiMax | 150 | If not take this...
0069 w_dzPhiMax | 150 | If not take this...
0070 w_dxyEtaMax | 150 | If not take this...
0071 w_dzEtaMax | 1000 | If not take this...
0072 w_dxyPhiNormMax | 1.8 | If not take this...
0073 w_dzPhiNormMax | 1.8 | If not take this...
0074 w_dxyEtaNormMax | 1.8 | If not take this...
0075 w_dzEtaNormMax | 1.8 | If not take this...
0076 customrighttitle | "" | Top right title. Reserved word "IOV" will be replaced for given IOV/run in the list.
0077
0078 ## Trends PV job
0079 Its name do not need to match single job name but option `singles` must list all single jobs to be put in trend plot.
0080 Trend plot style is defined globally for all trend plots (see `Alignment/OfflineValidation/test/example_PV_full.yaml`)
0081
0082 Variable | Default value | Explanation/Options
0083 -------- | ------------- | --------------------
0084 singles | None | List of single job names to be processed for trends.
0085 doRMS | true | Plot RMS trends.
0086 labels | None | List of string tags to be added in output rootfile.
0087 firstRun | 272930 | Specify starting run to be plotted.
0088 lastRun | 325175 | Specify the last run to be considered.
0089 nWorkers | 20 | Number of threads.
0090 doUnitTest | false | Disable certain settings for unit test.
