Marlin Processor Overview

This page lists all Marlin processors available in the Key4hep software stack, collected from the active environment. Use the search box to filter by processor name, package, or library. Click a package header to collapse or expand it; click a processor name to reveal its parameters.

Note

The table below is automatically generated from the Key4hep nightlies. It is likely to still contain some issues (e.g. in the reporting of parameter types or in the description). In case you spot something, please open an issue on key4hep/key4hep-doc (a Blank issue is enough).

Marlin to Gaudi migration

There is an ongoing effort to port existing Marlin processors to Gaudi. Please have a look at this github issue for more information about the process.

What’s on this page?

This table has been automatically collected from a Key4hep environment. Use the search box to filter by algorithm name, package, or library. Click a package header to collapse or expand it; click an algorithm name to reveal its properties. The tags denote the library name where the algorithm is found in the environment.

Processors

Total: 212 processors across 20 packages.

Showing 212 of 212 processors in 20 packages
CEDViewer 7 processors
CEDViewer libCEDViewer.so.1.21.0

CEDViewer: event display of LCIO objects - based on CED by A.Zhelezov.

Parameter Type Default Description
ColorByEnergy bool false color recunstructed particle by energy
ColorByEnergyAutoColor bool false Automatically adjust event by event the blue to min energy and red to max energy of event
ColorByEnergyBrightness double 0.8 Brigtness value that will be used to determine the pallete
ColorByEnergyMax double 35 Maximal value for energy which will be represented as red
ColorByEnergyMin double 0 Minimal value for energy which will be represented as blue
ColorByEnergySaturation double 0.8 Hue value that will be used to determine the pallete
ColorScheme int 10 color scheme to be used for drawing - see startup log MESSAGEs for options
DrawCollection StringVec CalorimeterHits 0 3 collection to be displayed ( ColName, marker type[0-2], size)
DrawDetectorID int 0 draw detector from GEAR file with given ID (see MarlinCED::newEvent() ) : 0 ILD, 1 CLIC, -1 none
DrawHelixForPFOs int 0 draw a helix for PFO objects (usefull for Si tracker): 0: disabled, 1: enabled
DrawHelixForTrack int 0 draw a helix for Track objects: -1: none, 0: default, 1: atIP, 2: atFirstHit, 3: atLastHit, 4: atCalorimeter
DrawInLayer StringVec TPCTracks 0 3 4 collection to be displayed ( ColName, marker type[0-2], size, layer)
HelixMaxR float 2000 Max R (mm) Extent for drawing Helix if UseTPCForLimitsOfHelix false
HelixMaxZ float 2500 Max Z (mm) Extent for drawing Helix if UseTPCForLimitsOfHelix false
MCParticleEnergyCut float 0.001 minimum energy of MCParticles to be drawn
ScaleLineThickness double 1 Scale the line thickness of drawn helixes
ScaleMarkerSize double 1 Scale the size of the markes
UseColorForHelixTracks int 0 draw helices in the color of the track/PFO: 0: disabled (lightgrey), 1: enabled
UseTPCForLimitsOfHelix bool true Use the gear parameters to define the max extent of drawing a helix
UsingParticleGun bool false If set true generator status is ignored for MCParticles to be drawn
WaitForKeyboard int 1 Wait for Keyboard before proceed
DDCEDViewer libCEDViewer.so.1.21.0

DDCEDViewer: event display of LCIO objects - based on CED by A.Zhelezov.

Parameter Type Default Description
ColorByEnergy bool false color recunstructed particle by energy
ColorByEnergyAutoColor bool false Automatically adjust event by event the blue to min energy and red to max energy of event
ColorByEnergyBrightness double 0.8 Brigtness value that will be used to determine the pallete
ColorByEnergyMax double 35 Maximal value for energy which will be represented as red
ColorByEnergyMin double 0 Minimal value for energy which will be represented as blue
ColorByEnergySaturation double 0.8 Hue value that will be used to determine the pallete
ColorScheme int 10 color scheme to be used for drawing - see startup log MESSAGEs for options
DetailledDrawing StringVec NameToBeDrawnDetailly List of detector names that are printed in more detail.
DrawCollection StringVec CalorimeterHits 0 3 collection to be displayed ( ColName, marker type[0-2], size)
DrawDetector bool false Call the drawDetector function else call draw function
DrawEllipsoidForPFOClusters int 0 draw an ellipsoid for the Clusters of PFO objects: 0: disabled, 1: enabled
DrawHelixForPFOs int 0 draw a helix for PFO objects (usefull for Si tracker): 0: disabled, 1: enabled
DrawHelixForTrack int 0 draw a helix for Track objects: -1: none, 0: default, 1: atIP, 2: atFirstHit, 3: atLastHit, 4: atCalorimeter
DrawInLayer StringVec TPCTracks 0 3 4 collection to be displayed ( ColName, marker type[0-2], size, layer)
DrawMCParticlesCreatedInSimulation bool false If set true MCParticles created in the simulation are also drawn. You will have to increase the MCParticleEnergyCut to reduce chaos.
DrawSurfaces bool false Draw the geometry as a set of individual surfaces (if available) instead of simplified structures.
ECalBarrelName string ECalBarrel Set the ECal barrel detector name, as defined in the geometry XML file (default: ECalBarrel)
ECalEndcapName string ECalEndcap Set the ECal endcap detector name, as defined in the geometry XML file (default: ECalEndcap)
HCalBarrelName string HCalBarrel Set the HCal barrel detector name, as defined in the geometry XML file (default: HCalBarrel)
HCalEndcapName string HCalEndcap Set the HCal endcap detector name, as defined in the geometry XML file (default: HCalEndcap)
HelixMaxR float 2000 Max R (mm) Extent for drawing Helix if UseTPCForLimitsOfHelix false
HelixMaxZ float 2500 Max Z (mm) Extent for drawing Helix if UseTPCForLimitsOfHelix false
MCParticleEnergyCut float 0.001 minimum energy of MCParticles to be drawn
ScaleLineThickness double 1 Scale the line thickness of drawn helixes
ScaleMarkerSize double 1 Scale the size of the markes
UseColorForHelixTracks int 0 draw helices in the color of the track/PFO: 0: disabled (lightgrey), 1: enabled
UseTrackerExtentForLimitsOfHelix bool true Use the gear parameters to define the max extent of drawing a helix
UsingParticleGun bool false If set true generator status is ignored for MCParticles to be drawn
WaitForKeyboard int 1 Wait for Keyboard before proceed
DSTViewer libCEDViewer.so.1.21.0

CED based event display for DST files

Parameter Type Default Description
DrawDetectorID int 0 draw detector from GEAR file with given ID (see MarlinCED::newEvent() ) : 0 ILD, -1 none
JetCollections StringVec Jet Collections Names'
LayerReco int 9 Layer for Reco Particles
MagneticField float 3.5 Magnetic Field
ParticleCollection string RecoParticles Particle Collection Name
WaitForKeyboard int 1 Wait for Keyboard before proceed
DrawCLIC libCEDViewer.so.1.21.0

DrawCLIC draws the CLIC detector in CED

Parameter Type Default Description
DrawDetector bool false Call the drawDetector function else call draw function
GenericViewer libCEDViewer.so.1.21.0

Drawing Utility

Parameter Type Default Description
CaloHitCollections StringVec ECAL HCAL Calo Hit Collection Names
ClusterCollection string ClustersAR Cluster Collection Name
DetectorModel int 0 Detector Model
LayerCaloHit int -1 Layer for Calo Hits
LayerClusters int -1 Layer for Reco Clusters
LayerReco int 9 Layer for Reco Particles
LayerSimCaloHit int -1 Layer for Sim Calo Hits
LayerSimTrackerHit int -1 Layer for Sim Tracker Hits
LayerTrackerHit int -1 Layer for Tracker Hits
LayerTracks int -1 Layer for Tracks
LayerTrueClusters int -1 Layer for True Clusters
LayerTrueTracks int -1 Layer for True Tracks
MagneticField float 4 Magnetic Field
ParticleCollection string RecoParticles Particle Collection Name
SimCaloHitCollections StringVec ecal02_EcalBarrel ecal02_EcalEndcap hcalFeRPC1_HcalBarrelEnd hcalFeRPC1_HcalBarrelReg hcalFeRPC1_HcalEndCaps Sim Calo Hit Collection Names
SimTrackerHitCollections StringVec tpc03_TPC Sim Tracker Hit Collection Names
TrackCollection string TPC_Tracks Track Collection Name
TrackerHitCollections StringVec TPCTrackerHits Tracker Hit Collection Names
TrueClusterCollection string TrueClusters True Cluster Collection Name
TrueTrackCollection string TrueTracks True Track Collection Name
WaitForKeyboard int 1 Wait for Keyboard before proceed
HEP_RecordProcessor libCEDViewer.so.1.21.0

HEP record balance and drawing

No parameters available.
VertexViewer libCEDViewer.so.1.21.0

Vertex Drawing Utility

Parameter Type Default Description
CutOnD0 float 1e+20 Cut On D0
CutOnZ0 float 1e+20 Cut On Z0
DetectorModel int 0 Detector Model
LayerSimTrackerHits int -1 Layer for SimTrackerHits
LayerTrackerHits int -1 Layer for TrackerHits
LayerTracks int -1 Layer for Tracks
LayerTrueTracks int -1 Layer for True Tracks
SimTrakerHitCollection StringVec VXDCollection SimTrakerHit Collection Name
TrackCollection string SiTracks Track Collection Name
TrackMCPRelCollection string SiTracksMCP Track MCP Rel Collection Name
TrackerHitCollection StringVec VTXTrackerHits FTDTrackerHits SITTrackerHits TPCTrackerHits TrackerHit Collection Name
TrueTrackCollection string TrueTracks True Track Collection Name
TrueTrackMCPRelCollection string TrueTracksMCP True Track MCP Relation Collection Name
CLICPerformance 8 processors
CLICRecoConfig libClicPerformance.so.2.5.1

CLICRecoConfig allows one to configure the processors to run via command line

Parameter Type Default Description
BeamCal string 3TeV Which option to use for BeamCal: 3TeV, 380GeV. Then use, e.g., Config.BeamCal3TeV in the condition
BeamCalChoices StringVec 3TeV 380GeV Possible values and conditions for option BeamCal
Overlay string False Which option to use for Overlay: False, 91GeV, 350GeV, 365GeV, 380GeV, 420GeV, 500GeV, 1.4TeV, 3TeV. Then use, e.g., Config.OverlayFalse in the condition
OverlayChoices StringVec False 91GeV 350GeV 365GeV 380GeV 420GeV 500GeV 1.4TeV 3TeV Possible values and conditions for option Overlay
Tracking string Conformal Which option to use for Tracking: Truth, Conformal. Then use, e.g., Config.TrackingConformal in the condition
TrackingChoices StringVec Truth Conformal Possible values and conditions for option Tracking
VertexUnconstrained string OFF Which option to use for VertexUnconstrained: ON, OFF. Then use, e.g., Config.VertexUnconstrainedOFF in the condition
VertexUnconstrainedChoices StringVec ON OFF Possible values and conditions for option VertexUnconstrained
ClicEfficiencyCalculator libClicPerformance.so.2.5.1

ClicEfficiencyCalculator calculates the tracking efficiency and makes some performance plots

Parameter Type Default Description
EfficientMCParticleCollectionName string EfficientMCParticles MC Particle Collection Name for particles reconstructed
InefficientMCParticleCollectionName string InefficientMCParticles MC Particle Collection Name for particles not reconstructed
MCParticleCollectionName string MCParticle Name of the MCParticle input collection
MCPhysicsParticleCollectionName string MCPhysicsParticle Name of the MCPhysicsParticle input collection
TrackCollectionName string CATracks Track collection name
TrackerHitCollectionNames StringVec VXDTrackerHits VXDEndcapTrackerHits ITrackerHits OTrackerHits ITrackerEndcapHits OTrackerEndcapHits Name of the TrackerHit input collections
TrackerHitRelCollectionNames StringVec VXDTrackerHitRelations VXDEndcapTrackerHitRelations InnerTrackerBarrelHitsRelations OuterTrackerBarrelHitsRelations InnerTrackerEndcapHitsRelations OuterTrackerEndcapHitsRelations Name of TrackerHit relation collections
debugPlots bool true If true additional plots (n of hits per subdetector per mc particle, mc theta, mc pt, info if the particle is decayed in the tracker) will be added to the Ntuple mctree
efficiencyTreeName string trackTree Name of the efficiency tree
mcTreeName string mctree Name of the mc tree
perfTreeName string perfTree Name of the track performance tree
purityTreeName string purityTree Name of the purity tree
reconstructableDefinition string NHits Set of cuts to define 'reconstructable' particles for eff computation. The options are: NHits, NHitsVXD, ILDLike, AnyGenStatus, AnyGenStatusLowPt, SingleMu
simpleOutput bool true A simplified tree can be output with the MC particle properties, including whether or not it was reconstructed
ClicTrackingValidate libClicPerformance.so.2.5.1

ClicTrackingValidate makes use of MC information at particle and hit level and compares the reconstructed hits and tracks to validate the tracking

Parameter Type Default Description
MCParticleCollectionName string MCParticle Name of the MCParticle input collection
SiTrackCollectionName string SiTracks Name of the silicon track collection
SimTrackerHitCollectionNames StringVec VertexBarrelCollection VertexEndcapCollection InnerTrackerBarrelCollection InnerTrackerEndcapCollection OuterTrackerBarrelCollection OuterTrackerEndcapCollection Name of the SimTrackerHit input collections
SimTrackerHitRelCollectionNames StringVec VXDTrackerHitRelations VXDEndcapTrackerHitRelations InnerTrackerBarrelHitsRelations OuterTrackerBarrelHitsRelations InnerTrackerEndcapHitsRelations OuterTrackerEndcapHitsRelations Name of the TrackerHit - SimTrackerHit relation collections
TrackerHitCollectionNames StringVec VXDTrackerHits VXDEndcapTrackerHits ITrackerHits OTrackerHits ITrackerEndcapHits OTrackerEndcapHits Name of the TrackerHit input collections
trackingTreeName string trackingTree Name of the tracking validation tree
HitResiduals libClicPerformance.so.2.5.1

HitResiduals plots te residual between the track fit and the hit in the local coordinate system u,v,w.

Parameter Type Default Description
EnergyLossOn bool true Use Energy Loss in Fit
MaxChi2Increment double 1000 Maximum increment allowed for the chi2
MultipleScatteringOn bool true Use MultipleScattering in Fit
SmoothOn bool false Smooth All Mesurement Sites in Fit
TrackCollectionName string RefittedTracks Name of the input track collection
outFileName string residuals.root Name of the output root file
treeName string tree Name of the tree
JetAnalyzer libClicPerformance.so.2.5.1

JetAnalyzer calculates properties of calorimeter showers

Parameter Type Default Description
GenJetCollection string GenJet_VLC Name of the GenJet collection
MCParticleCollectionName string MCPhysicsParticles Name of the MCParticle input collection
OutputRootFileName string JetAnalyzer.root ROOT File name to collect plots
RECOParticleCollectionName string PandoraPFOs Name of the RECOParticle input collection
RecoJetCollection string RecoJet_VLC Name of the RecoJet collection
doDiBosonChecks bool false MC truth diboson checks for on-shell bosons
fillMEInfo bool false save matrix element information
ShowerStudy libClicPerformance.so.2.5.1

ShowerStudy calculates properties of calorimeter showers

Parameter Type Default Description
CalorimeterHitCollection string ECALBarrel CalorimeterHit collection name
ECalLayerThreshold int 100 Layer number where thickness changes
LeakageCalorimeterHitCollection string HCALBarrel CalorimeterHit collection name for leakage energy
MCParticleCollectionName string MCParticle Name of the MCParticle input collection
OutputRootFileName string showerStudy.root ROOT File name to collect plots
TrackChecker libClicPerformance.so.2.5.1

TrackChecker plots pull distributions, track resolution parameters and reconstruction efficiencies

Parameter Type Default Description
MCParticleCollectionName string MCParticle Name of the MCParticle input collection
TrackCollectionName string RefittedTracks Track collection name
TrackRelationCollectionName string RefittedTracksMCTruthLink Track relation collection name
TreeName string perftree Name of the root tree
UseOnlyTree bool true Flag to fill only tree variables or also histogram version of pulls and residuals
TrueMCintoRecoForJets libClicPerformance.so.2.5.1

TrueMCintoRecoForJets calculates properties of calorimeter showers

Parameter Type Default Description
MCParticleInputCollectionName string MCPhysicsParticles Name of the MCParticle input collection
RECOParticleCollectionName string MCParticlePandoraPFOs Name of the RECOParticle output collection
RecoParticleInputCollectionName string TightSelectedPandoraPFOs Name of the RecoParticle input collection
RecoParticleNoLeptonCollectionName string PandoraPFOsNoLeptons Name of the RecoParticleNoLepton output collection
cosAngle_pfo_lepton float 0.995 matching angle between PFOs and MC leptons from vector bosons
ignoreNeutrinosInMCJets bool true remove neutrinos prior to MC Jet Clustering
vetoBosonLeptons bool false leptons from boson veto flag for MC truth
vetoBosonLeptonsOnReco bool false leptons from boson veto flag for Reco
Clupatra 4 processors
ClupatraProcessor libClupatra.so.1.4.0

ClupatraProcessor : nearest neighbour clustering seeded pattern recognition

Parameter Type Default Description
CaloFaceBarrelID int 20 system ID of the subdetector at the calorimeter face in the barrel - default: lcio::ILDDetID::ECAL=20
CaloFaceEndcapID int 29 system ID of the subdetector at the calorimeter face in the endcap - default: lcio::ILDDetID::ECAL=29
Chi2Cut float 100 the maximum chi2-distance for which a hit is considered for merging
CosAlphaCut float 1 Cut for max.angle between hits in consecutive layers for seed finding - NB value should be smaller than 1 - default is 0.9999999 !!!
CreateDebugCollections bool false optionally create some debug collection with intermediate track segments and used and unused hits
DistanceCut float 40 Cut for distance between hits in mm for the seed finding
DuplicatePadRowFraction float 0.1 allowed fraction of hits in same pad row per track
EnergyLossOn bool true Use Energy Loss in Fit
MaxDeltaChi2 float 35 the maximum delta Chi2 after filtering for which a hit is added to a track segement
MaxStepWithoutHit int 3 the maximum number of layers without finding a hit before hit search search is stopped
MinLayerFractionWithMultiplicity float 0.5 minimum fraction of layers that have a given multiplicity, when forcing a cluster into sub clusters
MinLayerNumberWithMultiplicity int 3 minimum number of layers that have a given multiplicity, when forcing a cluster into sub clusters
MinimumClusterSize int 6 minimum number of hits per cluster
MultipleScatteringOn bool true Use MultipleScattering in Fit
NLoopForSeeding int 4 number of seed finding loops - every loop increases the distance cut by DistanceCut/NLoopForSeeding
NumberOfZBins int 150 number of bins in z over total length of TPC - hits from different z bins are nver merged
OutputCollection string ClupatraTracks Name of the output collection with final TPC tracks
PadRowRange int 12 number of pad rows used in initial seed clustering
SITDetectorName string SIT name of the SIT-like inner Si-tracking barrel detector
SITHitCollection string SITTrackerHits name of the SIT hit collections - used to extend TPC tracks if (pickUpSiHits==true)
SegmentCollectionName string ClupatraTrackSegments Name of the output collection that has the individual track segments
SmoothOn bool false Smooth All Mesurement Sites in Fit
TPCHitCollection string AllTPCTrackerHits Name of the tpc hit input collections
TrackEndsOuterCentralDist float 25 maximum radial distance [mm] from outer field cage of last hit, such that the track is considered to end at the end
TrackEndsOuterForwardDist float 40 maximum distance in z [mm] from endplate of last hit, such that the track is considered to end at the end
TrackIsCurlerOmega float 0.001 minimum curvature omega of a track segment for being considered a curler
TrackStartsInnerDist float 25 maximum radial distance [mm] from inner field cage of first hit, such that the track is considered to start at the beginning
TrackSystemName string DDKalTest Name of the track fitting system to be used ( DDKalTest, aidaTT, ... )
VXDDetectorName string VXD name of the VXD-like inner Si-tracking barrel detector
VXDHitCollection string VTXTrackerHits name of the VXD hit collections - used to extend TPC tracks if (pickUpSiHits==true)
pickUpSiHits bool false try to pick up hits from Si-trackers
DebugDigiProcessor libClupatra.so.1.4.0

DebugDigiProcessor: analysis plots for Tracks

Parameter Type Default Description
SubDetectorIDs IntVec 4 The IDs of the subdetectors corresponding to the hit collections in TrackerHitCollectionNames
TrackCollection string TrackCollection Name of the input collections with Tracks
TrackerHitCollections StringVec TPCTrackerHits The tracker hit collection names - needs to run parallel to SubDetectorIDs
TrackCheckMCTruth libClupatra.so.1.4.0

TrackCheckMCTruth: analysis plots for Tracks

Parameter Type Default Description
HitFractionMerged float 0.05 maximal fractions of hits that are allowed to be missing for a merged track
HitFractionSplit float 0.05 maximal fractions of hits that are allowed to be missing for a split track
MCPTrackRelation string MCPTrkRelation Name of the input collections with LCRelation MCParticles to tracks
MCParticlesCollection string MCParticlesSkimmed Name of the input collections with MCParticles
MergedTrackCollection string ClupatraMergedTracks Name of the output collections with merged Tracks
PtRange FloatVec 0 1000 Min and max value of pt range [GeV]
SimTrackerHitCollection StringVec TPCCollection Name of the input collections with SimTrackerHits
SplitTrackCollection string ClupatraSplitTracks Name of the output collections with split Tracks
TrackCollection string ClupatraTracks Name of the input collections with Tracks
TrackMCPRelation string TrackRelation Name of the input collections with LCRelation Tracks to MCParticles
TrackEfficiency libClupatra.so.1.4.0

TrackEfficiency: analysis plots for Tracks

Parameter Type Default Description
CosThetaCut double 0.99 Maximum costheta of examined MCParticles sample
DistFromIP double 100 Maximum distance from IP of examined MCParticles sample (in mm)
MCParticlesCollection string MCParticlesSkimmed Name of the input collections with MCParticles
MCTruthTrackRelation string MCTruthTrackRelation Name of the input collections with LCRelation MCParticles to Tracks
PCut double 1 Minimum momentum of examined MCParticles sample (in GeV)
PTCut double 0.1 Minimum transverse momentum of examined MCParticles sample (in GeV)
PhysSampleOn bool false Enable when we run diagnostics to a simulated physics sample
PtRange FloatVec 0 1000 Min and max value of pt range [GeV]
RequiredPurity double 0.75 ratio of hits belonging to the dominant MC particle to total number of track hits
RequiredSiHits int 4 minimum required hits on Si detectors in order to consider the track found
SimTrackerHitCollection string TPCCollection Name of the input collections with SimTrackerHits
TrackCollection string TrackCollection Name of the input collections with Tracks
TrackMCTruthRelation string TrackMCTruthRelation Name of the input collections with LCRelation Tracks to MCParticles
ConformalTracking 2 processors
ConformalTracking libConformalTracking.so.1.12.1

ConformalTracking constructs tracks using a combined conformal mapping and cellular automaton approach.

Parameter Type Default Description
DebugHits string DebugHits DebugHits
DebugPlots bool false Plots for debugging the tracking
DebugTiming bool false Print out time profile
EnableTightCutsVertexCombined bool true Enabled tight cuts as first step of reconstruction in vertex b+e [TMP!!]
HighPTCut double 10 pT threshold (in GeV) for enabling extendHighPT in extendTracks
MCParticleCollectionName string MCParticle Name of the MCParticle input collection
MainTrackerHitCollectionNames StringVec ITrackerHits OTrackerHits ITrackerEndcapHits OTrackerEndcapHits Name of the TrackerHit input collections from the Main Tracker
MaxCellAngle double 0.035 Cut on angle between two cells for cell to be valid
MaxCellAngleRZ double 0.035 Cut on angle between two cells in RZ for cell to be valid
MaxChi2 double 300 Maximum chi2/ndof for linear conformal tracks
MaxDistance double 0.015 Maximum length of a cell (max. distance between two hits)
MaxHitInvertedFit int 0 Maximum number of track hits to try the inverted fit
MinClustersOnTrack int 6 Minimum number of clusters to create a track in pattern recognition
MinClustersOnTrackAfterFit int 4 Final minimum number of track clusters
RelationsNames StringVec VXDTrackerHitRelations VXDEndcapTrackerHitRelations InnerTrackerBarrelHitsRelations OuterTrackerBarrelHitsRelations InnerTrackerEndcapHitsRelations OuterTrackerEndcapHitsRelations Name of the TrackerHit relation collections
RetryTooManyTracks bool true retry with tightened parameters, when too many tracks are being created
SiTrackCollectionName string CATracks Silicon track Collection Name
SortTreeResults bool true sort results from kdtree search
ThetaRange double 0.1 Angular range for initial cell seeding
TooManyTracks int 500000 Number of tracks that is considered too many
TrackerHitCollectionNames StringVec VXDTrackerHits VXDEndcapTrackerHits ITrackerHits OTrackerHits ITrackerEndcapHits OTrackerEndcapHits Name of the TrackerHit input collections
VertexBarrelHitCollectionNames StringVec VXDTrackerHits Name of the TrackerHit input collections from the Vertex Barrel
VertexEndcapHitCollectionNames StringVec VXDEndcapTrackerHits Name of the TrackerHit input collections from the Vertex Endcap
trackPurity double 0.75 Purity value used for checking if tracks are real or not
ConformalTrackingV2 libConformalTracking.so.1.12.1

ConformalTrackingV2 constructs tracks using a combined conformal mapping and cellular automaton approach.

Parameter Type Default Description
DebugHits string DebugHits DebugHits
DebugPlots bool false Plots for debugging the tracking
DebugTiming bool false Print out time profile
MCParticleCollectionName string MCParticle Name of the MCParticle input collection
MaxHitInvertedFit int 0 Maximum number of track hits to try the inverted fit
MinClustersOnTrackAfterFit int 4 Final minimum number of track clusters
RelationsNames StringVec VXDTrackerHitRelations VXDEndcapTrackerHitRelations InnerTrackerBarrelHitsRelations OuterTrackerBarrelHitsRelations InnerTrackerEndcapHitsRelations OuterTrackerEndcapHitsRelations Name of the TrackerHit relation collections
RetryTooManyTracks bool true retry with tightened parameters, when too many tracks are being created
SiTrackCollectionName string CATracks Silicon track Collection Name
SortTreeResults bool true sort results from kdtree search
Steps StringVec [VXDBarrel] @Collections : VXDTrackerHits @Parameters : MaxCellAngle : 0.005; MaxCellAngleRZ : 0.005; Chi2Cut : 100; MinClustersOnTrack : 4; MaxDistance : 0.02; HighPTCut : 10.0; @Flags : HighPTFit, VertexToTracker @Functions : CombineCollections, BuildNewTracks [VXDEncap] @Collections : VXDEndcapTrackerHits @Parameters : MaxCellAngle : 0.005; MaxCellAngleRZ : 0.005; Chi2Cut : 100; MinClustersOnTrack : 4; MaxDistance : 0.02; HighPTCut : 10.0; @Flags : HighPTFit, VertexToTracker @Functions : CombineCollections, ExtendTracks [LowerCellAngle1] @Collections : VXDTrackerHits, VXDEndcapTrackerHits @Parameters : MaxCellAngle : 0.025; MaxCellAngleRZ : 0.025; Chi2Cut : 100; MinClustersOnTrack : 4; MaxDistance : 0.02; HighPTCut : 10.0; @Flags : HighPTFit, VertexToTracker, RadialSearch @Functions : CombineCollections, BuildNewTracks [LowerCellAngle2] @Collections : @Parameters : MaxCellAngle : 0.05; MaxCellAngleRZ : 0.05; Chi2Cut : 2000; MinClustersOnTrack : 4; MaxDistance : 0.02; HighPTCut : 10.0; @Flags : HighPTFit, VertexToTracker, RadialSearch @Functions : BuildNewTracks, SortTracks [Tracker] @Collections : ITrackerHits, OTrackerHits, ITrackerEndcapHits, OTrackerEndcapHits @Parameters : MaxCellAngle : 0.05; MaxCellAngleRZ : 0.05; Chi2Cut : 2000; MinClustersOnTrack : 4; MaxDistance : 0.02; HighPTCut : 1.0; @Flags : HighPTFit, VertexToTracker, RadialSearch @Functions : CombineCollections, ExtendTracks [Displaced] @Collections : VXDTrackerHits, VXDEndcapTrackerHits, ITrackerHits, OTrackerHits, ITrackerEndcapHits, OTrackerEndcapHits @Parameters : MaxCellAngle : 0.05; MaxCellAngleRZ : 0.05; Chi2Cut : 1000; MinClustersOnTrack : 5; MaxDistance : 0.015; HighPTCut : 10.0; @Flags : OnlyZSchi2cut, RadialSearch @Functions : CombineCollections, BuildNewTracks Steps
ThetaRange double 0.1 Angular range for initial cell seeding
TooManyTracks int 500000 Number of tracks that is considered too many
TrackerHitCollectionNames StringVec VXDTrackerHits VXDEndcapTrackerHits ITrackerHits OTrackerHits ITrackerEndcapHits OTrackerEndcapHits Name of the TrackerHit input collections
trackPurity double 0.75 Purity value used for checking if tracks are real or not
DDMarlinPandora 3 processors
DDCaloDigi libDDMarlinPandora.so.0.14.0

Performs simple digitization of sim calo hits...

Parameter Type Default Description
CalibECALMIP float 0.0001 calibration to convert ECAL deposited energy to MIPs
CalibHCALMIP float 0.0001 calibration to convert HCAL deposited energy to MIPs
CalibrECAL FloatVec 40.91 81.81 Calibration coefficients for ECAL
CalibrHCALBarrel FloatVec 0 Calibration coefficients for Barrel HCAL
CalibrHCALEndcap FloatVec 0 Calibration coefficients for EndCap HCAL
CalibrHCALOther FloatVec 0 Calibration coefficients for Other (Ring) HCAL
ECALBarrelTimeWindowMax float 100 ECAL BarrelTime Window maximum time in ns
ECALCollections StringVec EcalBarrelCollection EcalEndcapCollection EcalRingCollection ECAL Collection Names
ECALCorrectTimesForPropagation int 0 Correct ECAL hit times for propagation: radial distance/c
ECALDeltaTimeHitResolution float 10 ECAL Minimum Delta Time in ns for resolving two hits
ECALEndcapCorrectionFactor float 1.025 Energy correction for ECAL endcap
ECALEndcapTimeWindowMax float 100 ECAL Endcap Time Window maximum time in ns
ECALGapCorrection int 1 Correct for ECAL gaps
ECALGapCorrectionFactor float 1 Factor applied to gap correction
ECALLayers IntVec 20 100 Index of ECal Layers
ECALModuleGapCorrectionFactor float 0.5 Factor applied to module gap correction
ECALOutputCollection0 string ECALBarrel ECAL Collection of real Hits
ECALOutputCollection1 string ECALEndcap ECAL Collection of real Hits
ECALOutputCollection2 string ECALOther ECAL Collection of real Hits
ECALSimpleTimingCut bool true Use simple time window cut on hit times? If false: use original hit-time clustering algorithm. If true: use time window defined by ECALBarrelTimeWindowMin and ECALBarrelTimeWindowMax
ECALThreshold float 5e-05 Threshold for ECAL Hits in GeV
ECALThresholdUnit string GeV Unit for ECAL Threshold. Can be "GeV", "MIP" or "px". MIP and px need properly set calibration constants
ECALTimeResolution float 10 ECAL Time Resolution used to smear hit times
ECALTimeWindowMin float -10 ECAL Time Window minimum time in ns
ECAL_PPD_N_Pixels int 10000 ECAL total number of MPPC/SiPM pixels for implementation of saturation effect
ECAL_PPD_N_Pixels_uncertainty float 0.05 ECAL fractional uncertainty of effective total number of MPPC/SiPM pixels
ECAL_PPD_PE_per_MIP float 7 # Photo-electrons per MIP (scintillator): used to poisson smear #PEs if >0
ECAL_apply_realistic_digi int 0 apply realistic digitisation to ECAL hits? (0=none, 1=silicon, 2=scintillator)
ECAL_deadCellRate float 0 ECAL random dead cell fraction (as a fraction: 0->1)
ECAL_deadCell_memorise bool false store dead ECAL cells in memory? (WARNING: can take a lot of memory if used...)
ECAL_default_layerConfig string 000000000000000 default ECAL layer configuration (used if not found in gear file)
ECAL_elec_noise_mips float 0 typical electronics noise (ECAL, in MIP units)
ECAL_maxDynamicRange_MIP float 2500 maximum of dynamic range for ECAL (in MIPs)
ECAL_miscalibration_correl float 0 correlated ECAL random gaussian miscalibration (as a fraction: 1.0 = 100%)
ECAL_miscalibration_uncorrel float 0 uncorrelated ECAL random gaussian miscalibration (as a fraction: 1.0 = 100%)
ECAL_miscalibration_uncorrel_memorise bool false store oncorrelated ECAL miscalbrations in memory? (WARNING: can take a lot of memory if used...)
ECAL_pixel_spread float 0.05 variation of mppc/sipm pixels capacitance in ECAL (as a fraction: 0.01=1%)
ECAL_strip_absorbtionLength float 1e+06 length scale for absorbtion along scintillator strip (mm)
HCALBarrelTimeWindowMax float 100 HCAL Time Window maximum time in ns
HCALCollections StringVec HcalBarrelRegCollection HcalEndcapRingsCollection HcalEndcapsCollection HCAL Collection Names
HCALCorrectTimesForPropagation int 0 Correct HCAL hit times for propagation: radial distance/c
HCALDeltaTimeHitResolution float 10 HCAL Minimum Delta Time in ns for resolving two hits
HCALEndcapCorrectionFactor float 1.025 Energy correction for HCAL endcap
HCALEndcapTimeWindowMax float 100 HCAL Time Window maximum time in ns
HCALGapCorrection int 1 Correct for ECAL gaps
HCALLayers IntVec 100 Index of HCal Layers
HCALModuleGapCorrectionFactor float 0.5 Factor applied to module gap correction
HCALOutputCollection0 string HCALBarrel HCAL Collection of real Hits
HCALOutputCollection1 string HCALEndcap HCAL Collection of real Hits
HCALOutputCollection2 string HCALOther HCAL Collection of real Hits
HCALSimpleTimingCut bool true Use simple time window cut on hit times? If false: use original hit-time clustering algorithm. If true: use time window defined by HCALBarrelTimeWindowMin and HCALBarrelTimeWindowMax
HCALThreshold FloatVec 4e-05 Threshold for HCAL Hits in GeV
HCALThresholdUnit string GeV Unit for HCAL Threshold. Can be "GeV", "MIP" or "px". MIP and px need properly set calibration constants
HCALTimeResolution float 10 HCAL Time Resolution used to smear hit times
HCALTimeWindowMin float -10 HCAL Time Window minimum time in ns
HCAL_PPD_N_Pixels int 400 HCAL total number of MPPC/SiPM pixels for implementation of saturation effect
HCAL_PPD_N_Pixels_uncertainty float 0.05 HCAL fractional uncertainty of effective total number of MPPC/SiPM pixels
HCAL_PPD_PE_per_MIP float 10 # Photo-electrons per MIP (for AHCAL): used to poisson smear #PEs if >0
HCAL_apply_realistic_digi int 0 apply realistic digitisation to HCAL hits? (0=none, 1=scintillator/SiPM)
HCAL_deadCellRate float 0 HCAL random dead cell fraction (as a fraction: 0->1)
HCAL_deadCell_memorise bool false store dead HCAL cells in memory? (WARNING: can take a lot of memory if used...)
HCAL_elec_noise_mips float 0 typical electronics noise (HCAL, in MIP units)
HCAL_maxDynamicRange_MIP float 200 maximum of dynamic range for HCAL (in MIPs)
HCAL_miscalibration_correl float 0 correlated HCAL random gaussian miscalibration (as a fraction: 1.0 = 100%)
HCAL_miscalibration_uncorrel float 0 uncorrelated HCAL random gaussian miscalibration (as a fraction: 1.0 = 100%)
HCAL_miscalibration_uncorrel_memorise bool false store oncorrelated HCAL miscalbrations in memory? (WARNING: can take a lot of memory if used...)
HCAL_pixel_spread float 0 variation of mppc/sipm pixels capacitance in HCAL (as a fraction: 0.01=1%)
Histograms int 0 Hit times histograms
IfDigitalEcal int 0 Digital Ecal
IfDigitalHcal int 0 Digital Hcal
MapsEcalCorrection int 0 Ecal correction for theta dependency of calibration for MAPS
RelationOutputCollection string RelationCaloHit CaloHit Relation Collection
StripEcal_default_nVirtualCells int 9 default number of virtual cells (used if not found in gear file)
UseEcalTiming int 0 Use ECAL hit times
UseHcalTiming int 1 Use HCAL hit times
energyPerEHpair float 3.6 energy required to create e-h pair in silicon (in eV)
DDPandoraPFANewProcessor libDDMarlinPandora.so.0.14.0

Pandora reconstructs clusters and particle flow objects

Parameter Type Default Description
ClusterCollectionName string PandoraPFANewClusters Cluster Collection Name
CreateGaps bool true Decides whether to create gaps in the geometry (ILD-specific)
CurvatureToMomentumFactor float 0.00015 Constant relating track curvature in b field to momentum
D0TrackCut float 50 Track d0 cut used to determine whether track can be used to form pfo
D0UnmatchedVertexTrackCut float 5 d0 cut used to determine whether unmatched vertex track can form pfo
DetectorName string The name of the detector
DigitalMuonHits int 1 Treat muon hits as digital
ECALInputEnergyCorrectionPoints FloatVec The input energy points for electromagnetic energy correction
ECALOutputEnergyCorrectionPoints FloatVec The output energy points for electromagnetic energy correction
ECalBarrelNormalVector FloatVec 0 0 1 Normal vector for the ECal barrel sensitive layers in local coordinates
ECalCaloHitCollections StringVec Name of the ECAL calo hit collections
ECalMipThreshold float 0 Threshold for creating calo hits in the ECal, units mip
ECalScMipThreshold float 0 Threshold for creating calo hits in the Sc-layers of ECAL, units mip
ECalScToEMGeVCalibration float 1 The calibration from deposited Sc-layer energy to EM energy
ECalScToHadGeVCalibrationBarrel float 1 The calibration from deposited Sc-layer energy to the barrel hadronic energy
ECalScToHadGeVCalibrationEndCap float 1 The calibration from deposited Sc-layer energy on the endcaps to hadronic energy
ECalScToMipCalibration float 1 The calibration from deposited Sc-layer energy to mip
ECalSiMipThreshold float 0 Threshold for creating calo hits in the Si-layers of ECAL, units mip
ECalSiToEMGeVCalibration float 1 The calibration from deposited Si-layer energy to EM energy
ECalSiToHadGeVCalibrationBarrel float 1 The calibration from deposited Si-layer energy on the barrel to hadronic energy
ECalSiToHadGeVCalibrationEndCap float 1 The calibration from deposited Si-layer energy on the enecaps to hadronic energy
ECalSiToMipCalibration float 1 The calibration from deposited Si-layer energy to mip
ECalToEMGeVCalibration float 1 The calibration from deposited ECal energy to EM energy
ECalToHadGeVCalibrationBarrel float 1 The calibration from deposited ECal energy to hadronic energy
ECalToHadGeVCalibrationEndCap float 1 The calibration from deposited ECal energy to hadronic energy
ECalToMipCalibration float 1 The calibration from deposited ECal energy to mip
EMConstantTerm float 0.01 The constant term for EM shower
EMStochasticTerm float 0.17 The stochastic term for EM shower
FinalEnergyDensityBin float 30 The software compensation final energy density bins for Pandora energy correction
HCalBarrelNormalVector FloatVec 0 0 1 Normal vector for the HCal barrel sensitive layers in local coordinates
HCalCaloHitCollections StringVec Name of the HCAL calo hit collections
HCalMipThreshold float 0 Threshold for creating calo hits in the HCal, units mip
HCalToEMGeVCalibration float 1 The calibration from deposited HCal energy to EM energy
HCalToHadGeVCalibration float 1 The calibration from deposited HCal energy to hadronic energy
HCalToMipCalibration float 1 The calibration from deposited HCal energy to mip
HadConstantTerm float 0.03 The constant term for Hadronic shower
HadStochasticTerm float 0.6 The stochastic term for Hadronic shower
InputEnergyCorrectionPoints FloatVec The input energy points for hadronic energy correction
KinkVertexCollections StringVec Name of external kink Vertex collections
LCalCaloHitCollections StringVec Name of the LCAL calo hit collections
LHCalCaloHitCollections StringVec Name of the LHCAL calo hit collections
LayersFromEdgeMaxRearDistance float 250 Maximum number of layers from candidate outer layer hit to rear of detector
MCParticleCollections StringVec Name of mc particle collections
MaxBarrelTrackerInnerRDistance float 50 Track cut on distance from BarrelTracker inner r to id whether track can form pfo
MaxClusterEnergyToApplySoftComp float 100 The maximum hadronic energy to apply software compensation in Pandora energy correction
MaxHCalHitHadronicEnergy float 10000 The maximum hadronic energy allowed for a single hcal hit
MaxTrackHits int 5000 Track quality cut: the maximum number of track hits
MaxTrackSigmaPOverP float 0.15 Cut on fractional track momentum error
MinBarrelTrackerHitFractionOfExpected float 0.2 Cut on fractional of expected number of BarrelTracker hits
MinCleanCorrectedHitEnergy float 0.1 The minimum correction to on ecal hit in Pandora energy correction
MinCleanHitEnergy float 0.5 The minimum hit energy to apply ecal correction in Pandora energy correction
MinCleanHitEnergyFraction float 0.01 The minimum hit energy fraction to apply ecal correction in Pandora energy correction
MinFtdHitsForBarrelTrackerHitFraction int 2 Cut on minimum number of FTD hits of BarrelTracker hit fraction to be applied
MinFtdTrackHits int 0 Track quality cut: the minimum number of ftd track hits for ftd only tracks
MinMomentumForTrackHitChecks float 1 Min track momentum required to perform final quality checks on number of hits
MinTrackECalDistanceFromIp float 100 Sanity check on separation between ip and track projected ecal position
MinTrackHits int 5 Track quality cut: the minimum number of track hits
MuonBarrelBField float -1.5 The bfield in the muon barrel, units Tesla
MuonCaloHitCollections StringVec Name of the muon calo hit collections
MuonEndCapBField float 0.01 The bfield in the muon endcap, units Tesla
MuonHitEnergy float 0.5 The energy for a digital muon calorimeter hit, units GeV
MuonToMipCalibration float 1 The calibration from deposited Muon energy to mip
NOuterSamplingLayers int 3 Number of layers from edge for hit to be flagged as an outer layer hit
OutputEnergyCorrectionPoints FloatVec The output energy points for hadronic energy correction
PFOCollectionName string PandoraPFANewPFOs PFO Collection Name
PandoraSettingsXmlFile string The pandora settings xml file
ProngVertexCollections StringVec Name of external prong Vertex collections
ReachesECalBarrelTrackerOuterDistance float -100 Max distance from track to BarrelTracker r max to id whether track reaches ecal
ReachesECalBarrelTrackerZMaxDistance float -50 Max distance from track to BarrelTracker z max to id whether track reaches ecal
ReachesECalFtdZMaxDistance float 1 Max distance from track hit to ftd z position to identify ftd hits
ReachesECalMinFtdLayer int 9 Min FTD layer for track to be considered to have reached ecal
ReachesECalNBarrelTrackerHits int 11 Minimum number of BarrelTracker hits to consider track as reaching ecal
ReachesECalNFtdHits int 4 Minimum number of ftd hits to consider track as reaching ecal
RelCaloHitCollections StringVec SimCaloHit to CaloHit Relations Collection Name
RelTrackCollections StringVec Track to MCParticle Relations Collection Name
ShouldFormTrackRelationships int 1 Whether to form pandora track relationships using v0 and kink info
SoftwareCompensationEnergyDensityBins FloatVec 0 2 5 7.5 9.5 13 16 20 23.5 28 The 10 software compensation density bins for Pandora energy correction
SoftwareCompensationWeights FloatVec 2.49632 -0.0697302 0.000946986 -0.112311 0.0028182 -9.62602e-05 0.168614 0.224318 -0.0872853 The 9 software compensation weights for Pandora energy correction
SplitVertexCollections StringVec Name of external split Vertex collections
StartVertexAlgorithmName string PandoraPFANew The algorithm name for filling start vertex
StartVertexCollectionName string PandoraPFANewStartVertices Start Vertex Collection Name
StripSplittingOn int 0 To use strip splitting algorithm, this should be true
TrackCollections StringVec Names of the Track collections used for clustering
TrackCreatorName string DDTrackCreatorCLIC The name of the DDTrackCreator implementation
TrackStateTolerance float 0 Distance of possible second track state in the ECal Endcap to the ECal barrel inner radius
TrackSystemName string DDKalTest Name of the track fitting system to be used (KalTest, DDKalTest, aidaTT, ... )
UnmatchedVertexTrackMaxEnergy float 5 Maximum energy for unmatched vertex track
UseAPRIL bool false Whether to use APRIL instead of Pandora for the reconstruction
UseAPRIL_Calo bool false Whether to use APRIL instead of Pandora for the reconstruction
UseDD4hepField bool false Whether to use the BField map from DD4hep
UseEcalScLayers int 0 To use scintillator layers ~ hybrid ECAL, this should be true
UseNonVertexTracks int 1 Whether can form pfos from tracks that don't start at vertex
UseUnmatchedNonVertexTracks int 0 Whether can form pfos from unmatched tracks that don't start at vertex
UseUnmatchedVertexTracks int 1 Whether can form pfos from unmatched tracks that start at vertex
V0VertexCollections StringVec Name of external V0 Vertex collections
YokeBarrelNormalVector FloatVec 0 0 1 Normal vector for the muon barrel sensitive layers in local coordinates
Z0TrackCut float 50 Track z0 cut used to determine whether track can be used to form pfo
Z0UnmatchedVertexTrackCut float 5 z0 cut used to determine whether unmatched vertex track can form pfo
ZCutForNonVertexTracks float 250 Non vtx track z cut to determine whether track can be used to form pfo
DDSimpleMuonDigi libDDMarlinPandora.so.0.14.0

Performs simple digitization of sim muon hits...

Parameter Type Default Description
CalibrMUON float 120000 Calibration coefficients for MUON
CellIDLayerString string layer name of the part of the cellID that holds the layer
DetectorNameBarrel string YokeBarrel Name of the barrel subdetector
DetectorNameEndcap string YokeEndcap Name of the endcap subdetector
KeepBarrelLayersVec IntVec Vector of Barrel layers to be kept. Layers start at 1!
KeepEndcapLayersVec IntVec Vector of Endcap layers to be kept. Layers start at 1!
MUONCollections StringVec yoke03_MuonBarrel yoke03_MuonEndCap yoke03_MuonPlug Muon Collection Names
MUONOutputCollection string MUON Muon Collection of real Hits
MaxHitEnergyMUON float 2 maximum hit energy for a MUON hit
MuonThreshold float 0.025 Threshold for Muon Hits in GeV
MuonTimeThreshold float 0.025 Energy threshold for timing information for Muon Hits in GeV
RelationOutputCollection string RelationMuonHit CaloHit Relation Collection
ForwardTracking 8 processors
FTDBackgroundProcessor libForwardTracking.so.1.14.2

FTDBackgroundProcessor creates salt and pepper background hits on the FTD

Parameter Type Default Description
BackgroundHitDensity FloatVec 0.013 0.008 0.002 0.002 0.001 0.001 0.001 Density of background hits in hits / cm^2 / BX
BackgroundHitDensitySigma FloatVec 0.005 0.003 0.001 0.001 0.001 0.001 0.001 Standard deviation of density of background hits in hits / cm^2 / BX
DensityRegulator float 1 Regulates all densities. So this can be used to dim or amplify all the background. 1 means no change at all
FTDPixelTrackerHitCollectionName string FTDPixelTrackerHits Name of the FTD Pixel TrackerHit collection
FTDStripTrackerHitCollectionName string FTDStripTrackerHits Name of the FTD Strip TrackerHit collection
IntegratedBX IntVec 100 100 1 1 1 1 1 Number of bunchcrossings that are integrated
ResolutionU float 0.004 resolution in direction of u
ResolutionV float 0.004 resolution in direction of v
ForwardTracking libForwardTracking.so.1.14.2

ForwardTracking reconstructs tracks through the FTD

Parameter Type Default Description
BestSubsetFinder string SubsetHopfieldNN The method used to find the best non overlapping subset of tracks. Available are: SubsetHopfieldNN, SubsetSimple and None
Chi2ProbCut double 0.005 Tracks with a chi2 probability below this will get sorted out
Crit2_DeltaPhi_MV_max FloatVec The maximum of Crit2_DeltaPhi_MV
Crit2_DeltaPhi_MV_min FloatVec The minimum of Crit2_DeltaPhi_MV
Crit2_DeltaPhi_max FloatVec The maximum of Crit2_DeltaPhi
Crit2_DeltaPhi_min FloatVec The minimum of Crit2_DeltaPhi
Crit2_DeltaRho_max FloatVec The maximum of Crit2_DeltaRho
Crit2_DeltaRho_min FloatVec The minimum of Crit2_DeltaRho
Crit2_DeltaTheta_MV_max FloatVec The maximum of Crit2_DeltaTheta_MV
Crit2_DeltaTheta_MV_min FloatVec The minimum of Crit2_DeltaTheta_MV
Crit2_Distance_MV_max FloatVec The maximum of Crit2_Distance_MV
Crit2_Distance_MV_min FloatVec The minimum of Crit2_Distance_MV
Crit2_HelixWithIP_max FloatVec The maximum of Crit2_HelixWithIP
Crit2_HelixWithIP_min FloatVec The minimum of Crit2_HelixWithIP
Crit2_RZRatio_max FloatVec The maximum of Crit2_RZRatio
Crit2_RZRatio_min FloatVec The minimum of Crit2_RZRatio
Crit2_StraightTrackRatio_max FloatVec The maximum of Crit2_StraightTrackRatio
Crit2_StraightTrackRatio_min FloatVec The minimum of Crit2_StraightTrackRatio
Crit3_2DAngleTimesR_max FloatVec The maximum of Crit3_2DAngleTimesR
Crit3_2DAngleTimesR_min FloatVec The minimum of Crit3_2DAngleTimesR
Crit3_2DAngle_max FloatVec The maximum of Crit3_2DAngle
Crit3_2DAngle_min FloatVec The minimum of Crit3_2DAngle
Crit3_3DAngleTimesR_max FloatVec The maximum of Crit3_3DAngleTimesR
Crit3_3DAngleTimesR_min FloatVec The minimum of Crit3_3DAngleTimesR
Crit3_3DAngle_max FloatVec The maximum of Crit3_3DAngle
Crit3_3DAngle_min FloatVec The minimum of Crit3_3DAngle
Crit3_ChangeRZRatio_max FloatVec The maximum of Crit3_ChangeRZRatio
Crit3_ChangeRZRatio_min FloatVec The minimum of Crit3_ChangeRZRatio
Crit3_IPCircleDistTimesR_max FloatVec The maximum of Crit3_IPCircleDistTimesR
Crit3_IPCircleDistTimesR_min FloatVec The minimum of Crit3_IPCircleDistTimesR
Crit3_IPCircleDist_max FloatVec The maximum of Crit3_IPCircleDist
Crit3_IPCircleDist_min FloatVec The minimum of Crit3_IPCircleDist
Crit3_NoZigZag_MV_max FloatVec The maximum of Crit3_NoZigZag_MV
Crit3_NoZigZag_MV_min FloatVec The minimum of Crit3_NoZigZag_MV
Crit3_PT_MV_max FloatVec The maximum of Crit3_PT_MV
Crit3_PT_MV_min FloatVec The minimum of Crit3_PT_MV
Crit3_PT_max FloatVec The maximum of Crit3_PT
Crit3_PT_min FloatVec The minimum of Crit3_PT
Crit4_2DAngleChange_max FloatVec The maximum of Crit4_2DAngleChange
Crit4_2DAngleChange_min FloatVec The minimum of Crit4_2DAngleChange
Crit4_3DAngleChangeNormed_max FloatVec The maximum of Crit4_3DAngleChangeNormed
Crit4_3DAngleChangeNormed_min FloatVec The minimum of Crit4_3DAngleChangeNormed
Crit4_3DAngleChange_max FloatVec The maximum of Crit4_3DAngleChange
Crit4_3DAngleChange_min FloatVec The minimum of Crit4_3DAngleChange
Crit4_DistOfCircleCenters_max FloatVec The maximum of Crit4_DistOfCircleCenters
Crit4_DistOfCircleCenters_min FloatVec The minimum of Crit4_DistOfCircleCenters
Crit4_DistToExtrapolation_max FloatVec The maximum of Crit4_DistToExtrapolation
Crit4_DistToExtrapolation_min FloatVec The minimum of Crit4_DistToExtrapolation
Crit4_NoZigZag_max FloatVec The maximum of Crit4_NoZigZag
Crit4_NoZigZag_min FloatVec The minimum of Crit4_NoZigZag
Crit4_PhiZRatioChange_max FloatVec The maximum of Crit4_PhiZRatioChange
Crit4_PhiZRatioChange_min FloatVec The minimum of Crit4_PhiZRatioChange
Crit4_RChange_max FloatVec The maximum of Crit4_RChange
Crit4_RChange_min FloatVec The minimum of Crit4_RChange
Criteria StringVec Crit2_DeltaPhi Crit2_DeltaPhi_MV Crit2_DeltaRho Crit2_DeltaTheta_MV Crit2_Distance_MV Crit2_HelixWithIP Crit2_RZRatio Crit2_StraightTrackRatio Crit3_2DAngle Crit3_2DAngleTimesR Crit3_3DAngle Crit3_3DAngleTimesR Crit3_ChangeRZRatio Crit3_IPCircleDist Crit3_IPCircleDistTimesR Crit3_NoZigZag_MV Crit3_PT Crit3_PT_MV Crit4_2DAngleChange Crit4_3DAngleChange Crit4_3DAngleChangeNormed Crit4_DistOfCircleCenters Crit4_DistToExtrapolation Crit4_NoZigZag Crit4_PhiZRatioChange Crit4_RChange A vector of the criteria that are going to be used. For every criterion a min and max needs to be set!!!
EnergyLossOn bool true Use Energy Loss in Fit
FTDHitCollections StringVec FTDTrackerHits FTDSpacePoints FTD Hit Collections
ForwardTrackCollection string ForwardTracks Name of the Forward Tracking output collection
GetTrackStateAtCaloFace bool true Set to false if no track state at the calorimeter is needed
HNN_Activation_Threshold double 0.5 The activation threshold for the Hopfield Neural Network
HNN_Omega double 0.75 Omega for the Hopfield Neural Network; the higher omega the higher the influence of the quality indicator
HNN_TInf double 0.1 The temperature limit of the Hopfield Neural Network
HelixFitMax double 500 The maximum chi2/Ndf that is allowed as result of a helix fit
HitsPerTrackMin int 4 The minimum number of hits to create a track
MaxConnectionsAutomaton int 100000 If the automaton has more connections than this it will be redone with the next set of cut off parameters
MaxHitsPerSector int 1000 Maximal number of hits allowed on a sector. More will cause drop of hits in sector
MultipleScatteringOn bool true Use MultipleScattering in Fit
OverlappingHitsDistMax double 3.5 The maximum distance of hits from overlapping petals belonging to one track
SmoothOn bool false Smooth All Measurement Sites in Fit
TakeBestVersionOfTrack bool true Whether when adding hits to a track only the track with highest quality should be further processed
TrackSystemName string DDKalTest Name of the track fitting system to be used ( DDKalTest, aidaTT, ... )
OverlapChecker libForwardTracking.so.1.14.2

OverlapChecker: Checks if tracks are overlapping

Parameter Type Default Description
TrackCollectionName string ForwardTracks The collection of the tracks to check
SiliconEndcapTracking libForwardTracking.so.1.14.2

SiliconEndcapTracking reconstructs tracks through the FTD

Parameter Type Default Description
BestSubsetFinder string SubsetHopfieldNN The method used to find the best non overlapping subset of tracks. Available are: SubsetHopfieldNN, SubsetSimple and None
Chi2ProbCut double 0.005 Tracks with a chi2 probability below this will get sorted out
Crit2_DeltaPhi_MV_max FloatVec The maximum of Crit2_DeltaPhi_MV
Crit2_DeltaPhi_MV_min FloatVec The minimum of Crit2_DeltaPhi_MV
Crit2_DeltaPhi_max FloatVec The maximum of Crit2_DeltaPhi
Crit2_DeltaPhi_min FloatVec The minimum of Crit2_DeltaPhi
Crit2_DeltaRho_max FloatVec The maximum of Crit2_DeltaRho
Crit2_DeltaRho_min FloatVec The minimum of Crit2_DeltaRho
Crit2_DeltaTheta_MV_max FloatVec The maximum of Crit2_DeltaTheta_MV
Crit2_DeltaTheta_MV_min FloatVec The minimum of Crit2_DeltaTheta_MV
Crit2_Distance_MV_max FloatVec The maximum of Crit2_Distance_MV
Crit2_Distance_MV_min FloatVec The minimum of Crit2_Distance_MV
Crit2_HelixWithIP_max FloatVec The maximum of Crit2_HelixWithIP
Crit2_HelixWithIP_min FloatVec The minimum of Crit2_HelixWithIP
Crit2_RZRatio_max FloatVec The maximum of Crit2_RZRatio
Crit2_RZRatio_min FloatVec The minimum of Crit2_RZRatio
Crit2_StraightTrackRatio_max FloatVec The maximum of Crit2_StraightTrackRatio
Crit2_StraightTrackRatio_min FloatVec The minimum of Crit2_StraightTrackRatio
Crit3_2DAngleTimesR_max FloatVec The maximum of Crit3_2DAngleTimesR
Crit3_2DAngleTimesR_min FloatVec The minimum of Crit3_2DAngleTimesR
Crit3_2DAngle_max FloatVec The maximum of Crit3_2DAngle
Crit3_2DAngle_min FloatVec The minimum of Crit3_2DAngle
Crit3_3DAngleTimesR_max FloatVec The maximum of Crit3_3DAngleTimesR
Crit3_3DAngleTimesR_min FloatVec The minimum of Crit3_3DAngleTimesR
Crit3_3DAngle_max FloatVec The maximum of Crit3_3DAngle
Crit3_3DAngle_min FloatVec The minimum of Crit3_3DAngle
Crit3_ChangeRZRatio_max FloatVec The maximum of Crit3_ChangeRZRatio
Crit3_ChangeRZRatio_min FloatVec The minimum of Crit3_ChangeRZRatio
Crit3_IPCircleDistTimesR_max FloatVec The maximum of Crit3_IPCircleDistTimesR
Crit3_IPCircleDistTimesR_min FloatVec The minimum of Crit3_IPCircleDistTimesR
Crit3_IPCircleDist_max FloatVec The maximum of Crit3_IPCircleDist
Crit3_IPCircleDist_min FloatVec The minimum of Crit3_IPCircleDist
Crit3_NoZigZag_MV_max FloatVec The maximum of Crit3_NoZigZag_MV
Crit3_NoZigZag_MV_min FloatVec The minimum of Crit3_NoZigZag_MV
Crit3_PT_MV_max FloatVec The maximum of Crit3_PT_MV
Crit3_PT_MV_min FloatVec The minimum of Crit3_PT_MV
Crit3_PT_max FloatVec The maximum of Crit3_PT
Crit3_PT_min FloatVec The minimum of Crit3_PT
Crit4_2DAngleChange_max FloatVec The maximum of Crit4_2DAngleChange
Crit4_2DAngleChange_min FloatVec The minimum of Crit4_2DAngleChange
Crit4_3DAngleChangeNormed_max FloatVec The maximum of Crit4_3DAngleChangeNormed
Crit4_3DAngleChangeNormed_min FloatVec The minimum of Crit4_3DAngleChangeNormed
Crit4_3DAngleChange_max FloatVec The maximum of Crit4_3DAngleChange
Crit4_3DAngleChange_min FloatVec The minimum of Crit4_3DAngleChange
Crit4_DistOfCircleCenters_max FloatVec The maximum of Crit4_DistOfCircleCenters
Crit4_DistOfCircleCenters_min FloatVec The minimum of Crit4_DistOfCircleCenters
Crit4_DistToExtrapolation_max FloatVec The maximum of Crit4_DistToExtrapolation
Crit4_DistToExtrapolation_min FloatVec The minimum of Crit4_DistToExtrapolation
Crit4_NoZigZag_max FloatVec The maximum of Crit4_NoZigZag
Crit4_NoZigZag_min FloatVec The minimum of Crit4_NoZigZag
Crit4_PhiZRatioChange_max FloatVec The maximum of Crit4_PhiZRatioChange
Crit4_PhiZRatioChange_min FloatVec The minimum of Crit4_PhiZRatioChange
Crit4_RChange_max FloatVec The maximum of Crit4_RChange
Crit4_RChange_min FloatVec The minimum of Crit4_RChange
Criteria StringVec Crit2_DeltaPhi Crit2_DeltaPhi_MV Crit2_DeltaRho Crit2_DeltaTheta_MV Crit2_Distance_MV Crit2_HelixWithIP Crit2_RZRatio Crit2_StraightTrackRatio Crit3_2DAngle Crit3_2DAngleTimesR Crit3_3DAngle Crit3_3DAngleTimesR Crit3_ChangeRZRatio Crit3_IPCircleDist Crit3_IPCircleDistTimesR Crit3_NoZigZag_MV Crit3_PT Crit3_PT_MV Crit4_2DAngleChange Crit4_3DAngleChange Crit4_3DAngleChangeNormed Crit4_DistOfCircleCenters Crit4_DistToExtrapolation Crit4_NoZigZag Crit4_PhiZRatioChange Crit4_RChange A vector of the criteria that are going to be used. For every criterion a min and max needs to be set!!!
EnergyLossOn bool true Use Energy Loss in Fit
FTDHitCollections StringVec FTDTrackerHits FTDSpacePoints FTD Hit Collections
ForwardTrackCollection string ForwardTracks Name of the Forward Tracking output collection
GetTrackStateAtCaloFace bool true Set to false if no track state at the calorimeter is needed
HNN_Activation_Threshold double 0.5 The activation threshold for the Hopfield Neural Network
HNN_Omega double 0.75 Omega for the Hopfield Neural Network; the higher omega the higher the influence of the quality indicator
HNN_TInf double 0.1 The temperature limit of the Hopfield Neural Network
HelixFitMax double 500 The maximum chi2/Ndf that is allowed as result of a helix fit
HitsPerTrackMin int 4 The minimum number of hits to create a track
MaxConnectionsAutomaton int 920 If the automaton has more connections than this it will be redone with the next set of cut off parameters
MaxHitsPerSector int 1000 Maximal number of hits allowed on a sector. More will cause drop of hits in sector
MultipleScatteringOn bool true Use MultipleScattering in Fit
NDivisionsInPhi int 80 Number of divisions in Phi
NDivisionsInTheta int 180 Number of divisions in Theta
OverlappingHitsDistMax double 4 The maximum distance of hits from overlapping petals belonging to one track
SmoothOn bool false Smooth All Measurement Sites in Fit
TakeBestVersionOfTrack bool true Whether when adding hits to a track only the track with highest quality should be further processed
TrackSystemName string DDKalTest Name of the track fitting system to be used ( DDKalTest, aidaTT, ... )
StepAnalyser libForwardTracking.so.1.14.2

StepAnalyser: Stores information about the path of a particle

Parameter Type Default Description
MCTrueTrackRelCollectionName string TrueTracksMCP Name of the TrueTrack MC Relation collection
RootFileName string StepAnalysis.root Name of the root file for saving the results
TrackPickProcessor libForwardTracking.so.1.14.2

TrackPickProcessor makes a collection of only one / a few true tracks

Parameter Type Default Description
MCTrueTrackRelCollectionName string TrueTracksMCP Name of the TrueTrack MC Relation collection
TrackPickCollection string PickedTrackHits Name of picked track hits output collection
TrackingFeedbackProcessor libForwardTracking.so.1.14.2

TrackingFeedbackProcessor gives feedback about the Track Search

Parameter Type Default Description
CutChi2Prob double 0.005 Tracks with a chi2 probability below this value won't be considered
CutDistToIPMax double 10000 The maximum distance from the origin of the MCP to the IP (0,0,0)
CutFitFails bool false Whether to cut all tracks that fail at fitting
CutNumberOfHitsMin int 4 The minimum number of hits a track must have
CutNumberOfHitsMin_HitsCountOncePerLayer bool false Whether the hits used for the cut CutNumberOfHitsMin only count once for each layer, i.e double hits on a layer count as one
CutPtMin double 0.1 The minimum transversal momentum pt above which tracks are of interest in GeV
CutThetaMax double 91 The maximum theta of the track in deg
CutThetaMin double 0 The minimum theta of the track in deg
DrawMCPTracks bool false Draw the helices of the MCP (values at IP) in CED
EnergyLossOn bool true Use Energy Loss in Fit
MCTrueTrackRelCollectionName string TrueTracksMCP Name of the TrueTrack MC Relation collection
MultipleScatteringOn bool true Use MultipleScattering in Fit
RateOfAssignedHitsMin float 0.5 More than this rate of hits of the reco track must belong to the true track to be assigned
RateOfFoundHitsMin float 0.5 More than this rate of hits of the real track must be in a reco track to be assigned
RootFileAppend bool false Whether the root output file should be appended to an existing one
RootFileName string Feedback.root Name for the root file where the tracks are saved
SaveAllEventsSummary bool false If true the results of all events are summed up and saved in the file specified under SummaryFileName
SmoothOn bool false Smooth All Measurement Sites in Fit
SummaryFileName string TrackingFeedbackSum.csv All events are summed up and saved in this file, if SaveAllEventsSummary == true
TableFileName string TrackingFeedback.csv Name of the table file for saving the results
TrackCollection string ForwardTracks Name of Track collection to check
TrueTrackCritAnalyser libForwardTracking.so.1.14.2

TrueTrackCritAnalyser: Analysis of criteria for the Cellular Automaton

Parameter Type Default Description
CutChi2Prob double 0.005 Tracks with a chi2 probability below this value won't be considered
CutDistToIPMax double 100 The maximum distance from the origin of the MCP to the IP (0,0,0)
CutNumberOfHitsMin int 4 The minimum number of hits a track must have
CutPtMin double 0.1 The minimum transversal momentum pt above which tracks are of interest in GeV
EnergyLossOn bool true Use Energy Loss in Fit
MCTrueTrackRelCollectionName string TruthTracksMCP Name of the TrueTrack MC Relation collection
MultipleScatteringOn bool true Use MultipleScattering in Fit
OverlappingHitsDistMax double 4 The maximum distance of hits from overlapping petals belonging to one track
RootFileName string TrueTracksCritAnalysis.root Name of the root file for saving the results
SmoothOn bool false Smooth All Measurement Sites in Fit
WriteNewRootFile bool true What to do with older root file: true = rename it, false = leave it and append new one
Garlic 2 processors
ECALPreClustering libGarlic.so.3.1.0

Preclusters ECAL hits to define ROIs for Garlic

Parameter Type Default Description
Debug int 0 Debugging level 0-3
DistanceCut float 40 Maximum distance of two hits grouped to the same PreCluster
EcalHitCollections StringVec ECALEndcap ECALBarrel ECALOther names of ECAL hit collections
EcalPreClusterCollection string ECAL_PreClusters Collecion name of the ECAL preClusrters
MinimumHits int 5 Minimum number of hits to accept a PreCluster
GarlicProcessor libGarlic.so.3.1.0

Clustering and photon recognition

Parameter Type Default Description
ClusterCollName string GARLICPhotonClusters Name of garlic cluster collection
ClusterMaxDist float 2 Maximum distance from core to added hits (in Moliere Radii)
ClusterParLinksCollName string GARLICClusterParameterLinks Name of cluster to parameter relations
ClusterParametersCollName string GARLICClusterParameters Name of garlic cluster parameters collection
CoreCollName string GARLICCores Name of garlic core collection
CoreMaxDistance float 1.5 max transverse distance for adding hits to core (in terms of cell size)
CoreMaxHoleSection1 int 3 max hole in core building for section 1
CoreMaxHoleSection2 int 2 max hole in core building for section 2
CoreNlayersSection1 int 16 first calo section definition for core building
DebugMode int 0 Talk a lot? (0-3)
EcalEnergyMipConversion float 140 factor to convert between ECAL hit energy and MIP scale, for first layer
EcalPreClusterCollection string ECAL_PreClusters Name of PreCluster collection
ElectronClusterCollName string GARLICElectronClusters Name of electron cluster collection
ElectronTransTubeNSteps int 3 number of iterations for electron tube making
ElectronTransTubeStepSize float 0.75 fraction of moliere radius with which to increment electron hit tube at each iteration
ForwardTrackAngle float 0.15 Tracks with polar angle below this have less stringent cuts for electron finding (rad)
GarlicConversionsPFOColName string GARLICConversionPFOs collection of identified conversions
GarlicDebugCollections bool false write out debug info collections to lcio file?
GarlicElectronsPFOColName string GARLICElectronPFOs collection of identified electrons
GarlicPhotonsPFOColName string GARLICPhotonPFOs collection of photon PFOs
MCParticleCollection string MCParticle Name of the MCParticle input collection
MaxMergeDistEnDep float 1.5 maximum distance between clusters to consider merging: max(MaxMergeDistLowEn, MaxMergeDistLowEn + MaxMergeDistEnDep*log10(clusEn))
MaxMergeDistLowEn float 2 maximum distance between clusters to consider merging: max(MaxMergeDistLowEn, MaxMergeDistLowEn + MaxMergeDistEnDep*log10(clusEn))
MergeAbsoluteLargestDist float 500 don't consider merging two clusters if distance between cluster centres > MergeAbsoluteLargestDist
MergeEnergyDistFactor float 120 don't consider merging two clusters if E_min/E_max > MergeEnergyDistFactor/(cl-cl dist **2) [cl-cl dist = transverse dist between clusters in mm]
MergePi0MassLimit float 0.1 to veto merging 2 clusters, ask for their invariant mass to be consistent with a value > MergePi0MassLimit @ 2 sigma, and that E_max/E_min < MergePi0MaxEnergyImbalance
MergePi0MaxEnergyImbalance float 50 to veto merging 2 clusters, ask for their invariant mass to be consistent with a value > MergePi0MassLimit @ 2 sigma, and that E_max/E_min < MergePi0MaxEnergyImbalance
MergeRatioCut float 0.25 don't consider merging two clusters if E_min/E_max > MergeRatioCut
MoliereRadius float 20 assumed Moliere radius of ECAL (mm)
PhotonCutFile string file containing the photon selection cuts
RemovedHitsCollection string GARLICRemovedHits collection name of removed hits (near tracks)
SeedClusterLinksCollName string GARLICSeedClusterLinks Name of seed to cluster relations
SeedCollName string GARLICSeeds Name of garlic seed collection
SeedCoreLinksCollName string GARLICSeedCoreLinks Name of seed to core relations
SeedMaxDistance float 1.5 radius of seed cylinder (in terms of cell size)
SeedMinEnergy float 5 reject seeds below this energy (in MIPs)
SeedMinHitEnergy float 2.5 consider only hits above this threshold (in MIPs) in the seeding
SeedMinHits int 2 Minimum number of hits to accept a seed.
SeedNLayers int 12 Number of ECAL pseudo layers used for projecting to obtain a seed, typically equivalent to 5 X0.
TPCTrackCollection string ClupatraTracks TPC track collection name
TouchingCellDistance float 2.4 definition of distance between cells to be considered touching (multiplier of cell size)
TrackCheat bool false take MC info for tracks?
TrackCollection string MarlinTrkTracks track collection name
TrackExtrapolationCollName string GARLICTrackExtrapolations Name of track extrapolation collection
TrackRemoveNearbyHits bool true Should remove Hits near extrapolated tracks to reject pions?
TrackVetoWindow float 10 window around track in which to remove hits (mm)
clusterCheckHistoFile string name of file in which to save clustering histograms
constantTerm float 0.01 assumed constant term of energy resolution
simHitCaloHitRelations string RelationCaloHit name of sim->calo hit relation collection
stochasticTerm float 0.17 assumed stochastic term of energy resolution
ILDPerformance 10 processors
DDDiagnostics libILDPerformance.so.1.12.1

DDDiagnostics generates information for tracking performance monitor.

Parameter Type Default Description
CosThetaCut double 0.9 Maximum costheta of examined MCParticles sample
DistFromIP double 10 Maximum distance from IP of examined MCParticles sample (in mm)
FillBigTTree bool false Fill the more detail information into TTree for DEBUG.
MCParticleCollection string MCParticle Name of the MCParticle input collection
MCTracksTruthLinkCollectionName string MCTracksTruthLink true - reco relation collection
PCut double 0 Minimum momentum of examined MCParticles sample (in GeV)
PTCut double 0 Minimum transverse momentum of examined MCParticles sample (in GeV)
PhysSampleOn bool false Enable when we run diagnostics to a simulated physics sample
ReqInnVXDHit bool false Requirement that the innermost VXD hit should be found
RequiredPurity double 0.74 ratio of hits belonging to the dominant MC particle to total number of track hits
RequiredSiHits int 4 minimum required hits on Si detectors in order to consider the track found
SITTrackerHitRelations string SITTrackerHitRelations SIT tracker hits to sim hits
SiTrkEffOn bool false Enables cuts to define the examined track sample
SimTrackerHitCollections StringVec VXDCollection FTDCollection SITCollection TPCCollection Names of the SimTrackerHits input collection
SpcPntsCollection string SITTrackerHits Name of the SIT SpacePoints collection
StudiedTracks string MarlinTrkTracks Name of the FullLDC track collection
TracksMCTruthLinkCollectionName string TracksMCTruthLink reco - true relation collection
TrkEffOn bool false Enables cuts to define the examined track sample
VXDTrackerHitRelations string VXDTrackerHitRelations VXD tracker hits to sim hits
VXDTrackerHits string VXDTrackerHits Name of the VXDTrackerHit collection
PIDTree libILDPerformance.so.1.12.1

PIDTree create a ROOT TTree with PID parameters

Parameter Type Default Description
BCALCLusters string BCALCLusters Name of the BCAL clusters input collection
BCALParticles string BCALParticles Name of the BCALParticles input collection
MCParticleCollection string MCParticle Name of the MCParticle input collection
MCTruth2RecoLinkCollectionName string MCTruthRecoLink true - reco relation collection
MCTruth2TrackLinkCollectionName string MCTruthMarlinTrkTracksLink true - track relation collection
PFOs string PandoraPFOs particle flow objects
Reco2MCTruthLinkCollectionName string RecoMCTruthLink reco - true relation collection
StudiedTracks string MarlinTrkTracks Name of the FullLDC track collection
Pi0Tree libILDPerformance.so.1.12.1

Pi0Tree does whatever it does ...

Parameter Type Default Description
GammaGammaParticleCollection string GammaGammaParticles Name of the gamma-gamma candidate input collection
MCParticleCollection string MCParticle Name of the MCParticle input collection
MCTruth2RecoLinkCollectionName string MCTruthRecoLink true - reco relation collection
Reco2MCTruthLinkCollectionName string RecoMCTruthLink reco - true relation collection
Residuals libILDPerformance.so.1.12.1

Residuals studies

Parameter Type Default Description
MarlinTrkTrack string MarlinTrkTracks Input track collection
SortWrtRadius bool true Sort the hits wrt to their radius
TrackSystemName string DDKalTest Name of the track fitting system to be used (DDKalTest, aidaTT, ... )
Skim libILDPerformance.so.1.12.1

skim the MCParticle collection to MC charged particle with 40<theta<140 (vertex barrel)

Parameter Type Default Description
MCParticleCollectionName string MCParticle Name of the MCParticle input collection
MCParticleSkimmedCollectionName string MCParticleSkimmed Name of the skimmed MCParticle output collection
ThetaMax double 140 Maximum polar angle (in deg) to accept MC in skim
ThetaMin double 40 Minimum polar angle (in deg) to accept MC in skim
TrackerHitCounter libILDPerformance.so.1.12.1

TrackerHitCounter counts SimTrackerHits in tracker detector elements and reports the number of hits per unit area.

Parameter Type Default Description
TrkHitCollections StringVec VXDCollection SITCollection FTDCollection TPCCollection SETCollection Tracker hit collections that will be analysed
WWZZProcessor libILDPerformance.so.1.12.1

WWZZProcessor: Search for e+e- -> vvWW/vvZZ -> vvqqqq at the ILD detector

Parameter Type Default Description
CrossSection float 0 Cross section of sample stdhep file
InputAllPFOsCollection string PandoraPFOs Name of the PFOs collection
InputFastJetsCollection string FastJets Name of the jet collection
InputIsolepsCollection string Isoleps Name of the isolated lepton collection
MCParticleCollection string MCParticle Name of the MC particle collection
RootFileName string /nfs/dust/ilc/group/ild/beyerjac/VBS/nunu_hadrons/output/root_files/output.root Name of Root file (default: output.root)
dEdxAnalyser libILDPerformance.so.1.12.1

description not set by author

Parameter Type Default Description
LikelihoodPIDMethod string dEdxPID Name of PID algorithm in LikelihoodPIDProcessor to be used in PFO vs. truth comparison matrix; default: 'dEdxPID'.
MCParticleCollection string MCParticle MC Particles
PFOCollection string PandoraPFOs Pandora PFOs
TrackCollection string MarlinTrkTracks Name of input collection of reconstructed Tracks
TrackMCTruthLink string MarlinTrkTracksMCTruthLink LCRelation from the reconstructed tracks to the MC particles
cutD0 double 0 Tracks with a d0 larger than the given value will be ignored. Set to 0 to accept all particles.
cutLamMax double 0 Tracks with an angle lambda (relative to the cathode) larger than the given value will be ignored. Set to 0 to accept all particles.
cutLamMin double 0 Tracks with an angle lambda (relative to the cathode) smaller than the given value will be ignored. Set to 0 to accept all particles.
cutMomMax double 0 Tracks with a momentum larger than the given value will be ignored. Set to 0 to accept all particles.
cutMomMin double 0 Tracks with a momentum smaller than the given value will be ignored. Set to 0 to accept all particles.
cutTrackPurity bool false Set true if particles should be ignored, where the MCParticle is connected to more than one track.
cutTrackPurityMom bool false Set true if particles should be ignored, where the MCParticle is connected to more than one track, but the track with the highest momentum is still used.
cutZ0 double 0 Tracks with a z0 larger than the given value will be ignored. Set to 0 to accept all particles.
cutdEdx bool false Set true if particles with a very off dE/dx value should be ignored.
fiducialLamMax double 10 Fiducial maximum absolut lambda / deg; default: 10.
fiducialLamMin double 1 Fiducial minimum absolut lambda / deg; default: 1.
fiducialMomMax double 10 Fiducial maximum absolut momentum / GeV; default: 10.
fiducialMomMin double 3 Fiducial minimum absolut momentum / GeV; default: 3.
fiducialNHitsMin int 200 Fiducial minimum number of hits; default: 200.
fileFormat string .png Specify the format of the automatically plotted images (if chosen). Selection depends on root TPad::Print() capabilities, typically: [.ps, .eps, .pdf, .svg, .tex, .gif, .xpm, .png, .jpg, .tiff, .cxx, .xml, .json, .root]. Default: .png.
maxBinX double 2 log_10(momentum/GeV) of the upper end of the momentum axis in histograms. Default: 2 (= 100 GeV).
maxBinY double 1e-06 Upper end of the dE/dx axis in GeV/mm in histograms. Default: 1e-6 GeV/mm.
minBinX double -1 log_10(momentum/GeV) of the lower end of the momentum axis in histograms. Default: -1 (= 0.1 GeV).
minBinY double 0 Lower end of the dE/dx axis in GeV/mm in histograms. Default: 0 GeV/mm.
nBinsX int 100 Number of bins of the momentum axis in histograms. Default: 100.
nBinsY int 300 Number of bins of the dE/dx axis in histograms. Default: 300.
plotFolder string . Specify the folder in which the automatically plotted images should be stored (if chosen). Needs to exist. Default: '.' [current working directory].
plotStuff bool false Set true to automatically plot various histograms as .png in the current working directory. Default: false.
useLCTPCStyle bool false Set true if you would like to use the LCTPCStyle.C from MarlinTPC/analysis/rootscripts as style for the plots. Default: false.
useOneTrack bool false Set true if from every event only the first object in the selected collection (track or PFO) should be used.
usePFOTracks bool false Set true if tracks from (charged) PFOs should be used as data basis instead of all tracks from the TrackCollection.
usePFOTruthLink bool false Set true if the LCRelation from PFO to MCTruth instead of Track to MCTruth should be used to determine MC PDG.
validateAutoProcessor libILDPerformance.so.1.12.1

validateAutoProcessor makes histograms of basic simhit properties to quickly check simulation results

Parameter Type Default Description
inputParamFilenames StringVec BLAH.txt names of input parameter files
outputFilename string validate.root name of output file
validateDST_SinglePhotonProcessor libILDPerformance.so.1.12.1

validateDST_SinglePhotonProcessor makes histograms of basic properties for photons

Parameter Type Default Description
outputFilename string validatePhoton.root name of output file
LCTuple 3 processors
CreateRecoRelations libLCTuple.so.1.14.0

CreateRecoRelations creates transient collections with realtions from ReconstructedParticles to Tracks and Clusters

Parameter Type Default Description
Reco2ClusterRelationName string Reco2ClustersRelation Name of output collection for relation ReconstructedParticles to Clusters
Reco2RecoRelationName string Reco2RecoRelation Name of output collection for relation ReconstructedParticles to ReconstructedParticles
Reco2TracksRelationName string Reco2TracksRelation Name of output collection for relation ReconstructedParticles to Tracks
RecoCollection string PandoraPFOs Names of ReconstructedParticles input collections
LCTuple libLCTuple.so.1.14.0

LCTuple creates a ROOT TTRee with a column wise ntuple from LCIO collections ....

Parameter Type Default Description
CalorimeterHitCollection string Name of the CalorimeterHit collection
ClusterCollection string Name of the Cluster collection
IsoLepCollection string Name of the IsoLep collection
JetCollection string Name of the Jet collection
JetCollectionExtraParameters bool false Switch to write out extra parameters calculated using information from Jet Finder
JetCollectionTaggingParameters bool false Switch to write out jet parameters coming from LCFIPlus tagging processor
LCRelationCollections StringVec Names of LCRelation collections - need parallel prefix names in RelPrefixes
LCRelationPrefixes StringVec Names of prefixes for variables from LCRelation collections - needs to be parallel to LCRelationCollections (one prefix per collection)
LCRelationwithPFOCollections string Names of LCRelation collections of PFO
MCParticleCollection string Name of the MCParticle collection
MCParticleRemoveOverlayCollection string Name of the MCParticle collection where the overlay is removed
PFOwithRelationCollection string Name of the PFO collection with Relation
PIDBranchDefinition StringVec Algorithm:TOFEstimators50ps tof50 TOFFirstHit TOFClosestHits TOFClosestHitsError TOFFlightLength TOFLastTrkHit TOFLastTrkHitFlightLength fh ch che len th thl Definition of PID branches added to the ReconstructedParticle branches - for every algorithm: Algorithm:Name branchPrefix Parameter0 branch0 Parameter1 branch1 Parameter2 branch2 ...
RecoParticleCollection string Name of the ReconstructedParticle collection
SimCalorimeterHitCollection string Name of the SimCalorimeterHit collection
SimTrackerHitCollection string Name of the SimTrackerHit collection
TrackCollection string Name of the Track collection
TrackerHitCollection string Name of the TrackerHit collection
VertexCollection string Name of the Vertex collection
WriteCalorimeterHitCollectionParameters bool false Switch to write out collection parameters
WriteClusterCollectionParameters bool false Switch to write out collection parameters
WriteIsoLepCollectionParameters bool false Switch to write out collection parameters
WriteJetCollectionParameters bool false Switch to write out collection parameters
WriteMCParticleCollectionParameters bool false Switch to write out collection parameters
WriteRecoParticleCollectionParameters bool false Switch to write out collection parameters
WriteSimCalorimeterHitCollectionParameters bool false Switch to write out collection parameters
WriteSimTrackerHitCollectionParameters bool false Switch to write out collection parameters
WriteTrackCollectionParameters bool false Switch to write out collection parameters
WriteTrackerHitCollectionParameters bool false Switch to write out collection parameters
WriteVertexCollectionParameters bool false Switch to write out collection parameters
MergeCollections libLCTuple.so.1.14.0

MergeCollections creates a transient subset collection that merges all input collections

Parameter Type Default Description
CollectionParameterIndex int 0 Index of input collection that is used to copy the collection parameters from
InputCollectionIDs IntVec IDs for input collections - if given id will be added to all objects in merged collections as ext<CollID)
InputCollections StringVec Names of all input collections
OutputCollection string MergedCollection Name of output collection
MarlinDD4hep 1 processor
InitializeDD4hep libMarlinDD4hep.so.0.6.2

InitializeDD4hep reads a compact xml file and initializes the dd4hep::Detector object

Parameter Type Default Description
DD4hepXMLFile string dd4hep_compact.xml Name of the DD4hep compact xml file to load
EncodingStringParameter string Alternate name for EncodingStringParameterName
EncodingStringParameterName string If given, the Compact File parameter of that name will be used as argument to LCTrackerCellID::set_encoding_string()
MarlinFastJet 3 processors
FastJetClustering libMarlinFastJet.so.0.5.3

FastJet Clustering ...

Parameter Type Default Description
Algorithm string antikt_algorithm FastJet algorithm
Debug int 0 debug printout
EjetMin double 10 Ejet
FillTree int 0 tuple
InputCollection string Unset Collection of reconstructed particles
NJets int 25 max nb of jets
OutputCollection string Unset Name of collection with the found jets
R double 0.7 R Parameter
FastJetProcessor libMarlinFastJet.so.0.5.3

Using the FastJet library to identify jets

Parameter Type Default Description
algorithm StringVec kt_algorithm 0.7 Selects the algorithm and its parameters. E.g. 'kt_algorithm 0.7' or 'ee_kt_algorithm'. For a full list of supported algorithms, see the logfile after execution.
clusteringMode StringVec Inclusive 0.0 One of 'Inclusive <minPt>', 'InclusiveIterativeNJets <nrJets> <minE>', 'ExclusiveNJets <nrJets>', 'ExclusiveYCut <yCut>'. Note: not all modes are available for all algorithms.
jetOut string JetOut The identified jets
recParticleIn string MCParticle a list of all reconstructed particles we are searching for jets in.
recParticleOut string a list of all reconstructed particles used to make jets. If no value specified collection is not created
recombinationScheme string E_scheme The recombination scheme used when merging 2 particles. Usually there is no need to use anything else than 4-Vector addition: E_scheme
storeParticlesInJets bool false Store the list of particles that were clustered into jets in the recParticleOut collection
FastJetTopTagger libMarlinFastJet.so.0.5.3

Using the FastJet tool JHTagger to identify top jets

Parameter Type Default Description
algorithm StringVec kt_algorithm 0.7 Selects the algorithm and its parameters. E.g. 'kt_algorithm 0.7' or 'ee_kt_algorithm'. For a full list of supported algorithms, see the logfile after execution.
axesMode string VLC_Axes Option for NSubjettiness calculation. See fastjet NSubjettiness module for all options.
clusteringMode StringVec Inclusive 0.0 One of 'Inclusive <minPt>', 'InclusiveIterativeNJets <nrJets> <minE>', 'ExclusiveNJets <nrJets>', 'ExclusiveYCut <yCut>'. Note: not all modes are available for all algorithms.
cos_theta_W_max double 1 The maximal allowed value of the W helicity angle
deltaP double 0.05 Subjets must carry at least this fraction of the original jet's p_t
deltaR double 0.05 Subjets must be separated by at least this Manhattan distance
doSubstructure bool false Bool to decide whether (true) or not (false) to calculate substructure variables on each jet. Default is false.
energyCorrelator string E_theta Options for contrib::EnergyCorrelator: pt_R (transverse momenta and boost-invariant angles), E_theta (energy and angle as dot product of vectors), E_inv (energy and angle as (2p_i*p_j/E_i E_j) (default: E_theta).
jetOut string JetOut The identified jets
measureMode string UnnormalizedMeasure Option for NSubjettiness calculation. See fastjet NSubjettiness module for all options. Normalised measure recommended only for advanced users.
recParticleIn string SelectedPandoraPFANewPFOs a list of all reconstructed particles we are searching for jets in.
recParticleOut string a list of all reconstructed particles used to make jets. If no value specified collection is not created
recombinationScheme string E_scheme The recombination scheme used when merging 2 particles. Usually there is no need to use anything else than 4-Vector addition: E_scheme
storeParticlesInJets bool false Store the list of particles that were clustered into jets in the recParticleOut collection
substuctureOut string TopTaggerSubstructureOut The name of the substructure variables collection output
topTaggerOut string TopTaggerOut The top tagger output for each jet
MarlinKinfitProcessors 11 processors
DijetTester libMarlinKinfitProcessors.so.0.5.1

DijetTester does a 4C fit on 2 jet events (Px, Py, Pz, E)

Parameter Type Default Description
ECM float 500 Center-of-Mass Energy in GeV
fitter int 0 0 = OPALFitter, 1 = NewFitter, 2 = NewtonFitter
ievttrace int 0 number of individual event to be traced
leptonasjet bool false set true if lepton should be parametrised at JetFitObject
leptonic bool false set true if di-lepton events should be used
ntoy int 200 number of toy events
traceall bool false set true if every event should be traced
MCParticleFilter libMarlinKinfitProcessors.so.0.5.1

MCParticleFilter does whatever it does ...

Parameter Type Default Description
MCParticleCollection string MCParticle Name of the MCParticle input collection
MaxDistanceSquared double 1 Maximum Distance Squared (mm^2)
MaxGenStatus int 1 Maximum Generator Status Value
MinDistanceSquared double -1 Minimum Distance Squared (mm^2)
MinGenStatus int 1 Minimum Generator Status Value
OutputParticleCollectionName string MCDecayParticles Output Particle Collection Name
Printing int 1 Print certain messages
MassConstraintFitter libMarlinKinfitProcessors.so.0.5.1

description not set by author

Parameter Type Default Description
AllowedMassDeviation double 999 cut on measured mass and true parent mass difference
FitAnalysis int 1 0 = No TTree , 1 = make TTree, generates a TTree of fit and measured particle parameters along with pull distributions
FitProbabilityCut double 0.001 Minimum fit probability
GeneratorAnalysis int 1 0 = No TTree , 1 = make TTree, includes generator level information in the TTree if available
InputParticleCollectionName string PandoraPFOs Input Particle Collection Name
InputTrackCollectionName string MarlinTrkTracks Input Track Collection Name
MCParticleCollection string MCDecayParticles Name of the MCParticle input collection
OutputParticleCollectionName string MassConstraintCandidates Output Particle Collection Name
OutputTrackCollectionName string MassConstraintCandidates Output Particle Collection Name
PhotonAngularError double 0.001 Photon Angular Error (rad)
PhotonAngularErrorModel int 1 Photon Angular Error Model (0 - stochastic) (1 - constant)
Printing int 5 Print certain messages
RootFile string MassConstraintFitAnalysis.root Name of the output root file
SecondaryMasses FloatVec vector of the masses that are not the parent mass
SecondaryNCharged FloatVec vector of nCharged for each secondary constraint
SecondaryNNeutral FloatVec vector of nNeutral for each secondary constraint
daughterChargedMass FloatVec 0.13957 Mass [GeV] of daughter decay particles with charge != 0
daughterChargedPdgs IntVec 211 PDG codes of daughter decay particles with charge != 0
daughterNeutralMass FloatVec 0 Mass [GeV] of daugher decay particles with charge == 0
daughterNeutralPdgs IntVec 22 PDG codes of daughter decay particles with charge == 0
fitter int 0 0 = OPALFitter, 1 = NewFitter, 2 = NewtonFitter
nCharged int 2 Number of daughter decay particles with charge !=0
nChargedParams int 3 Number of parameters used in charged particle parameterization (in FitObjects)
nDaughters int 3 Number of daughter decay particles
nMassConstraints int 1 the number of mass constraints being applied
nNeutral int 1 Number of daughter decay particles with charge ==0
nNeutralParams int 3 Number of parameters used in neutral particle paramterization (in FitObjects)
parentCharge double 0 Parent particle charge
parentMass double 0.547862 Parent particle mass [GeV]
parentPdg int 221 PDG code of parent particle
PhotonResponseAdjuster libMarlinKinfitProcessors.so.0.5.1

Adjusts Photons from filtered pandora pfos collection

Parameter Type Default Description
AllowedAngularDeviation double 3.14 allowed theta deviation of MC and REC photon in standard deviations
AllowedEnergyDeviation double 999 allowed energy deviation of MC and REC photon in standard deviations
AngularSmearingModel int 0 Energy dependence choice: 0 - stochastic, 1 - energy independent
EnergyScaleFactor double 1 Energy Scale Factor
InputParticleCollectionName string PandoraPFOs Input Particle Collection Name
MCParticleCollection string MCParticle Name of the MCParticle input collection
OutputParticleCollectionName string AdjustedPhotons Output Particle Collection Name
Printing int 5 Print certain messages
SmearAngles int 0 option 0 or 1 to smear the angles using smearing model and MC photon direction
dPhi double 0.001 normally distributed phi std dev (in units of radians) for drawing random variates in new direction
dTheta double 0.001 normally distributed theta std dev (in units of radians) for drawing random variates in new direction
SimpleVertexProcessor libMarlinKinfitProcessors.so.0.5.1

SimpleVertexProcessor fits 2 charged tracks to a single vertex

Parameter Type Default Description
ievttrace int 0 number of individual event to be traced
traceall bool false set true if every event should be traced
TTBarExample libMarlinKinfitProcessors.so.0.5.1

TTBarExample does a 6C fit on 6jet ttbar events (Px, Py, Pz, E, M12 = M34 = M_W (for all permutations assuming the b-jets are tagged))

Parameter Type Default Description
BJetCollectionName string DurhamBJets Name of the B Jet collection
ECM float 500 Center-of-Mass Energy
LightJetCollectionName string DurhamLightJets Name of the Light Jet collection
TopTester libMarlinKinfitProcessors.so.0.5.1

TopTester does a 7C fit on 6 jet events (Px, Py, Pz, E, M34 = M56 = 80.4 GeV, M134 = M256)

Parameter Type Default Description
ECM float 500 Center-of-Mass Energy in GeV
fitter int 0 0 = OPALFitter, 1 = NewFitter, 2 = NewtonFitter
ievttrace int 0 number of individual event to be traced
leptonasjet bool false set true if lepton should be parametrised at JetFitObject
ntoy int 200 number of toy events
semileptonic bool false set true if semi-leptonic ttbar events should be used
softmasses bool false set true if mass constraints should be soft
traceall bool false set true if every event should be traced
TrackResponseAdjuster libMarlinKinfitProcessors.so.0.5.1

Smears Charged Particles from filtered Monte Carlo Particle collection

Parameter Type Default Description
D0ErrorScaleFactor double 1 D0 Error Scale Factor
InputTrackCollectionName string MarlinTrkTracks Input Track Collection Name
OmegaErrorScaleFactor double 1 Omega Error Scale Factor
OutputTrackCollectionName string AdjustedTracks Output Track Collection Name
PhiErrorScaleFactor double 1 Phi Error Scale Factor
Printing int 5 Print certain messages
TanLambdaErrorScaleFactor double 1 TanLambda Error Scale Factor
Z0ErrorScaleFactor double 1 Z0 Error Scale Factor
WW5CFit libMarlinKinfitProcessors.so.0.5.1

WW5CFit does a 5C fit on 4 jet events (Px, Py, Pz, E, M12 = M34 (for all three permutations))

Parameter Type Default Description
ECM float 500 Center-of-Mass Energy in GeV
FitISR int 1 0: Fit hypothesis without ISR 1: Fit hypothesis including ISR
ISRPzMax float 225 Maximum possible energy for a single ISR photon
JetCollectionName string Durham4Jets Name of the Jet collection
fitter int 0 0 = OPALFitter, 1 = NewFitter, 2 = NewtonFitter
ievttrace int 0 number of individual event to be traced
traceall bool false set true if every event should be traced
ZH5CFit libMarlinKinfitProcessors.so.0.5.1

ZH5CFit does a 5C fit on 4 jet events (Px, Py, Pz, E, M12 = MZ (for all six permutations))

Parameter Type Default Description
ECM float 500 Center-of-Mass Energy in GeV
FitISR int 1 0: Fit hypothesis without ISR 1: Fit hypothesis including ISR
FitOutputColection string FitReco Output Fit Colection
ISRPzMax float 225 Maximum possible energy for a single ISR photon
JetCollectionName string Durham2Jets Name of the Jet collection
MCParticleCollection string MCParticle Name of the MCParticle collection
NeutrinoCorrection string NuCorrect Collection of Corrected/Estimated neutrino energies from SemiLeptonic decays
NuEnergyCorrection int 1 0: Fit hypothesis without ISR 1: Fit hypothesis including ISR
SemiLeptonicDecays string Semi-Leptonic Decays Collection
SigmaEnergyScaleFactor float 1 Scale Factor t be applied to jet energy uncertainty
errene double 1.2 assumed energy resolution for jets as x/sqrt(E) - if 0, then parametrisation is used
errphi double 0.1 assumed phi resolution for jet axis
errtheta double 0.1 assumed theta resolution for jet axis
fitter int 0 0 = OPALFitter, 1 = NewFitter, 2 = NewtonFitter
ievttrace int 0 number of individual event to be traced
outputFilename string name of output file
traceall bool false set true if every event should be traced
useErrorFlow int 1 If true, use covariance matrix for energy uncertainty. Otherwise 1.2/sqrt(E)
ZHllqq5CFit libMarlinKinfitProcessors.so.0.5.1

ZHllqq5CFit does a 5C fit on ZH->mumubb events

Parameter Type Default Description
ECM float 500 Center-of-Mass Energy in GeV
FitISR int 1 0: Fit hypothesis without ISR 1: Fit hypothesis including ISR
FitPostRecoColection string FitReco Output Fit Colection
ISRPzMax float 225 Maximum possible energy for a single ISR photon
InputIsoLeptonsCollection string ISOLeptons Name of collection with the selected isolated lepton
JetCollectionName string Durham2Jets Name of the Jet collection
PullsEPostFitRecoColection string PullEnergy Output Pull E Colection
PullsPhiPostFitRecoColection string PullPhi Output Pull Phi Colection
PullsThetaPostFitRecoColection string PullTheta Output Pull Theta Colection
SigmaEnergyScaleFactor float 1 Scale Factor t be applied to jet energy uncertainty
errene double 1.2 assumed energy resolution for jets as x/sqrt(E) - if 0, then parametrisation is used
errphi double 0.1 assumed phi resolution for jet axis
errtheta double 0.1 assumed theta resolution for jet axis
fitter int 0 0 = OPALFitter, 1 = NewFitter, 2 = NewtonFitter
ievttrace int 0 number of individual event to be traced
traceall bool false set true if every event should be traced
MarlinReco 90 processors
AbsCalibr libMarlinReco.so.1.38.0

Calorimeter Abslute Energy Calibration

Parameter Type Default Description
Coeff FloatVec 33.0235 93.5682 21.1963 Calorimeter coeffs
Cuts FloatVec 8.5e-05 8.5e-05 0.0004375 Calorimeter cuts
NLayer IntVec 30 10 40 Number of layers in zone
Add4MomCovMatrixCharged libMarlinReco.so.1.38.0

Set the convariance matrix in (P,E) for all charged pfos in PandoraPFOs Collection

Parameter Type Default Description
InputPandoraPFOsCollection string PandoraPFOs Name of the PandoraPFOs collection
AddClusterProperties libMarlinReco.so.1.38.0

AddClusterProperties does whatever it does ...

Parameter Type Default Description
ClusterCollection string PandoraClusters Name of the Clusters input collection
PFOCollectionName string PandoraPFOs Name of the input PFO collection
AnalyseSidEdxProcessor libMarlinReco.so.1.38.0

AnalyseSidEdxProcessor reads Si tracker dEdx data from the .slcio file and stores them in a root file for analysis.

Parameter Type Default Description
LinkCollectionName string TrackMCTruthLink Name of the LCRelation collection
RootFilename string SiTracker_dEdx.root Name of output root file
TrackCollectionName string SiTracks Name of the input Track collection
TrkHitCollections StringVec ITrackerHits ITrackerEndcapHits OTrackerHits OTrackerEndcapHits VXDTrackerHits VXDEndcapTrackerHits Tracker hit collections that will be analysed
AngularCorrection_dEdxProcessor libMarlinReco.so.1.38.0

description not set by author

Parameter Type Default Description
AngularCorrectionParameters FloatVec 0.970205 0.0007506 4.41781e-08 5.8222e-08 parameter for new angular correction dedx= uncorrected_dedx / f, with f= pol3(lambda)
LDCTrackCollection string MarlinTrkTracks LDC track collection name
BohdanAna libMarlinReco.so.1.38.0

Main analysis of the track length and time-of-flight and momentum methods for time-of-flight pID

Parameter Type Default Description
dst_mode bool false Write only DST level output
eventDisplay bool false eventDisplay
produce_csv_output bool false Produce csv output file for Konrad or not
produce_refit_output bool true Store info about refitted tracks and vertices
BruteForceEcalGapFiller libMarlinReco.so.1.38.0

makes a collection of ECAL gap hits

Parameter Type Default Description
CellIDLayerString string layer name of the part of the cellID that holds the layer
CellIDModuleString string module name of the part of the cellID that holds the module
CellIDStaveString string stave name of the part of the cellID that holds the stave
applyInterModuleCorrection bool true apply correction for gaps between modules?
expectedInterModuleDistance float 7 size of gap across module boundaries (from edge to edge of cells, in mm ; accuracy < cell size)
inputHitCollection string input simcalhit Collection Name
interModuleCorrectionFactor float 0.35 factor applied to calculated energy of inter-module gap hits
interModuleNonlinearFactor float 1 nonlin factor f: E_corr = interModuleCorrectionFactor*(1/f)*log(1 + f*E_calc)
intraModuleCorrectionFactor float 1 factor applied to calculated energy of intra-module gap hits
intraModuleNonlinearFactor float 1 nonlin factor f: E_corr = intraModuleCorrectionFactor*(1/f)*log(1 + f*E_calc)
outputHitCollection string output calorimeterhit Collection Name
CCDDigitizer libMarlinReco.so.1.38.0

CCDDigitizer should create VTX TrackerHits from SimTrackerHits

Parameter Type Default Description
BField double 4 BField in Tesla
BackgroundHitsPerLayer FloatVec 34400 23900 9600 5500 3100 Background Hits per Layer
BiasVolt double 10 BiasVoltage in V
CollectionName string vxd01_VXD Name of the SimTrackerHit collection
CutOnDeltaRays double 0.03 Cut on delta-ray energy (MeV)
Debug int 0 Debug option
ElectricField double 10000 Electric Field in V/cm
ElectronicEffects int 1 Apply Electronic Effects
ElectronicNoise double 100 electronic noise in electrons
ElectronsPerKeV double 270.3 Electrons per keV
EnergyLoss double 280 Energy Loss keV/mm
GenerateBackground int 0 Generate Background
OutputCollectionName string VTXTrackerHits Name of the output TrackerHit collection
PixelSizeX double 0.02 Pixel Size X
PixelSizeY double 0.02 Pixel Size Y
PoissonSmearing int 1 Apply Poisson smearing of electrons collected on pixels
RelationColName string VTXRelation Name of the output VTX trackerhit relation collection
Saturation double 10000 maximum number of electrons, which can be stroed in a pixel
SegmentLength double 0.003 Segment Length
Temperatur double 250 Temperatur in Kelvin
Threshold double 200 Cell Threshold in electrons
depletedDepth double 0.01 Thickness of depleted zone
diffusioncoefficient double 34 diffcoeff in depleted zone in cm^2*S^-1
framesize int 2 size of cluster in reconstruction
mu double 1400 electrons mobility in depleted zoneat low elcectric fields, in cm^2*V^-1*S^-1
reconstructmethod int 1 reconstruction method
undepletedDepth double 0.01 Thickness of undepleted zone
CLICDstChecker libMarlinReco.so.1.38.0

Prints out information in DST in a useful format

Parameter Type Default Description
Debug int 0 Activate debugging?
InputPfoCollection string PandoraPFANewPFOs Input PFO Collection
McParticleCollection string MCParticlesSkimmed Input MC particle collection
Monitoring int 1 Monitoring
PfoToMcRelationCollection string RecoMCTruthLink Input PFO to MC particle relation Collection
ShowBackground int 1 Show background pfo information
CLICPfoSelector libMarlinReco.so.1.38.0

Selects Pfos from full PFO list using timing cuts

Parameter Type Default Description
ChargedPfoLooseTimingCut float 3 ChargedPfoLooseTimingCut
ChargedPfoNegativeLooseTimingCut float -1 ChargedPfoNegativeLooseTimingCut
ChargedPfoNegativeTightTimingCut float -0.5 ChargedPfoNegativeTightTimingCut
ChargedPfoPtCut float 0 ChargedPfoPtCut
ChargedPfoPtCutForLooseTiming float 4 ChargedPfoPtCutForLooseTiming
ChargedPfoTightTimingCut float 1.5 ChargedPfoTightTimingCut
CheckKaonCorrection int 0 CheckKaonCorrection
CheckProtonCorrection int 0 CheckProtonCorrection
ClusterLessPfoTrackTimeCut float 10 ClusterLessPfoTrackTimeCut
CorrectHitTimesForTimeOfFlight int 0 CorrectHitTimesForTimeOfFlight
DisplayRejectedPfos int 0 DisplayRejectedPfos
DisplaySelectedPfos int 0 DisplaySelectedPfos
FarForwardCosTheta float 0.975 FarForwardCosTheta
ForwardCosThetaForHighEnergyNeutralHadrons float 0.95 ForwardCosThetaForHighEnergyNeutralHadrons
ForwardHighEnergyNeutralHadronsEnergy float 10 ForwardHighEnergyNeutralHadronsEnergy
HCalBarrelLooseTimingCut float 20 HCalBarrelLooseTimingCut
HCalBarrelTightTimingCut float 10 HCalBarrelTightTimingCut
HCalEndCapTimingFactor float 1 HCalEndCapTimingFactor
InputPfoCollection string PandoraPFANewPFOs Input PFO Collection
KeepKShorts int 1 KeepKShorts
MaxMomentumForClusterLessPfos float 2 MaxMomentumForClusterLessPfos
MinECalHitsForTiming int 5 MinECalHitsForTiming
MinHCalEndCapHitsForTiming int 5 MinHCalEndCapHitsForTiming
MinMomentumForClusterLessPfos float 0.5 MinMomentumForClusterLessPfos
MinPtForClusterLessPfos float 0.5 MinPtForClusterLessPfos
MinimumEnergyForNeutronTiming float 1 MinimumEnergyForNeutronTiming
Monitoring int 0 Monitoring
MonitoringPfoEnergyToDisplay float 1 MonitoringPfoEnergyToDisplay
NeutralFarForwardLooseTimingCut float 2 NeutralFarForwardLooseTimingCut
NeutralFarForwardTightTimingCut float 1 NeutralFarForwardTightTimingCut
NeutralHadronBarrelPtCutForLooseTiming float 3.5 NeutralHadronBarrelPtCutForLooseTiming
NeutralHadronLooseTimingCut float 2.5 NeutralHadronLooseTimingCut
NeutralHadronPtCut float 0 NeutralHadronPtCut
NeutralHadronPtCutForLooseTiming float 8 NeutralHadronPtCutForLooseTiming
NeutralHadronTightTimingCut float 1.5 NeutralHadronTightTimingCut
PhotonFarForwardLooseTimingCut float 2 PhotonFarForwardLooseTimingCut
PhotonFarForwardTightTimingCut float 1 PhotonFarForwardTightTimingCut
PhotonLooseTimingCut float 2 PhotonLooseTimingCut
PhotonPtCut float 0 PhotonPtCut
PhotonPtCutForLooseTiming float 4 PhotonPtCutForLooseTiming
PhotonTightTimingCut float 1 PhotonTightTimingCut
PtCutForTightTiming float 0.75 PtCutForTightTiming
SelectedPfoCollection string SelectedPandoraPFANewPFOs Selected pfo collection name
UseClusterLessPfos int 1 UseClusterLessPfos
UseNeutronTiming int 0 UseNeutronTiming
CLICPfoSelectorAnalysis libMarlinReco.so.1.38.0

CLICPfoSelectorAnalysis produces a tree and scatter plots using PFO variables defined in the CLICPfoSelector.

Parameter Type Default Description
AnalyzeAll bool true Boolean factor to decide if perform the analysis on all PFOs
AnalyzeChargedPfos bool true Boolean factor to decide if perform the analysis on charged PFOs
AnalyzeNeutralHadrons bool true Boolean factor to decide if perform the analysis on neutral hadrons
AnalyzeOverlay bool true Boolean factor to decide if perform the analysis on only on PFOs belonging to the overlay
AnalyzePhotons bool true Boolean factor to decide if perform the analysis on photons
AnalyzeSignal bool true Boolean factor to decide if perform the analysis only on PFOs belonging to the signal
ClusterMCTruthLink string ClusterMCTruthLink Name of the ClusterMCTruthLink input collection
CosThetaCut float 0.975 Cut on the PFO cosTheta to define central/forward region
ForwardCosThetaForHighEnergyNeutralHadrons float 0.95 ForwardCosThetaForHighEnergyNeutralHadrons
ForwardHighEnergyNeutralHadronsEnergy float 10 ForwardHighEnergyNeutralHadronsEnergy
MCPhysicsParticleCollectionName string MCPhysicsParticles Name of the MCPhysicsParticle input collection
MaxEnergy float 500 Maximum energy (needed for the energy histos)
MinECalHitsForHadrons int 5 Min number of Ecal hits to use clusterTime info from Ecal (for neutral and charged hadrons only)
MinEnergy float 0 Minimum energy (needed for the energy histos)
MinHcalEndcapHitsForHadrons int 5 Min number of Hcal Endcap hits to use clusterTime info from Hcal Endcap (for neutral and charged hadrons only)
PFOCollectionName string PandoraPFOs Name of the PFO collection
RecoMCTruthLink string RecoMCTruthLink Name of the RecoMCTruthLink input collection
SiTracksMCTruthLink string SiTracksMCTruthLink Name of the SiTracksMCTruthLink input collection
TreeName string PfoTree Name of output tree
CheatedMCOverlayRemoval libMarlinReco.so.1.38.0

CheatedMCOverlayRemoval identifies MC particles that are overlay and removes the corresponding PFOs from the collection

Parameter Type Default Description
MCParticleCollection string MCParticlesSkimmed Name of the MCParticle collection
MCTruthRecoLink string MCTruthRecoLink Name of the MCTruthRecoLink input collection
OutputOverlayCollection string PFOsFromOverlay Name of output PFO collection of the Overlay particles
OutputPfoCollection string PFOsWithoutOverlay Name of output PFO collection with Overlay particles removed
RecoMCTruthLink string RecoMCTruthLink Name of the RecoMCTruthLink input collection
RecoParticleCollection string PandoraPFOs Name of the ReconstructedParticles input collection
ClusterCheater5_3 libMarlinReco.so.1.38.0

Creates true clusters...

Parameter Type Default Description
CaloCollections StringVec ECAL HCAL Calorimeter Collection Names
CutBackscatter int 1 Not to connect hist from backscatter
MCParticleCollection string MCParticle Calorimeter Collection Names
MinHitsInCluster int 0 Minimal number of hits in cluster
RelCollection string RelationCaloHit SimCaloHit to CaloHit Relations Collection Name
TrueClusterCollection string TrueClusters Collection of True Clusters
TrueClusterToMCPCollection string TrueClusterToMCP Relation Collection Cluster to MCP
ComprehensivePIDProcessor libMarlinReco.so.1.38.0

ComprehensivePIDProcessor: Determines and evaluates PID

Parameter Type Default Description
PFOCollection string PandoraPFOs PFO input collection
RecoMCTruthLink string RecoMCTruthLink LCRelation from the reconstructed PFOs to the MC particles
TTreeFileName string TTreeFile.root Name of the root file in which the TTree with all observables is stored; in case of extraction it is an optional output with no output if left empty, otherwise it is a necessary input; default: TTreeFile.root
backgroundPDGs IntVec List of PDG numbers that are considered background; default: {}.
cutD0 float 0 PFOs whose first track have a d0 larger than the given value will be ignored; set to 0 to accept all particles; default: 0.
cutLamMax float 0 PFOs whose first track have an angle lambda (relative to the cathode) larger than the given value will be ignored; set to 0 to accept all particles; default: 0.
cutLamMin float 0 PFOs whose first track have an angle lambda (relative to the cathode) smaller than the given value will be ignored; set to 0 to accept all particles; default: 0.
cutNTracksMax int -1 PFOs with more (>) tracks the given value are ignored; set to -1 to accept all PFOs; default: -1.
cutNTracksMin int -1 PFOs with fewer (<) tracks than the given value are ignored; set to -1 to accept all PFOs; default: -1.
cutZ0 float 0 PFOs whose first track have a z0 larger than the given value will be ignored; set to 0 to accept all particles; default: 0.
fileFormat string .png File format of the automatic confusion matrix plots of inference; default: .png
inputAlgoSpecs StringVec List of input algorithms; for each specify type:name or only type (then name=type); default: {}
modeExtract bool true Set true to extract the specified observables from the PFOs; if false you need to set the TTreeFileName instead; default: true.
modeInfer bool false Set true to infer the trained MVA with the specified observables to the PFOs; if true you need to provide the reference and weight files; default: false.
modeTrain bool false Set true to internally train an MVA with the specified observables from the PFOs; default: false.
momLog bool true For momentum bins: should the momentum bins be logarihtmic; default: true.
momMax float 100 For momentum bins: maximum momentum cut / GeV; default: 100.
momMin float 1 For momentum bins: minimum momentum cut / GeV; default: 1.
momNBins int 12 For momentum bins: number of momentum bins; default: 12.
plotFolder string CPID_Plots Folder in which the automatic confusion matrix plots of inference will be put, is created if not already existing; if empty, no plots are created; default: CPID_Plots [current working directory]
reffile StringVec Ref.txt Reference file(s), if only one file but several training models are specified the reference files are auto-numbered; default: {Ref.txt}.
signalPDGs IntVec 11 13 211 321 2212 List of PDG numbers that are considered signal; default: {11,13,211,321,2212}.
trainModelSpecs StringVec List of training models; for each specify type:name or only type (then name=type); default: {}
trainingObservables StringVec List of observables that should be used for traning; if empty, all observables from the specified algorithms + momabs + lambda are used; default: {}
ComputeShowerShapesProcessor libMarlinReco.so.1.38.0

Cluster Shower Profile extraction using Fitting

Parameter Type Default Description
ClusterCollectionName string PandoraClusters Cluster collection name
MoliereRadius_Ecal float 9 Moliere radius of Absorbers
MoliereRadius_Hcal float 17.19 Moliere radius of Absorbers
PFOCollection string PandoraPFOs PFO collection name
RadiationLength_Ecal float 3.5 RadiationLength of Absorbers
RadiationLength_Hcal float 17.57 RadiationLength of Absorbers
Compute_dEdxProcessor libMarlinReco.so.1.38.0

description not set by author

Parameter Type Default Description
AngularCorrectionParameters FloatVec 0.635762 -0.0573237 parameters for angular correction
EnergyLossErrorTPC float 0.054 Fractional error of dEdx in the TPC
LDCTrackCollection string MarlinTrkTracks LDC track collection name
LowerTruncationFraction float 0.08 Lower truncation fraction, default: 0.08 (8%)
NumberofHitsCorrectionParameters float 1.468 parameters for number of hits correction
StrategyCompHist bool false If set, an AIDA root file will be generated with Bethe-Bloch histograms (dE/dx over momentum) for each dx strategy (default: false).
StrategyCompHistFiles string dEdx_Histo_Strategy File names of the generated dx strategy comparison histograms (if chosen). The respective strategy number and '.png' is added.
StrategyCompHistWeight bool false If set, the Bethe-Bloch histograms will have a sqrt(nHits) weighting (default: false).
UpperTruncationFraction float 0.3 Upper truncation fraction, default: 0.3 (30%)
Write_dEdx bool true If set, the calculated dEdx value will be attached to its corresponding track (default: true).
dEdxErrorScalingExponents FloatVec -0.34 -0.45 scaling exponents of the dE/dx error for path length and number of hits, respectively
dxStrategy int 1 ID of the track length calculation: 1 - hit-to-hit distance; 2 - hit-to-hit path length of projected hits; 3 - path over hit row
isSmearing bool false Flag for dEdx Smearing
smearingFactor float 0.035 Smearing factor for dEdx smearing
Compute_dEdxProcessor2021 libMarlinReco.so.1.38.0

description not set by author

Parameter Type Default Description
AngularCorrectionParameters FloatVec 0.948185 0.000520502 3.33231e-05 -1.51052e-07 parameter for new angular correction dedx= uncorrected_dedx / f, with f= pol3(lambda)
EnergyLossErrorTPC float 0.054 Fractional error of dEdx in the TPC
LDCTrackCollection string MarlinTrkTracks LDC track collection name
LowerTruncationFraction float 0.08 Lower truncation fraction, default: 0.08 (8%)
StrategyCompHist bool false If set, an AIDA root file will be generated with Bethe-Bloch histograms (dE/dx over momentum) for each dx strategy (default: false).
StrategyCompHistFiles string dEdx_Histo_Strategy File names of the generated dx strategy comparison histograms (if chosen). The respective strategy number and '.png' is added.
StrategyCompHistWeight bool false If set, the Bethe-Bloch histograms will have a sqrt(nHits) weighting (default: false).
UpperTruncationFraction float 0.3 Upper truncation fraction, default: 0.3 (30%)
Write_dEdx bool true If set, the calculated dEdx value will be attached to its corresponding track (default: true).
dEdxErrorScalingExponents FloatVec -0.34 -0.45 scaling exponents of the dE/dx error for path length and number of hits, respectively
doAngularCorr_dEdx bool false If set, the calculated dEdx value is corrected as function of a pol3(lambda)
dxStrategy int 1 ID of the track length calculation: 1 - hit-to-hit distance; 2 - hit-to-hit path length of projected hits; 3 - path over hit row
isSmearing bool false Flag for dEdx Smearing
smearingFactor float 0.035 Smearing factor for dEdx smearing
CreatePDFProcessor libMarlinReco.so.1.38.0

description not set by author

Parameter Type Default Description
MCTruthLinkCollection string RecoMCTruthLink Input collection of Reconstrcuted Particle
OutputPDFFilename string pdf_standard_v01.root Input collection of Reconstrcuted Particle
RecoParticleCollection string PandoraPFOs Input collection of Reconstrcuted Particle
dEdxErrorFactor float 7.55 dEdx Error factor
dEdxNormalization float 1.35e-07 dEdx Normalization
dEdxParameter_electron FloatVec -0.00240638 0.710337 0.287718 -1.71591 0 dEdx Parameters for electron
dEdxParameter_kaon FloatVec 0.0796117 4133.35 1.13577e+06 0.180555 -0.000315083 dEdx Parameters for Kaon
dEdxParameter_muon FloatVec 0.0811408 0.992207 758509 -0.170167 0.00046367 dEdx Parameters for muon
dEdxParameter_pion FloatVec 0.0810756 -1.45051e+06 -30984.3 0.284056 0.000338131 dEdx Parameters for pion
dEdxParameter_proton FloatVec 0.0778772 44930 91377.8 0.150088 -0.000664184 dEdx Parameters for proton
CreatePDFs libMarlinReco.so.1.38.0

Creates from a gauge sample pdf files for a likelihood based particle identification

Parameter Type Default Description
ChargedPDFfilename string pdf.txt Name of output file for charged particles
ChargedRunStart IntVec Run numbers where a new charged category sample starts
MCParticleCollection string MCParticle Name of the MC Particle collection
MCTracksRelCollection string LDCTracksMCP Name of MC to Tracks Relation collection
NeutralPDFfilename string npdf.txt Name of output file for neutral particles
NeutralRunStart IntVec Run numbers where a new neutral category sample starts
PIDCollection IntVec PIDs of the particles, that should be here
PIDnumbers IntVec number of pids per category
RecoParticleCollection string RecoParticles Name of a reconstructed Particle collection containing PFOs like Wolf, PandoraPFA, ...
RelCollection string RelationCaloHit Name of relation collection
CreateRefitPFO libMarlinReco.so.1.38.0

Create a copy of PandoraPFO collection, where for each Kaon/Proton particle the tracks are substituted from MarlinTrkTracksKaon and MarlinTrkTracksProton colelctions respectively. This simulates scenario as all pi/k/p tracks are fitted with their true mass assuming perfect PID.

No parameters available.
DDStripSplitter libMarlinReco.so.1.38.0

DDStripSplitter applies SSA to a strip-based calorimeter ...

Parameter Type Default Description
CellIDLayerString string layer name of the part of the cellID that holds the layer
CellIDModuleString string module name of the part of the cellID that holds the module
CellIDStaveString string stave name of the part of the cellID that holds the stave
ECALcollection_evenLayers string ECalBarrelScEvenCollectionRec Name of the ECAL collection in even layers
ECALcollection_oddLayers string ECalBarrelScOddCollectionRec Name of the ECAL collection in odd layers
LCRelations_evenLayers string ECalBarrelScHitsEvenRecRelations name of the relation collection for even layer hits
LCRelations_oddLayers string ECalBarrelScHitsOddRecRelations name of the relation collection for odd layer hits
MCParticleCollection string MCParticle name of MCParticle collection (used for some plots)
evenStripEndsCollName string stripEndsEven name of (optional) output collection containing ends of strips in even layers
isBarrelHits bool true are hits in these collections in the barrel (true) or endcap (false) ?
oddStripEndsCollName string stripEndsOdd name of (optional) output collection containing ends of strips in odd layers
saveIntersectionCollection bool false save collection with strip interactions?
splitEcalCollection string ECalBarrelSplitCollection name of output collection containing split hits
splitEcalRelCol string ECalBarrelSplitRelations name of relation collection for split hits
stripIntersecCollName string stripIntersections name of (optional) output collection containing strip intersections
unsplitEcalCollection string ECalBarrelUnSplitCollection name of output collection containing unsplit hits
virtualCellsDefault int 1 number of virtual cells per strip (used if info not found in gear file)
DistilledPFOCreator libMarlinReco.so.1.38.0

description not set by author

Parameter Type Default Description
InputParticleCollectionName1 string PandoraPFOs Input Particle Collection Name1
InputParticleCollectionName2 string GammaGammaParticles Input Particle Collection Name2
OutputParticleCollectionName string DistilledPFOs Output Particle Collection Name
Printing int 1 Print certain messages
EMShowerFinder libMarlinReco.so.1.38.0

a photon finder processor based on the KIT and KITutil 'classes and fuctions'

Parameter Type Default Description
Cleaning string YES To do the cleaning on hits or not
Coscut double 0.95 Cosine of the angle for merging
DebugLevel int 0 limits the amount of information written to std out (0 - none, 9 - maximal information)
Distcut double 35 Square of distance cut for merging
DrawOnCED int 0 draw objects on CED
Levels FloatVec 0.1 1.5 2.5 4 6 9 16 26 41 65 Levels for central loop in MIP
MinHit0 int 4 Minimal Number of hits for ground level cluster
MinHitSplit int 2 Minimal Number of hits for i-th level cluster
NumberOfLevels int 10 Number of levels for central loop
Rcut double 0.4 Fluctuation suprresion cut
TopologicalCut int 5 At which number of neighbors to put the threshold, condition is < so you need to put N+1
colNameECAL string ECAL ECAL Collection Name
collectionNameOfEMShowerCandidates string EMShowerCandidates Name of the collection of EM shower candidates
energyDeviationCut double 0.25 cut on energy deviation of em shower candidates from estimated energy ( abs( (Ecluster - Eestimated)/Eestimated ) < cut )
probabilityDensityCut double 0.001 cut on the probability density to assign hits to shower cores
ErrorFlow libMarlinReco.so.1.38.0

ErrorFlow processor computes total error of a jet based on the information from each sub-detector

Parameter Type Default Description
ConfusionScaleFactor double 1 Scale factor for confusion resolution term
CovMatFactorNeutralHadrons double 1 A correction factor to be multiplied to angular uncertainties of Neutral Hadrons
CovMatFactorPhotons double 1 A correction factor to be multiplied to angular uncertainties of photons
ECALConstant double 0.02 Constant term coefficient in ECAL resolution
ECALStochastic double 0.16 Stochastic term coefficient in ECAL resolution
EnableConfusionTerm bool true Enable/disable confusion term to be added to covariance matrix
EnableSemiLepCorrection bool false Enable/disable semi-leptonic correction resolution to be added to covariance matrix
HCALConstant double 0.01 Constant term coefficient in HCAL resolution
HCALStochastic double 0.5 Stochastic term coefficient in HCAL resolution
InputMCTruthLinkCollection string RecoMCTruthLink Input collection of MC Truth Links
InputPFOCollection string InputJets Input collection of jets
OutputPFOCollection string OutputJets Out collection of jets with calculated covariance matrix
PropagateConfusion2Mom bool true Enable/disable Propagating uncertainty due to confusion to the Momentum components
SemiLepSigmaCorrectionFactor double 0.57 A correction factor to be multiplied by total lepton energy to get semi-leptonic uncertainty
SotreInTree bool false Enable/disable storing computed qunatities in a ROOT tree
useFullCovMatforNeutrals bool true whether use full CovMat for neutral PFOs or use only energy uncertainty
EvaluateTauFinder libMarlinReco.so.1.38.0

EvaluateTauFinder checks performance of TauFinder and writes output to root file.

Parameter Type Default Description
FileName_Signal string Signal.root Name of the Signal output file
MCCollectionName string MCParticlesSkimmed Name of the MCParticle collection
RECOMCTRUTHCollectionName string RecoMCTruthLink Name of the MC Truth PFA collection
TauLinkCollectionName string TauRecLink_PFO Name of the link between tau and pfos
TauRecCollection string TauRec_PFO Collection of Tau Candidates
FPCCDClustering libMarlinReco.so.1.38.0

FPCCDClustering icteats TrackerHits from FPCCDPixelHits

Parameter Type Default Description
ClusterRejection_1stCut_RPhiWidth IntVec 10 10 6 6 6 6 Clusters with RPhiWidth >= this value are discarded. minus value makes cut on the layer inactive
ClusterRejection_1stCut_ZWidth IntVec 15 15 8 8 8 8 Clusters with ZWidth >= this value are discarded. minus value makes cut on the layer inactive
ClusterRejection_1stCut_isActive bool false If true, 1stCut is active. false makes this inactive. minus value makes cut on the layer inactive
ClusterRejection_1stCut_nPix IntVec 20 20 15 15 15 15 Clusters with nPix >= this value are discarded. minus value makes cut on the layer inactive
ClusterRejection_Kamai2ndCut_Save_minimum_Cluster_Z_Width_parameter IntVec 4 4 2 2 2 2 You can choose int[0,~7]. If a cluster with ZWidth <= this value, this is not discarded.
ClusterRejection_Kamai2ndCut_b_parameter FloatVec 2 2 1 1 1 1 You can choose float[0,10]. less than 2 discards most of bad clusters, although some clusters are sacrified. minus value makes cut on the layer inactive
ClusterRejection_Kamai2ndCut_isActive bool false true: active, false: inactive
ClusterRejection_Mori2ndCut_areaZ_parameter FloatVec 90 90 280 280 600 600 You can choose float[0,~900]. 0 discards most of bad clusters, although some clusters are sacrified. minus value makes cut on the layer inactive
ClusterRejection_Mori2ndCut_isActive bool false true: active, false: inactive
Debug int 0 Debugging option
Each_FPCCD_pixelSize(mm) FloatVec 0.005 0.005 0.01 0.01 0.01 0.01 Each ladder's Pixel size of FPCCD (unit:mm) (default:0.005)
ElectronsPerKeV double 276 Electrons per keV
EnergyDigitizatoin int 1 switch for digitization of energy deposit
FPCCD_PixelSize float 0.005 Pixel size of FPCCD (unit:mm) (default: 0.005)
MakeRelationOftrkhitsAndsimthits bool true If false, Clustering doesn't make LCRelation.
NumberOfBitsForEnergyDeposit int 7 Number of Bits used for energy depsit
NumberOfElectronForStep int 25 Number of electron for 1 step
PixelHeight float 0.015 Pixel Height(mm)
PointResolutionRPhi float 0.00144 R-Phi Resolution in VTX
PointResolutionZ float 0.00144 Z Resolution in VTX
RandomNoise int 0 Random noise option
RemovePixelHitsCollection bool false Remove VTX Pixel Hits collection after processing
SimTrackerHitRelCollection string VXDTrackerHitRelations Name of TrackerHit SimTrackerHit relation collection
Threshold double 200 Cell Threshold in electrons
VTXCollectionName string VXDCollection Name of the VTX SimTrackerHit collection
VTXHitCollection string VXDTrackerHits Name of the vxd TrackerHit output collection
VTXPixelHitCollection string VTXPixelHits Name of the VTX PixelHit collection
noiseElectronSigma double 50 gaussian sigma of number of electron of noise
outputRootFileName string ./positionReso.root output root file name & path (default: ./positionReso.root)
positionReso_ReadingFile string MarlinReco/v01-05/TrackDigi/FPCCDDigi/src/FPCCDClustering_ResoMap_MS_EL_ON_ver0.dat On: reading file for allocation of position reso.
positionReso_ReadingFile_ON bool true true: reading file for allocation of position reso. false: rough allocation of position reso.
treeName string t tree name which belongs to the above output root file name & path(default: tree)
FPCCDDigitizer libMarlinReco.so.1.38.0

FPCCDDigitizer should create FPCCD's VTXPixelHits from SimTrackerHits

Parameter Type Default Description
CutOption_mode bool false true make the Cut option active.
CutOption_phi_From double 0 phi From
CutOption_phi_To double 0 phi To
CutOption_theta_From double 0 from
CutOption_theta_To double 0 To
Debug int 0 Debugging option
Each_FPCCD_pixelSize(mm) FloatVec 0.005 0.005 0.005 0.005 0.005 0.005 Each ladder's Pixel size of FPCCD (unit:mm) (default:0.005)
EnergyLoss_almostOFF bool false false : normal mode, true : for computing Spatial Resolution.
FPCCD_pixelSize(mm) float 0.005 Pixel size of FPCCD (unit:mm) (default: 0.005)
HelixTMomentumCriteria(MeV) float 100 Transverse momentum criteria for helix approximation (MeV)
HitQuality bool true If OccupancyStydyMode == 0, this becomes active. Then, true: digitize evt as signal. false: digitize as bkg. Then TrackerHit output from FPCCDClustering has a quality identifying signal hit or bkg hit. If you use FPCCDOverlayBX, I recommend to differentiate inputfile by this option.
Ladder_Number_encoded_in_cellID bool true Mokka has encoded the ladder number in the cellID
OccupancyStudyMode int 0 OccupancyStudyMode==1: We discreminate direct and backscatter. 0:NormalMode for tracking. Make sure HitQuality Option for discreminating signal and BG
PixelHeight(mm) float 0.015 Pixel Height(mm).
VTXCollectionName string VXDCollection Name of the VTX SimTrackerHit collection
VTXPixelHitCollection string VTXPixelHits Name of the VXD PixelHit output collection
isSignalEvent_isBGEvent_forLinkerInClustering int 1 1:SignalEvent 0:BGEvent for FPCCDOverlayBX process and linker in FPCCDClustering.
modifySimTrackerHit bool true Modify SimTrackerHit into layer
sigmaConstant double 32000 ration of sigma of Landau distribution and path length
Fox libMarlinReco.so.1.38.0

Fox calculates Fox-Wolfram moments

Parameter Type Default Description
CalculateFoxWolframMoments IntVec Numbers of the moments that are to be calculate 0-th is calculate by default
NameOfReconstructedParticlesCollection string RecoParticles Name of the ReconstructedParticle collection
G2CD libMarlinReco.so.1.38.0

Gaseous Calorimeter Digitizer: take 1mm Simulated Hits as input

Parameter Type Default Description
CalibrECAL FloatVec 40.91 81.81 Calibration coefficients for ECAL
ChanceOfKink float 0 Chance of one boundary hit to create a multiple hit with boosted charge
ChargeSpatialDistribution FloatVec 0.1 0.2 0.4 0.2 0.1 Spactial Distribution of MIP charge X*Y;
DigiCellSize int 10 Size of Digitized Cell (in mm)
DigiECALCollection StringVec ECALBarrel ECALEndcap ECALOther Name of Digitized ECAL Hit Collections
DigiHCALCollection StringVec HCALBarrel HCALEndcap HCALOther Name of Digitized HCAL Hit Collections
ECALCollections StringVec EcalBarrelSiliconCollection EcalEndcapSiliconCollection EcalEndcapRingCollection Input ECAL Hits Collection Names
ECALThreshold float 5e-05 Threshold for ECAL Hits in GeV
HCALCollections StringVec HcalBarrelRegCollection HcalEndcapsCollection HcalEndcapRingsCollection HCAL Collection Names
KinkHitChargeBoost float 1 Scale factor of Charge on boosted multiple hits
NumThinEcalLayer int 20 Num of thiner Ecal layers
PolyaParaA float 0.7 Polya: x^A*exp(-b*x) + c
PolyaParaB float 0.045 Polya: x^a*exp(-B*x) + c
PolyaParaC float 0.03 Polya: x^a*exp(-b*x) + C
PositionShiftID IntVec 0 0 0 Global Position Shift For Overlay
UsingDefaultDetector int 0 Flag Parameter Setting (0 ~ self definition, 1 ~ MircoMegas, 2 ~ GRPC_PS, 3 ~ GRPC_SPS)
GammaGammaCandidateFinder libMarlinReco.so.1.38.0

description not set by author

Parameter Type Default Description
FitProbabilityCut double 0.001 Minimum fit probability
GammaGammaResonanceMass float 0.135 Nominal Mass of Particle Decaying to Gamma Gamma (GeV)
GammaGammaResonanceName string Pi0 Particle decaying to Gamma Gamma
GammaMomentumCut float 0.5 Minimum Momentum Cut for Photon (GeV)
InputParticleCollectionName string PandoraPFOs Input Particle Collection Name
MaxDeltaMgg float 0.04 Maximum difference between candidate mass and GammaGama Resonance mass (GeV)
OutputParticleCollectionName string GammaGammaCandidates Output Particle Collection Name
Printing int 1 Print certain messages
fitter int 0 0 = OPALFitter, 1 = NewFitter, 2 = NewtonFitter
GammaGammaCandidateTruthFilter libMarlinReco.so.1.38.0

GammaGammaCandidateTruthFilter does whatever it does ...

Parameter Type Default Description
GammaGammaCandidateCollection string GammaGammaCandidates Name of the gamma-gamma candidate input collection
GammaGammaResonanceName string Pi0 Particle decaying to Gamma Gamma
MCParticleCollection string MCParticle Name of the MCParticle input collection
MCTruth2RecoLinkCollectionName string MCTruthRecoLink true - reco relation collection
OutputParticleCollectionName string TrueGammaGammaMesons Output Particle Collection Name
Printing int 1 Print certain messages
Reco2MCTruthLinkCollectionName string RecoMCTruthLink reco - true relation collection
GammaGammaSolutionFinder libMarlinReco.so.1.38.0

description not set by author

Parameter Type Default Description
GammaGammaCandidateCollections StringVec GammaGammaCandidatePi0s GammaGammaCandidateEtas GammaGammaCandidateEtaPrimes Gamma-Gamma Candidate Collection Names
LessThanMaximalCut int 0 Maximum Number of Fewer GammaGammaParticles
MaxCombinationsCut double 1e+08 Maximum Number of Explorable Combinations
OutputParticleCollectionName string GammaGammaSolutions Output Particle Collection Name
Printing int 1 Print certain messages
SolutionFindingAlgorithm int 2 Solution Finding Algorithm
ILDCaloDigi libMarlinReco.so.1.38.0

Performs simple digitization of sim calo hits...

Parameter Type Default Description
CalibECALMIP float 0.0001 calibration to convert ECAL deposited energy to MIPs
CalibHCALMIP float 0.0001 calibration to convert HCAL deposited energy to MIPs
CalibrECAL FloatVec 40.91 81.81 Calibration coefficients for ECAL
CalibrHCALBarrel FloatVec 0 Calibration coefficients for Barrel HCAL
CalibrHCALEndcap FloatVec 0 Calibration coefficients for EndCap HCAL
CalibrHCALOther FloatVec 0 Calibration coefficients for Other (Ring) HCAL
CellIDIndexIString string I name of the part of the cellID that holds the index I
CellIDIndexJString string J name of the part of the cellID that holds the index J
CellIDLayerString string K-1 name of the part of the cellID that holds the layer
CellIDModuleString string M name of the part of the cellID that holds the module
CellIDStaveString string S-1 name of the part of the cellID that holds the stave
ECALBarrelTimeWindowMax float 100 ECAL BarrelTime Window maximum time in ns
ECALCollections StringVec EcalBarrelCollection EcalEndcapCollection EcalRingCollection ECAL Collection Names
ECALCorrectTimesForPropagation int 0 Correct ECAL hit times for propagation: radial distance/c
ECALDeltaTimeHitResolution float 10 ECAL Minimum Delta Time in ns for resolving two hits
ECALEndcapCorrectionFactor float 1.025 Energy correction for ECAL endcap
ECALEndcapTimeWindowMax float 100 ECAL Endcap Time Window maximum time in ns
ECALGapCorrection int 1 Correct for ECAL gaps
ECALGapCorrectionFactor float 1 Factor applied to gap correction
ECALLayers IntVec 20 100 Index of ECal Layers
ECALModuleGapCorrectionFactor float 0.5 Factor applied to module gap correction
ECALOutputCollection0 string ECALBarrel ECAL Collection of real Hits
ECALOutputCollection1 string ECALEndcap ECAL Collection of real Hits
ECALOutputCollection2 string ECALOther ECAL Collection of real Hits
ECALSimpleTimingCut bool true Use simple time window cut on hit times? If false: use original hit-time clustering algorithm. If true: use time window defined by ECALBarrelTimeWindowMin and ECALBarrelTimeWindowMax
ECALThreshold float 5e-05 Threshold for ECAL Hits in GeV
ECALThresholdUnit string GeV Unit for ECAL Threshold. Can be "GeV", "MIP" or "px". MIP and px need properly set calibration constants
ECALTimeResolution float 10 ECAL Time Resolution used to smear hit times
ECALTimeWindowMin float -10 ECAL Time Window minimum time in ns
ECAL_PPD_N_Pixels int 10000 ECAL total number of MPPC/SiPM pixels for implementation of saturation effect
ECAL_PPD_N_Pixels_uncertainty float 0.05 ECAL fractional uncertainty of effective total number of MPPC/SiPM pixels
ECAL_PPD_PE_per_MIP float 7 # Photo-electrons per MIP (scintillator): used to poisson smear #PEs if >0
ECAL_apply_realistic_digi int 0 apply realistic digitisation to ECAL hits? (0=none, 1=silicon, 2=scintillator)
ECAL_deadCellRate float 0 ECAL random dead cell fraction (as a fraction: 0->1)
ECAL_deadCell_memorise bool false store dead ECAL cells in memory? (WARNING: can take a lot of memory if used...)
ECAL_default_layerConfig string 000000000000000 default ECAL layer configuration (used if not found in gear file)
ECAL_elec_noise_mips float 0 typical electronics noise (ECAL, in MIP units)
ECAL_maxDynamicRange_MIP float 2500 maximum of dynamic range for ECAL (in MIPs)
ECAL_miscalibration_correl float 0 correlated ECAL random gaussian miscalibration (as a fraction: 1.0 = 100%)
ECAL_miscalibration_uncorrel float 0 uncorrelated ECAL random gaussian miscalibration (as a fraction: 1.0 = 100%)
ECAL_miscalibration_uncorrel_memorise bool false store oncorrelated ECAL miscalbrations in memory? (WARNING: can take a lot of memory if used...)
ECAL_pixel_spread float 0.05 variation of mppc/sipm pixels capacitance in ECAL (as a fraction: 0.01=1%)
ECAL_strip_absorbtionLength float 1e+06 length scale for absorbtion along scintillator strip (mm)
HCALBarrelTimeWindowMax float 100 HCAL Time Window maximum time in ns
HCALCollections StringVec HcalBarrelRegCollection HcalEndcapRingsCollection HcalEndcapsCollection HCAL Collection Names
HCALCorrectTimesForPropagation int 0 Correct HCAL hit times for propagation: radial distance/c
HCALDeltaTimeHitResolution float 10 HCAL Minimum Delta Time in ns for resolving two hits
HCALEndcapCorrectionFactor float 1.025 Energy correction for HCAL endcap
HCALEndcapTimeWindowMax float 100 HCAL Time Window maximum time in ns
HCALGapCorrection int 1 Correct for ECAL gaps
HCALLayers IntVec 100 Index of HCal Layers
HCALModuleGapCorrectionFactor float 0.5 Factor applied to module gap correction
HCALOutputCollection0 string HCALBarrel HCAL Collection of real Hits
HCALOutputCollection1 string HCALEndcap HCAL Collection of real Hits
HCALOutputCollection2 string HCALOther HCAL Collection of real Hits
HCALSimpleTimingCut bool true Use simple time window cut on hit times? If false: use original hit-time clustering algorithm. If true: use time window defined by HCALBarrelTimeWindowMin and HCALBarrelTimeWindowMax
HCALThreshold FloatVec 4e-05 Threshold for HCAL Hits in GeV
HCALThresholdUnit string GeV Unit for HCAL Threshold. Can be "GeV", "MIP" or "px". MIP and px need properly set calibration constants
HCALTimeResolution float 10 HCAL Time Resolution used to smear hit times
HCALTimeWindowMin float -10 HCAL Time Window minimum time in ns
HCAL_PPD_N_Pixels int 400 HCAL total number of MPPC/SiPM pixels for implementation of saturation effect
HCAL_PPD_N_Pixels_uncertainty float 0.05 HCAL fractional uncertainty of effective total number of MPPC/SiPM pixels
HCAL_PPD_PE_per_MIP float 10 # Photo-electrons per MIP (for AHCAL): used to poisson smear #PEs if >0
HCAL_apply_realistic_digi int 0 apply realistic digitisation to HCAL hits? (0=none, 1=scintillator/SiPM)
HCAL_deadCellRate float 0 HCAL random dead cell fraction (as a fraction: 0->1)
HCAL_deadCell_memorise bool false store dead HCAL cells in memory? (WARNING: can take a lot of memory if used...)
HCAL_elec_noise_mips float 0 typical electronics noise (HCAL, in MIP units)
HCAL_maxDynamicRange_MIP float 200 maximum of dynamic range for HCAL (in MIPs)
HCAL_miscalibration_correl float 0 correlated HCAL random gaussian miscalibration (as a fraction: 1.0 = 100%)
HCAL_miscalibration_uncorrel float 0 uncorrelated HCAL random gaussian miscalibration (as a fraction: 1.0 = 100%)
HCAL_miscalibration_uncorrel_memorise bool false store oncorrelated HCAL miscalbrations in memory? (WARNING: can take a lot of memory if used...)
HCAL_pixel_spread float 0 variation of mppc/sipm pixels capacitance in HCAL (as a fraction: 0.01=1%)
Histograms int 0 Hit times histograms
IfDigitalEcal int 0 Digital Ecal
IfDigitalHcal int 0 Digital Hcal
MapsEcalCorrection int 0 Ecal correction for theta dependency of calibration for MAPS
RelationOutputCollection string RelationCaloHit CaloHit Relation Collection
StripEcal_default_nVirtualCells int 9 default number of virtual cells (used if not found in gear file)
UseEcalTiming int 0 Use ECAL hit times
UseHcalTiming int 1 Use HCAL hit times
energyPerEHpair float 3.6 energy required to create e-h pair in silicon (in eV)
IsoLepTrainingProcessor libMarlinReco.so.1.38.0

IsoLepTrainingProcessor does whatever it does ...

Parameter Type Default Description
InputMCParticlesCollection string MCParticlesSkimmed Name of the MCParticle collection
InputMCTruthLinkCollection string RecoMCTruthLink Name of the MCTruthLink collection
InputPandoraPFOsCollection string PandoraPFOs Name of the PandoraPFOs collection
InputPrimaryVertexCollection string PrimaryVertex Name of the Primary Vertex collection
IsForSignal bool true Is for signal?
IsLepTune bool true Is lepton tune?
IsoLepType int 13 Isolated Lepton Type
MCDebugging bool false set true if you want to check generator information
IsolatedLeptonFinderProcessor libMarlinReco.so.1.38.0

Isolated Lepton Finder Processor

Parameter Type Default Description
CosConeAngle float 0.98 Cosine of the half-angle of the cone used in isolation criteria
DressPhotonConeAngle float 1 Half-angle (in degrees) of the cone used for lepton dressing with photons
ElectronMaxEcalToHcalFraction float 1 Electron ID: Maximum Ecal deposit divided by sum of Ecal and Hcal deposits
ElectronMaxEnergyDepositByMomentum float 1.4 Electron ID: Maximum energy deposit divided by momentum
ElectronMinEcalToHcalFraction float 0.9 Electron ID: Minimum Ecal deposit divided by sum of Ecal and Hcal deposits
ElectronMinEnergyDepositByMomentum float 0.7 Electron ID: Minimum energy deposit divided by momentum
ImpactParameterMax3D float 0.01 Maximum impact parameter in 3D
ImpactParameterMax3DSignificance float 1e+20 Maximum impact parameter significance in 3D
ImpactParameterMaxD0 float 1e+20 Maximum d0 impact parameter
ImpactParameterMaxD0Significance float 1e+20 Maximum d0 impact parameter significance
ImpactParameterMaxZ0 float 1e+20 Maximum z0 impact parameter
ImpactParameterMaxZ0Significance float 1e+20 Maximum z0 impact parameter significance
ImpactParameterMin3D float 0 Minimum impact parameter in 3D
ImpactParameterMin3DSignificance float 0 Minimum impact parameter significance in 3D
ImpactParameterMinD0 float 0 Minimum d0 impact parameter
ImpactParameterMinD0Significance float 0 Minimum d0 impact parameter significance
ImpactParameterMinZ0 float 0 Minimum z0 impact parameter
ImpactParameterMinZ0Significance float 0 Minimum z0 impact parameter significance
InputCollection string PandoraPFOs Input collection of ReconstructedParticles
IsolationMaximumConeEnergy float 1e+20 Maximum cone energy for isolation requirement
IsolationMaximumTrackEnergy float 1e+20 Maximum track energy for isolation requirement
IsolationMinimumConeEnergy float 0 Minimum cone energy for isolation requirement
IsolationMinimumTrackEnergy float 15 Minimum track energy for isolation requirement
IsolationPolynomialCutA float 0 Polynomial cut (A) on track energy and cone energy: Econe^2 < A*Etrk^2+B*Etrk+C
IsolationPolynomialCutB float 20 Polynomial cut (B) on track energy and cone energy: Econe^2 < A*Etrk^2+B*Etrk+C
IsolationPolynomialCutC float -300 Polynomial cut (C) on track energy and cone energy: Econe^2 < A*Etrk^2+B*Etrk+C
JetCollection string JetsForIsolation Input collection of jets for isolation
JetIsolationVetoMaximumXt float 0.25 Maximum Xt in jet-based isolation
JetIsolationVetoMaximumZ float 0.6 Maximum Z in jet-based isolation
JetIsolationVetoMinimumXt float 0 Minimum Xt in jet-based isolation
JetIsolationVetoMinimumZ float 0 Mininum Z in jet-based isolation
MergeCloseElectrons bool false Merge close-by electrons into higher energy lepton
MergeLeptonConeAngle float 2 Half-angle (in degrees) of the cone used for lepton merging
MuonMaxEcalToHcalFraction float 0.4 Muon ID: Maximum Ecal deposit divided by sum of Ecal and Hcal deposits
MuonMaxEnergyDepositByMomentum float 0.3 Muon ID: Maximum energy deposit divided by momentum
MuonMinEcalToHcalFraction float 0 Muon ID: Minimum Ecal deposit divided by sum of Ecal and Hcal deposits
MuonMinEnergyDepositByMomentum float 0 Muon ID: Minimum energy deposit divided by momentum
OutputCollectionIsolatedLeptons string Isolep Output collection of isolated leptons
OutputCollectionWithoutIsolatedLepton string PandoraPFOsWithoutIsoLep Copy of input collection but without the isolated leptons
UseDressedLeptons bool false Dress leptons with close-by particles
UseImpactParameter bool true Use impact parameter cuts for consistency with primary/secondary track
UseImpactParameterSignificance bool false Use impact parameter significance cuts for consistency with primary/secondary track
UseJetIsolation bool false Use jet-based isolation
UsePID bool true Use primitive particle ID based on calorimeter energy deposits
UsePandoraIDs bool false Use Pandora particle IDs for algorithm
UsePolynomialIsolation bool true Use polynomial cuts on track and cone energy
UseRectangularIsolation bool true Use rectangular cuts on track and cone energy
IsolatedLeptonTaggingProcessor libMarlinReco.so.1.38.0

IsolatedLeptonTaggingProcessor does whatever it does ...

Parameter Type Default Description
CosConeLarge float 0.95 cosine of the larger cone
CosConeSmall float 0.98 cosine of the smaller cone
CutOnTheISOElectronMVA float 0.5 Cut on the mva output of isolated electron selection
CutOnTheISOMuonMVA float 0.7 Cut on the mva output of isolated muon selection
DirOfISOElectronWeights string isolated_electron_weights Directory of Weights for the Isolated Electron MVA Classification
DirOfISOMuonWeights string isolated_muon_weights Directory of Weights for the Isolated Muon MVA Classification
InputPandoraPFOsCollection string PandoraPFOs Name of the PandoraPFOs collection
InputPrimaryVertexCollection string PrimaryVertex Name of the Primary Vertex collection
IsSelectingOneIsoLep bool true flag to select one most like isolated lepton
MaxD0SigForElectron float 50 Maximum d0 significance for electron
MaxD0SigForMuon float 5 Maximum D0 significance for muon
MaxEOverPForElectron float 1.3 Maximum ratio of energy in calorimeters over momentum for electron
MaxEOverPForMuon float 0.3 Maximum ratio of energy in calorimeters over momentum for muon
MaxZ0SigForElectron float 5 Maximum Z0 significance for electron
MaxZ0SigForMuon float 5 Maximum Z0 significance for muon
MinEOverPForElectron float 0.5 minimum ratio of energy in calorimeters over momentum for electron
MinEecalOverTotEForElectron float 0.9 minimum ratio of energy in ecal over energy in ecal+hcal
MinEyokeForMuon float 1.2 Minimum energy in yoke for electron
MinPForElectron float 5 Minimum momentum for electron
MinPForMuon float 5 Minimum momentum for muon
OutputIsoLeptonsCollection string ISOLeptons Name of collection with the selected isolated lepton
OutputPFOsWithoutIsoLepCollection string PandoraPFOsWithoutIsoLep Name of the new PFOs collection without isolated lepton
UseIP bool true use impact parameters
UseYokeForMuonID bool true use yoke for muon ID
IsolatedPhotonTaggingProcessor libMarlinReco.so.1.38.0

IsolatedPhotonTaggingProcessor does whatever it does ...

Parameter Type Default Description
CosConeLarge float 0.95 cosine of the larger cone
CosConeSmall float 0.98 cosine of the smaller cone
CutOnTheISOPhotonMVA float 0.5 Cut on the mva output of isolated photon selection
DirOfISOPhotonWeights string isolated_photon_weights Directory of Weights for the Isolated Photon MVA Classification
InputPandoraPFOsCollection string PandoraPFOs Name of the PandoraPFOs collection
IsSelectingOneIsoPhoton bool false flag to select one most like isolated photon
MinEForPhoton float 5 Minimum energy for photon
OutputIsoPhotonsCollection string ISOPhotons Name of collection with the selected isolated photon
OutputPFOsWithoutIsoPhotonCollection string PandoraPFOsWithoutIsoPhoton Name of the new PFOs collection without isolated photon
RatioChargedConeEnergy float 0.1 Cut on the ratio of Charged Cone Energy over Photon Energy
RatioNeutralConeEnergy float 0.2 Cut on the ratio of Neutral Cone Energy over Photon Energy
JetPFOsProcessor libMarlinReco.so.1.38.0

JetPFOsProcessor does whatever it does ...

Parameter Type Default Description
InputJetCollection string JetsFromKt Name of the input jet collection
OutputPFOsCollection string PFOsFromKtJet Name of the output PFOs collection
KIT libMarlinReco.so.1.38.0

KIT does whatever it does ...

Parameter Type Default Description
Cleaning string YES To do the cleaning on hits or not
Core_Collection string CORE Name of the Cluster Collection for Cores
Coscut double 0.95 Cosine of the angle for merging
Distcut double 35 Square of distance cut for merging
ECAL_Collection string ECAL Name of the CalorimeterHit Collection for ECAL
Levels FloatVec 0.1 1.5 2.5 4 6 9 16 26 41 65 Levels for central loop in MIP
MinHit0 int 4 Minimal Number of hits for ground level cluster
MinHitSplit int 2 Minimal Number of hits for i-th level cluster
NumberOfLevels int 10 Number of levels for central loop
Rcut double 0.4 Fluctuation suprresion cut
TopologicalCut int 5 At which number of neighbors to put the threshold, condition is < so you need to put N+1
KinkFinder libMarlinReco.so.1.38.0

Kink Finder Processor : finds kinks, prongs and splits

Parameter Type Default Description
CutOnRadius float 100 Cuts on Kink radius
DebugPrinting int 0 Debug level
HyperonDecayMassCut float 0.15 Cuts on kink mass for hyperon decay
HyperonTimeCut float 6 Cuts on lifetime for hyperon decay
KaonDecayMassCut float 0.075 Cuts on kink mass for kaon decay
KinkProjectionCutSIT float 10 Cuts on kink distance of closest approach in SIT
KinkProjectionCutTPC float 20 Cuts on kink distance of closest approach in TPC
KinkRecoParticleCollection string KinkRecoParticles Name of output collection of kink reconstructed particles
KinkVertexCollection string KinkVertices Name of output collection of kink vertices
LooseProjectionCutSIT float 10 Cuts on kink distance of closest approach in SIT
MaxDeltaTpcLayers int 10 Cuts on Kink DeltaRxy for tracks in TPC
MinELambda float 2 Minimum Lambda Energy
MinimumTrackHits int 5 cuts on number of track hits
PionDecayMassCut float 0.03 Cuts on kink mass for pion decay
ProngRecoParticleCollection string ProngRecoParticles Name of output collection of prong reconstructed particles
ProngVertexCollection string ProngVertices Name of output collection of prong vertices
SigmaDecayMassCut float 0.15 Cuts on kink mass for sigma decay
SigmaTimeCut float 6 Cuts on lifetime for sigma decay
SplitRecoParticleCollection string SplitRecoParticles Name of output collection of split reconstructed particles
SplitTrackMaxDeltaP float 0.2 Maximum difference in deltaP for split tracks
SplitTrackMaxFracDeltaP float 0.02 Maximum fractional difference in deltaP for split tracks
SplitVertexCollection string SplitVertices Name of output collection of split vertices
TightKinkProjectionCutTPC float 5 Tight Cut on kink distance of closest approach in TPC
TrackCollection string LDCTracks Name of input collection of reconstructed particles
VeryTightKinkProjectionCutTPC float 1 Very Tight Cut on kink distance of closest approach in TPC
LDCCaloDigi libMarlinReco.so.1.38.0

Performs simple digitization of sim calo hits...

Parameter Type Default Description
CalibrECAL FloatVec 40.91 81.81 Calibration coefficients for ECAL
CalibrHCAL FloatVec 34.8 Calibration coefficients for HCAL
ECALCollections StringVec EcalBarrelCollection EcalEndcapCollection EcalRingCollection ECAL Collection Names
ECALGapCorrection int 1 Correct for ECAL gaps
ECALGapCorrectionFactor float 1 Factor applied to gap correction
ECALLayers IntVec 20 100 Index of ECal Layers
ECALModuleGapCorrectionFactor float 0.5 Factor applied to module gap correction
ECALOutputCollection string ECAL ECAL Collection of real Hits
ECALThreshold float 5e-05 Threshold for ECAL Hits in GeV
ECAlEndcapCorrectionFactor float 1.025 Energy correction for endcap
HCALCollections StringVec HcalBarrelRegCollection HcalEndcapRingsCollection HcalEndcapsCollection HCAL Collection Names
HCALLayers IntVec 100 Index of HCal Layers
HCALOutputCollection string HCAL HCAL Collection of real Hits
HCALThreshold float 0.00025 Threshold for HCAL Hits in GeV
IfDigitalEcal int 0 Digital Ecal
IfDigitalHcal int 0 Digital Hcal
RelationOutputCollection string RelationCaloHit CaloHit Relation Collection
LeptonIDProcessor libMarlinReco.so.1.38.0

The LeptonIDProcessor is used to identify electrons and muons using TMVA classifiers. It also produces the TTrees needed to train them

Parameter Type Default Description
BuildTree bool true Decides if the Processor builds a TTree that can be used for MVA training
EvalMVA bool false Decides if the Processor does the MVA evaluation (requires weight files)
InputPFOsName string DistilledPFOs Name of the PFO collection the training or evaluation should be done on
MCTruthRecoCweightCut float 0.5 Cut used on MCTruthRecoCluster weight
MCTruthRecoLinkName string MCTruthRecoLink Name of the MCTruthRecoLink collection
MCTruthRecoTweightCut float 0.5 Cut used on MCTruthRecoTrack weight
PandoraClustersName string PandoraClusters Name of the PandoraClusters collection
PandoraPFOsName string PandoraPFOs Name of the collection holding the PID info usually PandoraPFOs
RecoMCTruthCweightCut float 0.8 Cut used on RecoMCTruthCluster weight
RecoMCTruthLinkName string RecoMCTruthLink Name of the RecoMCTruthLink collection
RecoMCTruthTweightCut float 0.5 Cut used on RecoMCTruthTrack weight
UsedVariables StringVec e_over_p ecal_share seenEcalDep seenYokeDep shape0 shape1 shape8 shape17 shape19 shape20 shape21 shape22 shape23 cluEllipsoid_r1 cluEllipsoid_r2 cluEllipsoid_r3 cluEllipsoid_r_ave cluEllipsoid_density cluEllipsoid_eccentricity_T cluEllipsoid_eccentricity_L dEdxDist_e List of variables used during training
dEdxname string dEdxPIDv2 Name used to read the dEdx distance from the PandoraPFO collection parameters.
mvaname string BDTG Name given to the MVA method during training, e.g. BDTG.
pidname string LeptonID Name used to store the PID results in the ReconstructedParticle collection.
weightfile string weights/PID_multi_jet_dEdx_800t_cm50r80_BDTG.weights.xml path to the BDTG weightfile
LikelihoodPIDProcessor libMarlinReco.so.1.38.0

description not set by author

Parameter Type Default Description
CostMatrix FloatVec 0 1 1 1 1 1 0 9 1 1 1 1 0 1 1 1 1 30 0 1 1 1 1 10 0 cost matrix for risk based bayesian classifier
EnergyBoundaries FloatVec Boundaries for energy
FilePDFName string pdf_ParticleID_ok.root rootfile of PDF
FileWeightFormupiSeparationName StringVec TMVAClassification_BDTG_02GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_03GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_04GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_05GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_06GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_07GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_08GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_09GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_10GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_11GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_12GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_13GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_14GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_15GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_16GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_17GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_18GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_19GeVP_clusterinfo.weights.xml TMVAClassification_BDTG_20GeVP_clusterinfo.weights.xml weight file for low momentum mu pi separation
PIDMethodsToRun StringVec BasicVariablePID LowMomMuID ShowerShapesPID dEdxPID LikelihoodPID methods to be run, default: BasicVariablePID LowMomMuID ShowerShapesPID dEdxPID LikelihoodPID
PIDMethodsToRun_version string version of the methods (for rerunning purposes)
RecoParticleCollection string PandoraPFOs Input collection of Reconstrcuted Particle
UseBayesian int 2 PID is based on Bayesian or Likelihood
UseLowMomentumMuPiSeparation bool true MVA mu/pi separation should be used or not
dEdxErrorFactor float 7.55 dEdx Error factor
dEdxNormalization float 1.35e-07 dEdx Normalization
dEdxParameter_electron FloatVec -0.00240638 0.710337 0.287718 -1.71591 0 dEdx Parameters for electron
dEdxParameter_kaon FloatVec 0.0796117 4133.35 1.13577e+06 0.180555 -0.000315083 dEdx Parameters for Kaon
dEdxParameter_muon FloatVec 0.0811408 0.992207 758509 -0.170167 0.00046367 dEdx Parameters for muon
dEdxParameter_pion FloatVec 0.0810756 -1.45051e+06 -30984.3 0.284056 0.000338131 dEdx Parameters for pion
dEdxParameter_proton FloatVec 0.0778772 44930 91377.8 0.150088 -0.000664184 dEdx Parameters for proton
MCTruthJetEnergy libMarlinReco.so.1.38.0

MCTruthJetEnergy calculates the MC truth jet energy of the MCParticles associated to the reconstructed particles in the jet

Parameter Type Default Description
JetCollectionNames StringVec FTSelected_2Jets FTSelected_3Jets FTSelected_4Jets FTSelected_5Jets FTSelected_6Jets Names of the Jet collections
MCTruthRelationName string RecoMCTruthLink Name of the ReconstructedParticle-MCParticle relation collection
MokkaCaloDigi libMarlinReco.so.1.38.0

Mokka digitizer...

Parameter Type Default Description
CalibrECAL FloatVec 31.3 83 Calibration coefficients for ECAL
CalibrHCAL FloatVec 27.3 Calibration coefficients for HCAL
ECALCollections StringVec SEcal01_EcalEndcap SEcal01_EcalBarrel ECAL Collection Names
ECALLayers IntVec 30 100 Index of ECal Layers
ECALThreshold float 0.0001 Threshold for ECAL Hits in GeV
HCALCollections StringVec SHcal01_HcalBarrelEnd SHcal01_HcalBarrelReg SHcal01_HcalEndCaps HCAL Collection Names
HCALLayers IntVec 100 Index of HCal Layers
HCALThreshold float 0.0004 Threshold for HCAL Hits in GeV
IfDigitalEcal int 0 Digital Ecal
IfDigitalHcal int 0 Digital Hcal
NewECALCollName string ECAL name for the new collection of ECAL hits
NewHCALCollName string HCAL name for the new collection of HCAL hits
RelationCollName string RelationCaloHit name for collection of relations between CalorimeterHits and SimCalorimeterHits
MomentumCov libMarlinReco.so.1.38.0

MomentumCov calculate the covariance matrix in the momenta space.

Parameter Type Default Description
InputPandoraPFOsCollection string PandoraPFOs Name of the PandoraPFOs collection
OutputNewPFOsCollection string Newpfos Name of the new PFOs collection with covariance matrix
NNClusterProcessor libMarlinReco.so.1.38.0

NNClusterProcessor : simple nearest neighbour clustering

Parameter Type Default Description
DistanceCut float 40 Cut for distance between hits in mm
EnergyCut float 0 Cut for hit energy in GeV
HitCollections StringVec ecal Name of the input collections
OutputCollection string NNClusters Name of the output collections
NewLDCCaloDigi libMarlinReco.so.1.38.0

Performs simple digitization of sim calo hits...

Parameter Type Default Description
CalibrECAL FloatVec 40.91 81.81 Calibration coefficients for ECAL
CalibrHCAL FloatVec 34.8 Calibration coefficients for HCAL
CellIDLayerString string K-1 name of the part of the cellID that holds the layer
CellIDModuleString string M name of the part of the cellID that holds the module
CellIDStaveString string S-1 name of the part of the cellID that holds the stave
ECALCollections StringVec EcalBarrelCollection EcalEndcapCollection EcalRingCollection ECAL Collection Names
ECALEndcapCorrectionFactor float 1.025 Energy correction for ECAL endcap
ECALGapCorrection int 1 Correct for ECAL gaps
ECALGapCorrectionFactor float 1 Factor applied to gap correction
ECALLayers IntVec 20 100 Index of ECal Layers
ECALModuleGapCorrectionFactor float 0.5 Factor applied to module gap correction
ECALOutputCollection0 string ECALBarrel ECAL Collection of real Hits
ECALOutputCollection1 string ECALEndcap ECAL Collection of real Hits
ECALOutputCollection2 string ECALOther ECAL Collection of real Hits
ECALThreshold float 5e-05 Threshold for ECAL Hits in GeV
HCALCollections StringVec HcalBarrelRegCollection HcalEndcapRingsCollection HcalEndcapsCollection HCAL Collection Names
HCALEndcapCorrectionFactor float 1.025 Energy correction for HCAL endcap
HCALLayers IntVec 100 Index of HCal Layers
HCALOutputCollection0 string HCALBarrel HCAL Collection of real Hits
HCALOutputCollection1 string HCALEndcap HCAL Collection of real Hits
HCALOutputCollection2 string HCALOther HCAL Collection of real Hits
HCALThreshold FloatVec 4e-05 Threshold for HCAL Hits in GeV
IfDigitalEcal int 0 Digital Ecal
IfDigitalHcal int 0 Digital Hcal
RelationOutputCollection string RelationCaloHit CaloHit Relation Collection
PFOID libMarlinReco.so.1.38.0

Performs particle identification

Parameter Type Default Description
Debug int 0 Debugging?
EnergyBoundaries FloatVec 0 10 1e+07 Boundary for energy binning
FilePDFName StringVec pdf_charged_lt10.txt pdf_charged_ge10.txt Name of files containing pdfs for charged particles (order of files must be consistent with parameter EnergyBoundaries!!)
RecoParticleCollection string RecoParticles Name of the PFO collection
neutralFilePDFName StringVec pdf_neutral_lt10.txt pdf_neutral_ge10.txt Name of files containing pdfs for neutral particles (order of files must be consistent with parameter EnergyBoundaries!!)
PrepareRECParticles libMarlinReco.so.1.38.0

PrepareRECParticles converts input to ReconstructedParticles and puts them into a new collection making sure all the information which is needed to run the TauFinder is provided.

Parameter Type Default Description
MCCollectionName string MCParticlesSkimmed Name of the MCParticle collection
MCRECLinkCollectionName string MCRecLink Name of the MC Truth ReconstructedParticle collection
RecCollection string MCParticles_tau Collection of Rec Particles for TauFinder
RecCollection_Tracks string Tracks_tau Collection of Rec Particles for TauFinder
TrackCollectionName string LDCTracks Name of the Track collection
TrackRECLinkCollectionName string TracksRecLink Name of the Track Truth ReconstructedParticle collection
outputColMC string MCParticles_tau Name of the output Collection of refilled information
outputColTracks string Tracks_tau Name of the output Collection of refilled information
QuarkJetPairing libMarlinReco.so.1.38.0
Parameter Type Default Description
InputJetCollection string NewJets Input collection of jets
InputMCPCollection string MCParticlesSkimmed Input collection of MCParticles
RealisticCaloDigiScinPpd libMarlinReco.so.1.38.0

Performs digitization of sim calo hits...

Parameter Type Default Description
CellIDLayerString string K-1 name of the part of the cellID that holds the layer
calibration_mip float 0.0001 average G4 deposited energy by MIP for calibration
deadCell_fraction float 0 random dead cell fraction (as a fraction: 0->1)
deadCell_memorise bool false store dead cells in memory? (i.e. use same dead cells in each event. WARNING: can take a lot of memory if used...)
elec_noise_mip float 0 typical electronics noise (in MIP units)
elec_range_mip float 2500 maximum of dynamic range of electronics (in MIPs)
fastShaper float 0 Fast shaper value. Unit in ns
inputHitCollections StringVec SimCalorimeterHits input simcalhit Collection Names
integrationMethod string Standard Energy integration and time calculation method. Options: Standard, ROC
miscalibration_correl float 0 correlated random gaussian miscalibration (as a fraction: 1.0 = 100%)
miscalibration_uncorrel float 0 uncorrelated random gaussian miscalibration (as a fraction: 1.0 = 100%)
miscalibration_uncorrel_memorise bool false store oncorrelated miscalbrations in memory? (i.e. use same miscalibrations in each event. WARNING: can take a lot of memory if used...)
outputHitCollections StringVec output calorimeterhit Collection Names
outputRelationCollections StringVec output hit relatiob Collection Names
ppd_mipPe float 10 # Photo-electrons per MIP (scintillator): used to poisson smear #PEs if >0
ppd_npix int 10000 total number of MPPC/SiPM pixels for implementation of saturation effect
ppd_npix_uncert float 0.05 fractional uncertainty of effective total number of MPPC/SiPM pixels
ppd_pix_spread float 0.05 variation of PPD pixel signal (as a fraction: 0.01=1%)
slowShaper float 0 Slow shaper value. Unit in ns
threshold float 0.5 Threshold for Hit
thresholdUnit string MIP Unit for threshold. Can be "GeV", "MIP" or "px". MIP and px need properly set calibration constants
timingCorrectForPropagation int 0 Correct hit times for propagation: radial distance/c
timingCut int 0 Use hit times
timingResolution float 0 Time resolution to apply (gaussian smearing). Unit in ns
timingWindowMax float 100 Time Window maximum time in ns
timingWindowMin float -10 Time Window minimum time in ns
RealisticCaloDigiSilicon libMarlinReco.so.1.38.0

Digitization of silicon simcalo hits

Parameter Type Default Description
CellIDLayerString string K-1 name of the part of the cellID that holds the layer
calibration_mip float 0.0001 average G4 deposited energy by MIP for calibration
deadCell_fraction float 0 random dead cell fraction (as a fraction: 0->1)
deadCell_memorise bool false store dead cells in memory? (i.e. use same dead cells in each event. WARNING: can take a lot of memory if used...)
elec_noise_mip float 0 typical electronics noise (in MIP units)
elec_range_mip float 2500 maximum of dynamic range of electronics (in MIPs)
fastShaper float 0 Fast shaper value. Unit in ns
inputHitCollections StringVec SimCalorimeterHits input simcalhit Collection Names
integrationMethod string Standard Energy integration and time calculation method. Options: Standard, ROC
miscalibration_correl float 0 correlated random gaussian miscalibration (as a fraction: 1.0 = 100%)
miscalibration_uncorrel float 0 uncorrelated random gaussian miscalibration (as a fraction: 1.0 = 100%)
miscalibration_uncorrel_memorise bool false store oncorrelated miscalbrations in memory? (i.e. use same miscalibrations in each event. WARNING: can take a lot of memory if used...)
outputHitCollections StringVec output calorimeterhit Collection Names
outputRelationCollections StringVec output hit relatiob Collection Names
silicon_pairEnergy float 3.6 energy required to create e-h pair in silicon (in eV)
slowShaper float 0 Slow shaper value. Unit in ns
threshold float 0.5 Threshold for Hit
thresholdUnit string MIP Unit for threshold. Can be "GeV", "MIP" or "px". MIP and px need properly set calibration constants
timingCorrectForPropagation int 0 Correct hit times for propagation: radial distance/c
timingCut int 0 Use hit times
timingResolution float 0 Time resolution to apply (gaussian smearing). Unit in ns
timingWindowMax float 100 Time Window maximum time in ns
timingWindowMin float -10 Time Window minimum time in ns
RealisticCaloRecoScinPpd libMarlinReco.so.1.38.0

Performs fist reconstruction of scintillator calo hits

Parameter Type Default Description
CellIDLayerString string K-1 name of the part of the cellID that holds the layer
calibration_factorsMipGev FloatVec Calibration coefficients (MIP->shower GeV) of layers groups
calibration_layergroups IntVec grouping of calo layers
inputHitCollections StringVec input hit collection names
inputRelationCollections StringVec input relation collection names (digi<->sim), one per inputHitCollection
outputHitCollections StringVec output hit collection names
outputRelationCollections StringVec output hit collection names
ppd_mipPe float 10 # Photo-electrons per MIP (scintillator): used to poisson smear #PEs if >0
ppd_npix int 10000 total number of MPPC/SiPM pixels for implementation of saturation effect
RealisticCaloRecoSilicon libMarlinReco.so.1.38.0

Performs fist reconstruction of silicon ECAL hits

Parameter Type Default Description
CellIDLayerString string K-1 name of the part of the cellID that holds the layer
calibration_factorsMipGev FloatVec Calibration coefficients (MIP->shower GeV) of layers groups
calibration_layergroups IntVec grouping of calo layers
inputHitCollections StringVec input hit collection names
inputRelationCollections StringVec input relation collection names (digi<->sim), one per inputHitCollection
outputHitCollections StringVec output hit collection names
outputRelationCollections StringVec output hit collection names
RecoMCTruthLinker libMarlinReco.so.1.38.0

links RecontructedParticles to the MCParticle based on number of hits used

Parameter Type Default Description
BremsstrahlungEnergyCut float 1 energy cut for Brems that are kept
CalohitMCTruthLinkName string Name of the updated calo-hit MCTruthLink output collection - not created if empty()
ClusterCollection string PandoraClusters Name of the Clusters input collection
ClusterMCTruthLinkName string Name of the clusterMCTruthLink output collection - not created if empty()
FullRecoRelation bool false true: All reco <-> true relations are given, with weight = 10000*calo weight+track weight (weights in permill). false: Only highest contributor linked,and only to tracks, not clusters if there are any tracks
InvertedNonDestructiveInteractionLogic bool false Work-around Mokka bug in vertex-is-not-endpoint-of-parent flag (logic inverted)
KeepDaughtersPDG IntVec 22 111 310 PDG codes of particles of which the daughters will be kept in the skimmmed MCParticle collection
MCParticleCollection string MCParticle Name of the MCParticle input collection
MCParticlesSkimmedName string Name of the skimmed MCParticle output collection - not created if empty()
MCTruthClusterLinkName string Name of the MCTruthClusterLink output collection
MCTruthRecoLinkName string Name of the MCTruthRecoLink output collection
MCTruthTrackLinkName string Name of the trackMCTruthLink output collection
RecoMCTruthLinkName string RecoMCTruthLink Name of the RecoMCTruthLink output collection - not created if empty()
RecoParticleCollection string PandoraPFOs Name of the ReconstructedParticles input collection
SaveBremsstrahlungPhotons bool false save photons from Brems
SimCaloHitCollections StringVec BeamCalCollection EcalBarrelSiliconCollection EcalBarrelSiliconPreShowerCollection EcalEndcapRingCollection EcalEndcapRingPreShowerCollection EcalEndcapSiliconCollection EcalEndcapSiliconPreShowerCollection HcalBarrelRegCollection HcalEndCapRingsCollection HcalEndCapsCollection LHcalCollection LumiCalCollection MuonBarrelCollection MuonEndCapCollection Names of the SimCaloHits input collections
SimCalorimeterHitRelationNames StringVec RelationCaloHit RelationLcalHit RelationLHcalHit RelationBCalHit RelationMuonHit Name of the lcrelation collections, that link the SimCalorimeterHit to CalorimeterHit
SimTrackerHitCollections StringVec VXDCollection SITCollection FTD_PIXELCollection FTD_STRIPCollection TPCCollection SETCollection Names of the SimTrackerHits input collection
TrackCollection string MarlinTrkTracks Name of the Tracks input collection
TrackMCTruthLinkName string Name of the trackMCTruthLink output collection - not created if empty()
TrackerHitsRelInputCollections StringVec VXDTrackerHitRelations SITSpacePointRelations FTDPixelTrackerHitRelations FTDSpacePointRelations TPCTrackerHitRelations SETSpacePointRelations Name of the lcrelation collections, that link the TrackerHits to their SimTrackerHits.
UseTrackerHitRelations bool true true: use relations for TrackerHits, false : use getRawHits
UsingParticleGun bool false If Using Particle Gun Ignore Gen Stat
daughtersECutMeV float 10 energy cut for daughters that are kept from KeepDaughtersPDG
ReconstructedParticleImpl_CopyProcessor libMarlinReco.so.1.38.0

description not set by author

Parameter Type Default Description
InputCollection string PandoraPFOs Pandora PFOs
OutputCollection string NewPandoraPFOs New Pandora PFOs
RelationCollection string Old2NewPandoraPFOsLink Old to New Pandora PFOs Link
copyCharge bool true Copy charge.
copyClusters bool true Copy all clusters.
copyCovMatrix bool true Copy covariance matrix.
copyEnergy bool true Copy energy.
copyGoodnessOfPID bool true Copy the goodness of the PID.
copyMass bool true Copy mass.
copyMomentum bool true Copy momentum.
copyParticleIDUsed bool true Copy which particle ID is used.
copyParticleIDs bool true Copy all particle ID entries.
copyParticles bool true Copy all particles.
copyReferencePoint bool true Copy reference point.
copyStartVertex bool true Copy start vertex.
copyTracks bool true Copy all tracks.
copyType bool true Copy type.
ReconstructedParticleParticleIDFilterProcessor libMarlinReco.so.1.38.0

ReconstructedParticleParticleIDFilterProcessor: Filters ParticleID objects from ReconstructedParticles

Parameter Type Default Description
FilterPIDAlgos StringVec PID algorithm names to filter
RecoParticleCollection string PandoraPFOs collection to filter
SLDCorrection libMarlinReco.so.1.38.0

SLDCorrection finds semi-leptonic decays within jets and performs a correction to 4-momentum of the jet due to the missing neutrino(s)

Parameter Type Default Description
BSLD4SigmaAlpha float 0.004 Angular uncertainty (radian) due to flight direction reconstruction for semi-leptonic decay of B-Hadron when leptin is in 2nd vertex
BSLD4SigmaAlphaCPVA float 0 Angular uncertainty (radian) due to Charged Particle to Vertex Association (NPVA) for semi-leptonic decay of B-Hadron when leptin is in 2nd vertex
BSLD4SigmaAlphaNPVA float 0 Angular uncertainty (radian) due to Neutral Particle to Vertex Association (NPVA) for semi-leptonic decay of B-Hadron when leptin is in 2nd vertex
BSLD4SigmaECPVA float 0 Energy uncertainty (GeV) due to Charged Particle to Vertex Association (CPVA) for semi-leptonic decay of B-Hadron when leptin is in 2nd vertex
BSLD4SigmaENPVA float 0 Energy uncertainty (GeV) due to Neutral Particle to Vertex Association (NPVA) for semi-leptonic decay of B-Hadron when leptin is in 2nd vertex
BSLD5SigmaAlpha float 0.01 Angular uncertainty (radian) due to flight direction reconstruction for semi-leptonic decay of B-Hadron when leptin is with 3rd vertex
BSLD5SigmaAlphaCPVA float 0 Angular uncertainty (radian) due to Charged Particle to Vertex Association (NPVA) for semi-leptonic decay of B-Hadron when leptin is with 3rd vertex
BSLD5SigmaAlphaNPVA float 0 Angular uncertainty (radian) due to Neutral Particle to Vertex Association (NPVA) for semi-leptonic decay of B-Hadron when leptin is with 3rd vertex
BSLD5SigmaECPVA float 0 Energy uncertainty (GeV) due to Charged Particle to Vertex Association (CPVA) for semi-leptonic decay of B-Hadron when leptin is with 3rd vertex
BSLD5SigmaENPVA float 0 Energy uncertainty (GeV) due to Neutral Particle to Vertex Association (NPVA) for semi-leptonic decay of B-Hadron when leptin is with 3rd vertex
BSLDChargedSLD4InvMassCut float 0 Cut on Invariant mass of visible charged decay products for semi-leptonic decay of B-Hadron when lepton is in secondary vertex
BSLDChargedSLD5InvMassCut float 0 Cut on Invariant mass of visible charged decay products for semi-leptonic decay of B-Hadron when lepton is with third vertex
BSLDNeutralSLD4InvMassCut float 0 Cut on Invariant mass of visible neutral decay products for semi-leptonic decay of B-Hadron when lepton is in secondary vertex
BSLDNeutralSLD5InvMassCut float 0 Cut on Invariant mass of visible neutral decay products for semi-leptonic decay of B-Hadron when lepton is with third vertex
BsldMode int 0 Event selection based on semi-leptonic decays of B-hadrons
BuildUpVertex string BuildUpVertex Name of BuildUp Vertex Collection
CSLDChargedSLD4InvMassCut float 0 Cut on Invariant mass of visible charged decay products for semi-leptonic decay of C-Hadron when lepton is in secondary vertex
CSLDChargedSLD5InvMassCut float 0 Cut on Invariant mass of visible charged decay products for semi-leptonic decay of C-Hadron when lepton is with third vertex
CSLDNeutralSLD4InvMassCut float 0 Cut on Invariant mass of visible neutral decay products for semi-leptonic decay of C-Hadron when lepton is in secondary vertex
CSLDNeutralSLD5InvMassCut float 0 Cut on Invariant mass of visible neutral decay products for semi-leptonic decay of C-Hadron when lepton is with third vertex
ClusterMCTruthLinkCollection string ClusterMCTruthLink Name of input m_ClusterMCTruthLink Collection
CsldMode int 0 Event selection based on semi-leptonic decays of C-hadrons
JetCollection string Durham_nJets Name of input jet collection
JetSLDLinkName string JetSLDLinkName Name of the JetSemiLeptonicDecayLinkName output collection
MCParticleCollection string MCParticle Name of the MCParticle collection
MCTruthClusterLinkCollection string MCTruthClusterLink Name of input MCTruthClusterLink Collection
MCTruthRecoLinkCollection string MCTruthRecoLinkCollection Name of input MCTruthRecoLink Collection
NuSLDLinkName string NuSLDLinkName Name of the SemiLeptonicDecayNeutrinoLinkName output collection
PfoCollection string PandoraPFOs Name of input pfo collection
PrimaryVertex string PrimaryVertex Name of Primary Vertex Collection
RecoMCTruthLinkCollection string RecoMCTruthLinkCollection Name of input RecoMCTruthLink Collection
ReconstructedNeutrino string ReconstructedNeutrino Name of Reconstructed Neutrino Collection
RootFile string Output.root Name of the output root file
SLDJetLinkName string SLDJetLinkName Name of the SemiLeptonicDecayJetLinkName output collection
SLDNuLinkName string SLDNuLinkName Name of the NeutrinoSemiLeptonicDecayLinkName output collection
SemiLeptonicDecayVertex string SemiLeptonicDecayVertex Name of Semi-Leptonic Decay Vertices Collection
SemiLeptonicDecayVertexRP string SemiLeptonicDecayVertexRP Name of Semi-Leptonic Decay Vertices Reconstructed Particle Collection
TsldMode int 0 Event selection based on semi-leptonic decays of tau-leptons
chargedCosAcceptanceAngleSLD4 float 0 Acceptance angle for charged PFOs to be assigned to the semi-leptonic decay when lepton is in secondary vertex
chargedCosAcceptanceAngleSLD5 float 0 Acceptance angle for charged PFOs to be assigned to the semi-leptonic decay when lepton is with third vertex
cheatCharged4momentum bool true Cheat FourMomentum of charged visibles in semi-leptonic decays
cheatFlightDirection bool true Cheat Flight direction of mother hadron
cheatLepton4momentum bool true Cheat FourMomentum of lepton in semi-leptonic decays
cheatNeutral4momentum bool true Cheat FourMomentum of neutral visibles in semi-leptonic decays
cheatPVAcharged bool true Cheat Particle ID for Charged Decay Products
cheatPVAneutral bool true Cheat Particle ID for Neutral Decay Products
cheatSLDLeptons bool true Cheat semi-leptonic decays lepton from MCTruth
cheatSolutionSign bool false Cheat the signe of solution for the neutrino correction
displayEvent bool true Display recoLepton, downstraem vertex and RP and reconstructed secondary vertex in Event Display
fillRootTree bool true Fill root tree to check processor performance
includeBSLD bool true do correction for semi-leptonic decays of B-Hadrons
includeCSLD bool true do correction for semi-leptonic decays of C-Hadrons
includeTSLD bool true do correction for semi-leptonic decays of Tau-Leptons
mcNurecoNuLinkName string mcNurecoNuLinkName Name of the trueNeutrino-reconstructedNeutrino output Link collection
nIterFlightDirCorrection int 1 Number of iterations for correcting flight direction of CHARGED parent hadron
neutralCosAcceptanceAngle float 0 Acceptance angle for neutral PFOs to be assigned to the semi-leptonic decay
recoNumcNuLinkName string recoNumcNuLinkName Name of the trueNeutrino-reconstructedNeutrino output Link collection
sigmaAlphaNu float 0.1 Angular uncertainty (radian) for reconstructed neutrino direction
sigmaENu float 4 Energy uncertainty (GeV) for reconstructed neutrino
sldMode int 0 Event selection based on semi-leptonic decays of All hadrons and tau-leptons
traceEvent bool false trace events with large discrepancy
vertexingScenario int 1 Scenario for finding flight direction of mother hadron: 1 = default , 2 = assign jet axis , 3 = assign flight direction of leading particle in the jet
SelectReconstructedParticle libMarlinReco.so.1.38.0

SelectReconstructedParticle: Selects particles from all reconstructed particles to be used for the thrust finder

Parameter Type Default Description
MinimumMomentum float 0 Minimum momentum a particle has to have to be used for the thrust calculation
inputCollectionName string ReconstructedParticle Collection of reconstructed particles to chose from
outputCollectionName string SelectedReconstructedParticle Collection of selected reconstructed particles
SiTracker_dEdxProcessor libMarlinReco.so.1.38.0

SiTracker_dEdxProcessor calculates dE/dx for planar silicon trackers

Parameter Type Default Description
CheatSensorThicknesses bool false Shall we use the sensitive thicknesses from parameters?
SensorThicknessCheatValues FloatVec -1 -1 -1 -1 -1 -1 Sensor thicknesses to use instead of automatic values from DD4hep (if CheatSensorThicknesses==true).
TrackCollectionName string SiTracks Name of the input Track collection
TrkHitCollections StringVec ITrackerHits ITrackerEndcapHits OTrackerHits OTrackerEndcapHits VXDTrackerHits VXDEndcapTrackerHits Tracker hit collections that will be analysed
dEdxEstimator string median Type of estimator for dEdx.
SimDigital libMarlinReco.so.1.38.0

This processor creates SDHCAL digitized CalorimeterHits from SDHCAL SimCalorimeterHits

Parameter Type Default Description
AngleCorrectionPower float 0.4 Parameter for angle correction
CellIDEncodingStringType string LCGEO The type of the encoding, LCGEO or PROTO
ChargeSplitterOption string Erf Define the charge splitter method. Possible option : Erf , Exact
ChargeSplitterd float 1 d parameter for exact splitter
EffMapConstantValue float 0.97 Value of the constant term for efficiency correction if EffMapOption==Uniform
EffMapFile string Efficiency map file
EffMapOption string Uniform Step efficiency correction method : should be Uniform
GasGapWidth float 1.2 Width of the RPC gas gap
HCALCellSize float 0 Cell size (mm) of HCAL, if it is equal or less than zero then the value is taken from dd4hep
HCALThreshold FloatVec 0.1 Threshold for HCAL Hits in pC
KeepAtLeastOneStep bool true if true, ensure that each hit will keep at least one step for digitisation independatly of filtering conditions (StepCellCenterMaxDistanceLayerDirection)
LinkSteps bool false Parameter for angle correction
PolyaAverageCharge float 1.6 Parameter for the Polya distribution used to simulate the induced charge distribution : mean of the distribution
PolyaMapFile string Polya map file
PolyaOption string Uniform Uniform polya or different polya per Asic
PolyaRandomSeed int 1 The seed of the polya function
PolyaWidthParameter float 16.3 Parameter for the Polya distribution used to simulate the induced charge distribution : related to the distribution width
RPC_PadSeparation float 0 distance in mm between two RPC pads : used if ChargeSplitterOption==Function or Erf
SpreaderMapFile string Charge spreader map file
StepCellCenterMaxDistanceLayerDirection float 0.0005 Maximum distance (mm) between the Geant4 step position and the cell center, in the RPC width direction, to keep a step for digitization
StepLengthCut double -1 Step length cut
StepsMinDistanceRPCplaneDirection float 0.5 Minimum distance (mm) between 2 Geant4 steps, in the RPC plane, to keep the 2 steps
TimeCut double 1.79769e+308 Time cut
doThresholds bool true Replace analog hit energy by value given in CalibrHCAL according to thresholds given in HCALThreshold
erfWeigth FloatVec 1 Weigth for the different Erf functions
erfWidth FloatVec 2 Width values for the different Erf functions
functionRange float 30 maximal distance (in mm) at which a step can induce charge using the 2D function defined with functionFormula or when using ChargeSplitterOption==Erf
inputHitCollections StringVec HcalBarrelCollection HcalEndCapRingsCollection HcalEndCapsCollection Sim Calorimeter Hit Collections
outputHitCollections StringVec HCALBarrelDigi HCALEndcapDigi HCALOtherDigi output hit collection names
outputRelationCollections StringVec output hit relation Collection Names
SimDigitalLinkToParticles libMarlinReco.so.1.38.0

This processor links calorimeter hits to MC particles

Parameter Type Default Description
inputHitCollections StringVec Sim Calorimeter Hit Collections
inputRelationCollections StringVec Collections of generic objects containing additional step informations
outputRelationCollections StringVec output hit relation Collection Names
SimDigitalToEnergy libMarlinReco.so.1.38.0

This processor transforms the threshold value of digitized SDHCAL CalorimeterHits into energy

Parameter Type Default Description
CellIDLayerString string K-1 name of the part of the cellID that holds the layer
EnergyCalibration FloatVec 0.4 Threshold to Energy correspondace
calibration_factorsMipGev FloatVec Calibration coefficients (MIP->shower GeV) of layers groups
calibration_layergroups IntVec grouping of calo layers
inputHitCollections StringVec input hit collection names
inputRelationCollections StringVec input relation collection names (digi<->sim), one per inputHitCollection
outputHitCollections StringVec output hit collection names
outputRelationCollections StringVec output hit collection names
SimpleCaloDigi libMarlinReco.so.1.38.0

Performs simple digitization of sim calo hits...

Parameter Type Default Description
CalibrECAL FloatVec 31.3 83 Calibration coefficients for ECAL
CalibrHCAL FloatVec 27.3 Calibration coefficients for HCAL
ECALCollections StringVec ecal02_EcalBarrel ecal02_EcalEndcap ECAL Collection Names
ECALLayers IntVec 30 100 Index of ECal Layers
ECALOutputCollection string ECAL ECAL Collection of real Hits
ECALThreshold float 0.0001 Threshold for ECAL Hits in GeV
HCALCollections StringVec hcalFeScintillator_HcalBarrelEnd hcalFeScintillator_HcalBarrelReg hcalFeScintillator_HcalEndCaps HCAL Collection Names
HCALLayers IntVec 100 Index of HCal Layers
HCALOutputCollection string HCAL HCAL Collection of real Hits
HCALThreshold float 0.0004 Threshold for HCAL Hits in GeV
IfDigitalEcal int 0 Digital Ecal
IfDigitalHcal int 0 Digital Hcal
RelationOutputCollection string RelationCaloHit CaloHit Relation Collection
SimpleFCalDigi libMarlinReco.so.1.38.0

Performs simple digitization of SimCalorimeter hits in forward calorimeters ...

Parameter Type Default Description
CalibrFCAL float 31 Calibration coefficients for FCAL
CaloID string fcal ID of calorimeter: lcal, fcal, bcal
CaloLayout string endcap subdetector layout: barrel, endcap, plug, ring
CaloType string had type of calorimeter: em, had, muon
CellIDLayerString string K-1 name of the part of the cellID that holds the layer
FCALCollections StringVec LcalCollection Fcal Collection Names
FCALOutputCollection string FCAL Fcal Collection of real Hits
FcalThreshold float 0 Threshold for Fcal Hits in GeV
FixLCalHits bool false Fix the hit positions in LCal using the cellID (for DBD simulated samples)
RelationOutputCollection string RelationFcalHit CaloHit Relation Collection
SimpleMuonDigi libMarlinReco.so.1.38.0

Performs simple digitization of sim muon hits...

Parameter Type Default Description
CalibrMUON float 120000 Calibration coefficients for MUON
CellIDLayerString string K-1 name of the part of the cellID that holds the layer
KeepBarrelLayersVec IntVec Vector of Barrel layers to be kept. Layers start at 1!
KeepEndcapLayersVec IntVec Vector of Endcap layers to be kept. Layers start at 1!
MUONCollections StringVec yoke03_MuonBarrel yoke03_MuonEndCap yoke03_MuonPlug Muon Collection Names
MUONOutputCollection string MUON Muon Collection of real Hits
MaxHitEnergyMUON float 2 maximum hit energy for a MUON hit
MuonThreshold float 0.025 Threshold for Muon Hits in GeV
RelationOutputCollection string RelationMuonHit CaloHit Relation Collection
Sphere libMarlinReco.so.1.38.0

Sphere calculates eigenvalues of sphericity tensor

Parameter Type Default Description
CollectionName string RecontructedParticle Name of the ReconstructedParticle collection
eigenvalues_parameter_name string sphericity_tensor_eigenvalues name of parameter to store the results
r_value float 2 exponent in sphericity tensor use 2.0 for classical 1.0 for C,D
TJjetsPFOAnalysisProcessor libMarlinReco.so.1.38.0

TJjetsPFOAnalysisProcessor: Basically a copy-pasted version of the PFOAnalysis processor working on individual TrueJet jets

Parameter Type Default Description
FinalColourNeutralLink string FinalColourNeutralLink Name of the FinalColourNeutralLink output collection
FinalColourNeutrals string FinalColourNeutrals Name of the FinalColourNeutralCollection output collection
FinalElementonLink string FinalElementonLink Name of the FinalElementonLink output collection
InitialColourNeutralLink string InitialColourNeutralLink Name of the InitialColourNeutralLink output collection
InitialColourNeutrals string InitialColourNeutrals Name of the InitialColourNeutralCollection output collection
InitialElementonLink string InitialElementonLink Name of the InitialElementonLink output collection
InputAllPFOsCollection string PandoraPFOs Name of the PFOs collection
LookForQuarksWithMotherZ int 0 Flag to look for quarks with mother Z
MCParticleCollection string MCParticle Name of the MC particle collection
MCPfoSelectionLowEnergyNPCutOff float 1 MC pfo selection neutron and proton low energy cut-off
MCPfoSelectionMomentum float 0.01 MC pfo selection momentum
MCPfoSelectionRadius float 500 MC pfo selection radius
RecoMCTruthLink string RecoMCTruthLink Name of the RecoMCTruthLink input collection
RootFile string PFOAnalysis.root Name of the output root file
TrueJetMCParticleLink string TrueJetMCParticleLink Name of the TrueJetMCParticleLink output collection
TrueJetPFOLink string TrueJetPFOLink Name of the TrueJetPFOLink output collection
TrueJets string TrueJets Name of the TrueJetCollection output collection
TOFEstimators libMarlinReco.so.1.38.0

TOFEstimators processor computes time-of-flight of the chosen ReconstructedParticle to the specified end point (SET hit or Ecal surface). To be used for a further particle ID

Parameter Type Default Description
ExtrapolateToEcal bool true If true, track is extrapolated to the Ecal surface for track length calculation, time of flight estimated using Ecal hits. If false, track length calculated to the last tracker hit. Time of flight estimated using SET hit if exists.
MaxEcalLayer int 10 Time of flight is calculated using Ecal hits only up to MaxLayer
ReconstructedParticleCollection string PandoraPFOs Name of the ReconstructedParticle collection
TimeResolution double 0 Time resolution of individual SET strips or Ecal hits in ps
TofMethod string closest name of the algorithm which estimates time of flight to the Ecal surface based on Ecal hits time information. Available options are: closest, frankAvg, frankFit. In case of _extrapolateToEcal==false is ignored
TPCDigiProcessor libMarlinReco.so.1.38.0

Produces TPC TrackerHit collection from SimTrackerHit collection, smeared in RPhi and Z. A search is made for adjacent hits on a pad row, if they are closer in z and r-phi than the steering parameters _doubleHitResRPhi (default value 2.0 mm) and _doubleHitResZ (default value 5.0 mm) they are considered to overlap. Clusters of hits smaller than _maxMerge (default value 3) are merged into a single tracker hit, with the position given as the average poision of the hits in phi and in z. Clusters which have _maxMerge hits or more are determined to be identifiable as multiple hits, and are not added to the tracker hit collection. This of course means that good hits caught up in a cluster of background hits will be lossed.

Parameter Type Default Description
DiffusionCoeffRPhi float 0.025 R-Phi Diffusion Coefficent in TPC
DiffusionCoeffZ float 0.08 Z Diffusion Coefficent in TPC
DontEncodeSide bool true Do not encode the side in the cellID of the TrackerHit
DoubleHitResolutionRPhi float 2 Defines the minimum distance for two seperable hits in RPhi
DoubleHitResolutionZ float 5 Defines the minimum distance for two seperable hits in Z
HitSortingBinningRPhi float 2 Defines spatial slice in RP
HitSortingBinningZ float 5 Defines spatial slice in Z
MaxClusterSizeForMerge int 3 Defines the maximum number of adjacent hits which can be merged
N_eff int 22 Number of Effective electrons per pad in TPC
PointResolutionPadPhi float 0.9 Pad Phi Resolution constant in TPC
PointResolutionRPhi float 0.05 R-Phi Resolution constant in TPC
PointResolutionZ float 0.4 TPC Z Resolution Coefficent independent of diffusion
RejectCellID0 int 1 whether or not to use hits without proper cell ID (pad row)
SimTrkHitRelCollection string TPCTrackerHitRelations Name of TrackerHit SimTrackHit relation collection
TPCLowPtCollectionName string TPCLowPtCollection Name of the LowPt SimTrackerHit collection Produced by Mokka TPC Driver TPC0X
TPCPadRowHitCollectionName string TPCCollection Name of the default pad-row based SimTrackerHit collection
TPCSpacePointCollectionName string TPCSpacePointCollection Name of the additional space point collection which provides additional guide hits between pad row centers.
TPCTrackerHitsCol string TPCTrackerHits Name of the Output TrackerHit collection
UseRawHitsToStoreSimhitPointer bool false Store the pointer to the SimTrackerHits in RawHits (deprecated)
TaJetClustering libMarlinReco.so.1.38.0

Tau Jet Finding

Parameter Type Default Description
AcceptFlexibleLowEnergyTrack int 1 Low energy tracks can be accepted as either charged and neutral if true
ConeMaxCosAngle double 1 Maximum cosine angle for cone
ConeMaxEnergyFrac double 0.1 Energy fraction of cone compared to central
ConeMinCosAngle double 0.9 Minimum cosine angle for cone
MaximumNeutralEnergyIn3Prong double 1 Reject 3-prong taus if including neutral energy more than this number in GeV
MinimumJetEnergy double 3 Minimum jet energy to be accepted as taus
MinimumTrackEnergy double 2 Minimum track energy to be accepted as taus
MinimumTrackEnergyAssoc double 2 Minimum track energy to be counted
NoSelection int 0 Neither primary nor cone cut at all if true. Only clustering.
OutputTauCollection string TaJets Tau output collection
PFOCollection string PandoraPFOs PandoraPFA PFO collection
RemainPFOCollection string RemainPFOs Remained PFO collection
TauCosAngle double 0.98 Allowed cosine angle to be clustered
TauMass double 2 Tau mass for tau clustering [GeV]
TauFinder libMarlinReco.so.1.38.0

TauFinder writes tau candidates as ReconstructedParticles into collection. It runs on a collection of ReconstructedParticels, if you want to run on MCParticles you have to convert them before hand (use e.g. PrepareRECParticles processor)

Parameter Type Default Description
FileName_Signal string Signal.root Name of the Signal output file
PFOCollection string PandoraPFANewPFOs Collection of PFOs
TauRecCollection string TauRec_PFO Collection of Tau Candidates
TauRecLinkCollectionName string TauRecLink_PFO Name of the Tau link to ReconstructedParticle collection
TauRecRestCollection string TauRecRest_PFO Collection of Particles in Rest Group not in Tau Candidates
cosT_cut float 0.99 Cut on cosT to suppress background
invariant_mass float 2 Upper limit on invariant mass of tau candidate
isolationConeAngle float 0.02 Outer isolation cone around search cone of tau jet in rad (relativ to cone angle)
isolationEnergy float 5 Energy allowed within isolation cone region
pt_cut float 0.2 Cut on pt to suppress background
ptseed float 5 Minimum tranverse momentum of tau seed
searchConeAngle float 0.05 Opening angle of the search cone for tau jet in rad
ThrustReconstruction libMarlinReco.so.1.38.0

Calculates thrust axis and thrust value of event using different algorithms

Parameter Type Default Description
inputCollectionName string SelectedReconstructedParticle Name of collection of reconstructed particles used for thrust reconstruction
typeOfThrustFinder int 2 Type of thrust reconstruction algorithm to be used: # 1 : Tasso algorithm # 2 : JetSet algorithm
TrackLengthProcessor libMarlinReco.so.1.38.0

TrackLengthProcessor computes track length and harmonic mean of the momentum square up to the last tracker hit and Ecal surface. It should give a relatively good approximation of the track length of any particle reaching the Ecal to use in the time-of-flight particle identification

Parameter Type Default Description
ReconstructedParticleCollection string PandoraPFOs Name of the ReconstructedParticle collection
TrackToRecoParticleConverter libMarlinReco.so.1.38.0

Processor to convert track collection into ReconstructedParticle collection

Parameter Type Default Description
InputTrackCollection string InputTracks Input track collection to convert
OutputPFOCollection string ConvertedTrackAsPFO Ouptut collection
TrackZVertexGrouping libMarlinReco.so.1.38.0

TrackZVertexGrouping: group tracks based on their Z0 significance

Parameter Type Default Description
TrackCollection string MarlinTrkTracks Name of the Track input collection
TrackGroupPFOs string TrackGroupPFOs Name of the ReconstructedParticle output collection
TrackGroupVertices string TrackGroupVertices Name of the Vertex output collection
Z0SignificanceCut float 1.7 Cut for merging track groups in Z0 significance
TrueJet libMarlinReco.so.1.38.0

TrueJet does whatever it does ...

Parameter Type Default Description
FinalColourNeutralLink string FinalColourNeutralLink Name of the FinalColourNeutralLink output collection
FinalColourNeutrals string FinalColourNeutrals Name of the FinalColourNeutralCollection output collection
FinalElementonLink string FinalElementonLink Name of the FinalElementonLink output collection
InitialColourNeutralLink string InitialColourNeutralLink Name of the InitialColourNeutralLink output collection
InitialColourNeutrals string InitialColourNeutrals Name of the InitialColourNeutralCollection output collection
InitialElementonLink string InitialElementonLink Name of the InitialElementonLink output collection
MCParticleCollection string MCParticlesSkimmed Name of the MCParticle collection
RecoMCTruthLink string RecoMCTruthLink Name of the RecoMCTruthLink input collection
RecoParticleCollection string PandoraPFOs Name of the ReconstructedParticles input collection
TrueJetMCParticleLink string TrueJetMCParticleLink Name of the TrueJetMCParticleLink output collection
TrueJetPFOLink string TrueJetPFOLink Name of the TrueJetPFOLink output collection
TrueJets string TrueJets Name of the TrueJetCollection output collection
Whizard1 bool false true: Input has MCParticles in Whizard1 convention
TruthVertexFinder libMarlinReco.so.1.38.0

TruthVertexFinder extructs a secondary vertex from generator collection.

Parameter Type Default Description
CollectionName string MCParticleSkimmed Name of the MCParticle collection
DecayChainPDGs IntVec PDGs of desired decays
OutputBStarName string BStar Name of the Vertex collection
OutputCollectionName string MCVertex Name of the Vertex collection
OutputProngsName string EGProngs Name of the Prongs collection
QuarkCollectionName string MCbquarks Name of the b-quark collection
ROOTFileName string GenVertexTest.root ROOT File Name
RelCollectionName string RecoMCTruthLink Name of the Jet relation collection
a float 0.005 a parameter of accuracy in mm
b float 0.01 b parameter of accuracy in mm
initialQuarkPDG int 5 PDG of initial particle
tagPDG int 6 PDG of desired particle
writeBonly int 1 b parameter
writeROOT int 0 write ROOT file?
V0Finder libMarlinReco.so.1.38.0

V0 Finder Processor

Parameter Type Default Description
CutOnRadius float 5 Cuts on V0 radius
CutOnTrkDistance float 1.5 Cut on two track distance
MassRangeGamma float 0.01 Maximal deviation in mass for photon candidate
MassRangeK0S float 0.01 Maximal deviation in mass for K0S candidate
MassRangeL0 float 0.008 Maximal deviation in mass for Lamda0 candidate
MinimumTrackHitRatio float 0.7 Minimum ratio of inner track hit radius to reconstructed vertex radius
RecoParticleCollection string V0RecoParticles Name of output collection of reconstructed particles
RxyCutGamma float 10 Minimum radius in xy plane for photon candidate
RxyCutK0S float 30 Minimum radius in xy plane for K0S candidate
RxyCutLambda float 50 Minimum radius in xy plane for Lambda0 candidate
TrackCollection string LDCTracks Name of input collection of reconstructed particles
VertexCollection string V0Vertices Name of output collection of neutral vertices
VTXBgClusters libMarlinReco.so.1.38.0

VTXBgClusters should create VTX TrackerHits from SimTrackerHits

Parameter Type Default Description
Debug int 0 Debugging option
Modif int 0 sensor modification option
MomentumCutForDRays float 10 Momentum Cut For D Rays (MeV)
RemoveDrays int 0 Remove D-rays ?
VTXCollectionName string VXDCollection Name of the VTX SimTrackerHit collection
VTXDigiProcessor libMarlinReco.so.1.38.0

VTXDigiProcessor should create VTX TrackerHits from SimTrackerHits

Parameter Type Default Description
ActiveSETLayers IntVec 1 only SET hits from active layers are digitized (mimic stereo layers)
Debug int 0 Debugging option
HitEfficiencyPerLayer_VTX FloatVec 1 1 1 1 1 1 hit efficiencies per VXD layer (default: 1.0)
MomentumCutForDRays float 10 Momentum Cut For D Rays (MeV)
PointResolutionRPhi_SET float 0.01 R-Phi Resolution in SET
PointResolutionRPhi_SIT float 0.01 R-Phi Resolution in SIT
PointResolutionRPhi_VTX float 0.004 R-Phi Resolution in VTX
PointResolutionZ_SET float 0.01 Z Resolution in SET
PointResolutionZ_SIT float 0.01 Z Resolution in SIT
PointResolutionZ_VTX float 0.004 Z Resolution in VTX
RemoveDrays int 0 Remove D-rays ?
SETCollectionName string SETCollection Name of the SET SimTrackerHit collection
SETHitCollection string SETTrackerHits Name of the set TrackerHit output collection
SITCollectionName string SITCollection Name of the SIT SimTrackerHit collection
SITHitCollection string SITTrackerHits Name of the sit TrackerHit output collection
SmearAlongLadders int 1 Points smeared along the ladders
VTXCollectionName string VXDCollection Name of the VTX SimTrackerHit collection
VTXHitCollection string VTXTrackerHits Name of the vxd TrackerHit output collection
VTXDigitizer libMarlinReco.so.1.38.0

VTXDigitizer should create VTX TrackerHits from SimTrackerHits

Parameter Type Default Description
BackgroundHitsPerLayer FloatVec 34400 23900 9600 5500 3100 Background Hits per Layer
CollectionName string VXDCollection Name of the SimTrackerHit collection
CutOnDeltaRays double 0.03 Cut on delta-ray energy (MeV)
Debug int 0 Debug option
Diffusion double 0.002 Diffusion coefficient (in mm) for layer thickness
ElectronicEffects int 1 Apply Electronic Effects
ElectronicNoise double 100 electronic noise in electrons
ElectronsPerKeV double 270.3 Electrons per keV
EnergyLoss double 280 Energy Loss keV/mm
GenerateBackground int 0 Generate Background
OutputCollectionName string VTXTrackerHits Name of the output TrackerHit collection
PixelSizeX double 0.025 Pixel Size X
PixelSizeY double 0.025 Pixel Size Y
PoissonSmearing int 1 Apply Poisson smearing of electrons collected on pixels
RelationColName string VTXRelation Name of the output VTX trackerhit relation collection
RemoveDRayPixels int 1 Remove D-Ray Pixels
SegmentLength double 0.005 Segment Length
StoreFiredPixels int 0 Store fired pixels
TanLorentz double 0.8 Tangent of Lorentz Angle
Threshold double 200 Cell Threshold in electrons
UseMCPMomentum int 1 Use Particle Momentum
WidthOfCluster double 3 Width of cluster
VTXNoiseClusters libMarlinReco.so.1.38.0

VTXNoiseClusters adds SimTrackerHits with salt'n pepper noise clusters

Parameter Type Default Description
HitDensityPerLayer_VTX FloatVec 0 0 0 0 0 0 hit densities (hits/cm^2) per VXD layer
RandomSeed int 42 random seed - default 42
RootHistograms StringVec sap2VXD05_1.root hst1 hst2 hst3 hst4 hst5 hst6 root file name and histogram names (one per layer)
VTXCollectionName string VXDCollection Name of the VTX SimTrackerHit collection
VTXNoiseHits libMarlinReco.so.1.38.0

VTXNoiseHits should create VTX TrackerHits from SimTrackerHits

Parameter Type Default Description
HitDensityPerLayer_VTX FloatVec 0 0 0 0 0 hit densities (hits/cm^2) per VXD layer
PointResolutionRPhi_VTX float 0.0027 R-Phi Resolution in VTX
PointResolutionZ_VTX float 0.0027 Z Resolution in VTX
VTXCollectionName string VTXTrackerHits Name of the VTX TrackerHit collection
WWCategorisationProcessor libMarlinReco.so.1.38.0

Categorisation of all WW decay channels

Parameter Type Default Description
ConfusionMatrixFileName string WWCategorisationConfusionMatrix.png Name of the png file in which the confusion matrix is stored; if left empty no file is created; default: WWCategorisationConfusionMatrix.png
IsolatedElectrons string IsolatedElectrons Name of the ReconstructedParticle collection
IsolatedMuons string IsolatedMuons Name of the ReconstructedParticle collection
IsolatedPhotons string IsolatedPhotons Name of the ReconstructedParticle collection
IsolatedTaus string IsolatedTaus Name of the ReconstructedParticle collection
MCElCat_CosThCut float 0.994 Cut using cos(theta) value of MC electrons, above which sl-electron events are categorised as 'invisible' (true_cat 1 instead of 2); default: 0.994 (detector acceptance).
MCParticles string MCParticlesSkimmed Name of the MCParticle collection
PFOsminusphoton string PFOsminusphoton Name of the ReconstructedParticle collection
TTreeFileName string WWCategorisationTTreeFile.root Name of the root file in which the TTree with the 4 event observables is stored; if left empty no root file is created; default: WWCategorisationTTreeFile.root
ZFinder libMarlinReco.so.1.38.0

description not set by author

Parameter Type Default Description
AddPhotons int 1 Include photons with reconstructed Z
CanUseClusterEnergyForElectrons int 1 Allow possibilit of cluster not track used for electrons
CosTrackGammaCut float 0.999 Minimum cosine of track-photon angle
ElectronEcalEnergyCut float 10 Cut on electron ECAL energy
ElectronEoverPCutHigh float 1.3 Cut on Electron E/p cut
ElectronEoverPCutLow float 0.5 Cut on Electron E/p cut
ElectronHcalEnergyCut float 10 Cut on Electron HCAL energy
FermionMomentumCut float 10 Momentum Cut for fermion from Z decay
InputParticleCollectionName string PandoraPFOs Input Particle Collection Name
MaxDeltaMz float 50 Maximum difference between candidate and Z mass
MuonEcalEnergyCut float 2.5 Cut on muon ECAL energy
MuonHcalEnergyCut float 10 Cut on Muon HCAL energy
MuonHcalEnergyCut1 float 5 Cut on Muon HCAL energy (alt)
OutputParticleCollectionName string eeX Output Particle Collection Name
Printing int 1 Print certain messages
ZDecay string ee Z decay mode
anaPix libMarlinReco.so.1.38.0

anaPix icteats TTree from FPCCDPixelHits

Parameter Type Default Description
Each_FPCCD_pixelSize(mm) FloatVec 0.005 0.005 0.005 0.005 0.005 0.005 Each ladder's Pixel size of FPCCD (unit:mm) (default:0.005)
FPCCD_PixelSize float 0.005 Pixel size of FPCCD (unit:mm) (default: 0.005)
OutputROOTfileName string ./pixel.root Name of output ROOT file
VTXPixelHitCollection string VTXPixelHits Name of the VTX PixelHit collection
hybridRecoProcessor libMarlinReco.so.1.38.0

hybridRecoProcessor does whatever it does ...

Parameter Type Default Description
ECALcollections_cells StringVec ECALSiBarrel Name of the ECAL cell collections
ECALcollections_longStrips StringVec ECALScLongitudinalBarrel Name of the ECAL longitudinal strip collections
ECALcollections_tranStrips StringVec ECALScTransverseBarrel Name of the ECAL transverse strip collections
saveCheckRootHistograms bool false save root file with debugging histograms?
saveIntersectionCollection bool false save collection with strip interactions?
virtualCellsDefault int 1 number of virtual cells per strip (used if info not found in gear file)
photonCorrectionProcessor libMarlinReco.so.1.38.0

photonCorrectionProcessor applies an energy correction to photon-like PFOs

Parameter Type Default Description
energyCor_Linearise FloatVec 0.987 0.01426 parameters to linearise overall energy response
energyCorr_barrelPhi FloatVec 0.412249 0.0142289 -0.0933687 0.01345 0.0408156 paramters to correct energy response vs. phi in barrel
energyCorr_costh FloatVec -0.09 0 0.235 0.007256 -0.0369648 0 0.588 0.0121604 -0.0422968 0.774 0.009 1.002 paramters to correct energy response vs. cos(theta)
energyCorr_endcap FloatVec -0.025 855 23 -0.07 1489 18 paramters to correct energy response vs. endcap cracks
inputCollection string PandoraPFOs name of input PFO collection
modifyPFOdirection bool true apply the corrected direction to the PFOs
modifyPFOenergies bool true apply the corrected energies to the PFOs
nominalEnergy float 200 nominal photon energy (for validation plots)
phiCorr_barrel FloatVec 2.36517e-05 0.00013209 -3.86883 -0.167809 2.28614e-05 6.03495e-05 0.419 0.00728 0.025 0 2.86667e-05 2.49371e-05 -7.71684e-06 -1.48118e-05 -5.63786e-06 -9.38376e-06 -4.96296e-06 2.91262e-06 paramters to correct phi bias in barrel
thetaCorr_barrel FloatVec -0.000166568 -7.119e-05 0.000223618 -3.95915e-05 paramters to correct theta bias in barrel
thetaCorr_endcap FloatVec 0.000129478 -3.73863e-05 -0.000847783 0.000153646 0.000806605 -0.000132608 paramters to correct theta bias in endcap
validationPlots bool false produce validation plots
MarlinTrkProcessors 19 processors
CalcTrackerHitResiduals libMarlinTrkProcessors.so.2.12.8

Creates Track Collection from MC Truth. Can handle composite spacepoints as long as they consist of two TrackerHits

Parameter Type Default Description
TrackerHitsInputCollections StringVec VXDTrackerHits SITTrackerHits FTDPixelTrackerHits FTDSpacePointRelations TPCTrackerHits SETTrackerHits Name of the tracker hit input collections
TrackerHitsRelInputCollections StringVec VXDTrackerHitRelations SITTrackerHitRelations FTDPixelTrackerHitRelations FTDSpacePointRelations TPCTrackerHitRelations SETTrackerHitRelations Name of the lcrelation collections, that link the TrackerHits to their SimTrackerHits. Have to be in same order as TrackerHitsInputCollections!!!
ClonesAndSplitTracksFinder libMarlinTrkProcessors.so.2.12.8

ClonesAndSplitTracksFinder takes the track collection, checks for doubles and merges them in an output track collection

Parameter Type Default Description
EnergyLossOn bool true Use Energy Loss in Fit
InputTrackCollectionName string SiTracks Name of the input track collection
MultipleScatteringOn bool true Use MultipleScattering in Fit
OutputTrackCollectionName string SiTracksMerged Name of the output track collection
SmoothOn bool false Smooth All Measurement Sites in Fit
extrapolateForward bool true if true extrapolation in the forward direction (in-out), otherwise backward (out-in)
maxSignificancePhi double 3 maximum significance separation in phi
maxSignificancePt double 2 maximum significance separation in pt
maxSignificanceTheta double 3 maximum significance separation in tanLambda
mergeSplitTracks bool false if true, the merging of split tracks is performed
minTrackPt double 1 minimum track pt for merging (in GeV/c)
DDCellsAutomatonMV libMarlinTrkProcessors.so.2.12.8

description not set by author

Parameter Type Default Description
BestSubsetFinder string SubsetHopfieldNN The method used to find the best non overlapping subset of tracks. Available are: SubsetHopfieldNN, SubsetSimple and None
CATrackCollection string CATracks Name of the Cellular Automaton Tracking output collection
Chi2ProbCut double 0.005 Tracks with a chi2 probability below this will get sorted out
Crit2_DeltaPhi_MV_max FloatVec The maximum of Crit2_DeltaPhi_MV
Crit2_DeltaPhi_MV_min FloatVec The minimum of Crit2_DeltaPhi_MV
Crit2_DeltaPhi_max FloatVec The maximum of Crit2_DeltaPhi
Crit2_DeltaPhi_min FloatVec The minimum of Crit2_DeltaPhi
Crit2_DeltaRho_max FloatVec The maximum of Crit2_DeltaRho
Crit2_DeltaRho_min FloatVec The minimum of Crit2_DeltaRho
Crit2_DeltaTheta_MV_max FloatVec The maximum of Crit2_DeltaTheta_MV
Crit2_DeltaTheta_MV_min FloatVec The minimum of Crit2_DeltaTheta_MV
Crit2_Distance_MV_max FloatVec The maximum of Crit2_Distance_MV
Crit2_Distance_MV_min FloatVec The minimum of Crit2_Distance_MV
Crit2_HelixWithIP_max FloatVec The maximum of Crit2_HelixWithIP
Crit2_HelixWithIP_min FloatVec The minimum of Crit2_HelixWithIP
Crit2_RZRatio_max FloatVec The maximum of Crit2_RZRatio
Crit2_RZRatio_min FloatVec The minimum of Crit2_RZRatio
Crit2_StraightTrackRatio_max FloatVec The maximum of Crit2_StraightTrackRatio
Crit2_StraightTrackRatio_min FloatVec The minimum of Crit2_StraightTrackRatio
Crit3_2DAngleTimesR_max FloatVec The maximum of Crit3_2DAngleTimesR
Crit3_2DAngleTimesR_min FloatVec The minimum of Crit3_2DAngleTimesR
Crit3_2DAngle_max FloatVec The maximum of Crit3_2DAngle
Crit3_2DAngle_min FloatVec The minimum of Crit3_2DAngle
Crit3_3DAngleTimesR_max FloatVec The maximum of Crit3_3DAngleTimesR
Crit3_3DAngleTimesR_min FloatVec The minimum of Crit3_3DAngleTimesR
Crit3_3DAngle_max FloatVec The maximum of Crit3_3DAngle
Crit3_3DAngle_min FloatVec The minimum of Crit3_3DAngle
Crit3_ChangeRZRatio_max FloatVec The maximum of Crit3_ChangeRZRatio
Crit3_ChangeRZRatio_min FloatVec The minimum of Crit3_ChangeRZRatio
Crit3_IPCircleDistTimesR_max FloatVec The maximum of Crit3_IPCircleDistTimesR
Crit3_IPCircleDistTimesR_min FloatVec The minimum of Crit3_IPCircleDistTimesR
Crit3_IPCircleDist_max FloatVec The maximum of Crit3_IPCircleDist
Crit3_IPCircleDist_min FloatVec The minimum of Crit3_IPCircleDist
Crit3_NoZigZag_MV_max FloatVec The maximum of Crit3_NoZigZag_MV
Crit3_NoZigZag_MV_min FloatVec The minimum of Crit3_NoZigZag_MV
Crit3_PT_MV_max FloatVec The maximum of Crit3_PT_MV
Crit3_PT_MV_min FloatVec The minimum of Crit3_PT_MV
Crit3_PT_max FloatVec The maximum of Crit3_PT
Crit3_PT_min FloatVec The minimum of Crit3_PT
Crit4_2DAngleChange_max FloatVec The maximum of Crit4_2DAngleChange
Crit4_2DAngleChange_min FloatVec The minimum of Crit4_2DAngleChange
Crit4_3DAngleChangeNormed_max FloatVec The maximum of Crit4_3DAngleChangeNormed
Crit4_3DAngleChangeNormed_min FloatVec The minimum of Crit4_3DAngleChangeNormed
Crit4_3DAngleChange_max FloatVec The maximum of Crit4_3DAngleChange
Crit4_3DAngleChange_min FloatVec The minimum of Crit4_3DAngleChange
Crit4_DistOfCircleCenters_max FloatVec The maximum of Crit4_DistOfCircleCenters
Crit4_DistOfCircleCenters_min FloatVec The minimum of Crit4_DistOfCircleCenters
Crit4_DistToExtrapolation_max FloatVec The maximum of Crit4_DistToExtrapolation
Crit4_DistToExtrapolation_min FloatVec The minimum of Crit4_DistToExtrapolation
Crit4_NoZigZag_max FloatVec The maximum of Crit4_NoZigZag
Crit4_NoZigZag_min FloatVec The minimum of Crit4_NoZigZag
Crit4_PhiZRatioChange_max FloatVec The maximum of Crit4_PhiZRatioChange
Crit4_PhiZRatioChange_min FloatVec The minimum of Crit4_PhiZRatioChange
Crit4_RChange_max FloatVec The maximum of Crit4_RChange
Crit4_RChange_min FloatVec The minimum of Crit4_RChange
Criteria StringVec Crit2_DeltaPhi Crit2_DeltaPhi_MV Crit2_DeltaRho Crit2_DeltaTheta_MV Crit2_Distance_MV Crit2_HelixWithIP Crit2_RZRatio Crit2_StraightTrackRatio Crit3_2DAngle Crit3_2DAngleTimesR Crit3_3DAngle Crit3_3DAngleTimesR Crit3_ChangeRZRatio Crit3_IPCircleDist Crit3_IPCircleDistTimesR Crit3_NoZigZag_MV Crit3_PT Crit3_PT_MV Crit4_2DAngleChange Crit4_3DAngleChange Crit4_3DAngleChangeNormed Crit4_DistOfCircleCenters Crit4_DistToExtrapolation Crit4_NoZigZag Crit4_PhiZRatioChange Crit4_RChange A vector of the criteria that are going to be used. For every criterion a min and max needs to be set!!!
EnergyLossOn bool true Use Energy Loss in Fit
HelixFitMax double 500 The maximum chi2/Ndf that is allowed as result of a helix fit
HitsPerTrackMin int 4 The minimum number of hits to create a track
InitialTrackErrorD0 float 1e+06 Value used for the initial d0 variance of the trackfit
InitialTrackErrorOmega float 0.0001 Value used for the initial omega variance of the trackfit
InitialTrackErrorPhi0 float 100 Value used for the initial phi0 variance of the trackfit
InitialTrackErrorTanL float 100 Value used for the initial tanL variance of the trackfit
InitialTrackErrorZ0 float 1e+06 Value used for the initial z0 variance of the trackfit
InnerTrackerName string InnerTrackerBarrel Name of the inner tracker detector element
LastLayerToIP int 3 The maximum step between layers
MVHitsThetaDifference double 0.1 The difference in polar angle (in degrees) between two hits in the INNER layer in order to form a minivector
MVHitsThetaDifference_Adjacent double 0.5 The difference in polar angle (in degrees) between two hits in adjacent layers in order to form a minivector
MaxChi2PerHit float 100 Maximum Chi-squared value allowed when assigning a hit to a track
MaxConnectionsAutomaton int 100000 If the automaton has more connections than this it will be redone with the next set of cut off parameters
MaxDistance double 20 The maximum distance between two hits in adjacent layers in order to form a minivector
MaxHitsPerSector int 1000 Maximal number of hits allowed on a sector. More will cause drop of hits in sector
MultipleScatteringOn bool true Use MultipleScattering in Fit
NDivisionsInPhi int 80 Number of divisions in Phi
NDivisionsInTheta int 80 Number of divisions in Theta
NHitsChi2 int 5 Maximal number of hits for which a track with n hits is better than one with n-1hits. (defaut 5)
OuterTrackerName string OuterTrackerBarrel Name of the outer tracker detector element
PixRes FloatVec 0.004 VXD pixels resolution
SITHitCollectionName string SITSpacePoints SIT Hit Collection Name
SmoothOn bool true Smooth All Mesurement Sites in Fit
StepMax int 2 The maximum step between layers
UseSIT int 1 Use SIT
VTXHitCollectionName string VTXTrackerHits VTX Hit Collection Name
VXDName string VertexBarrel Name of the vertex detector element
kalFitMax double 500 The maximum chi2/Ndf that is allowed as result of a Kalman fit
DDPlanarDigiProcessor libMarlinTrkProcessors.so.2.12.8

DDPlanarDigiProcessor creates TrackerHits from SimTrackerHits, smearing their position and time according to the input parameters.The geoemtry of the surface is taken from the DDRec::Surface associated to the hit via the cellID

Parameter Type Default Description
CorrectTimesForPropagation bool false Correct hit time for the propagation: radial distance/c (default: false)
ForceHitsOntoSurface bool false Project hits onto the surface in case they are not yet on the surface (default: false)
IsStrip bool false whether hits are 1D strip hits
MinimumEnergyPerHit double 0 Minimum Energy (in GeV!) to accept hits, other hits are ignored
ResolutionT FloatVec -1 resolution of time - either one per layer or one for all layers. if the single entry is negative, disable time smearing.
ResolutionU FloatVec 0.004 resolution in direction of u - either one per layer or one for all layers
ResolutionV FloatVec 0.004 resolution in direction of v - either one per layer or one for all layers
SimTrackHitCollectionName string VXDCollection Name of the Input SimTrackerHit collection
SimTrkHitRelCollection string VTXTrackerHitRelations Name of TrackerHit SimTrackHit relation collection
SubDetectorName string VXD Name of dub detector
TimeWindowMax FloatVec 1e+09 Maximum time a hit must have after smearing to be accepted [ns] - either one per layer or one for all layers
TimeWindowMin FloatVec -1e+09 Minimum time a hit must have after smearing to be accepted [ns] - either one per layer or one for all layers
TrackerHitCollectionName string VTXTrackerHits Name of the TrackerHit output collection
UseTimeWindow bool false Only accept hits with time (after smearing) within the specified time window (default: false)
DDSpacePointBuilder libMarlinTrkProcessors.so.2.12.8

DDSpacePointBuilder combine si-strip measurements into 3D spacepoints (1TrackerHitPlanar+1TrackHitPlanar = 1 TrackerHit), that can be used by reconstruction

Parameter Type Default Description
SimHitSpacePointRelCollection string FTDSimHitSpacepointRelations Name of the SpacePoint SimTrackerHit relation collection
SpacePointsCollection string FTDSpacePoints SpacePointsCollection
StripLength double 0 The length of the strips of the subdetector in mm
StriplengthTolerance float 0.1 Tolerance added to the strip length when calculating strip hit intersections
SubDetectorName string SIT Name of dub detector
TrackerHitCollection string FTDTrackerHits TrackerHitCollection
TrackerHitSimHitRelCollection string FTDTrackerHitRelations The name of the input collection of the relations of the TrackerHits to SimHits
DDTPCDigiProcessor libMarlinTrkProcessors.so.2.12.8

Produces TPC TrackerHit collection from SimTrackerHit collection, smeared in RPhi and Z. A search is made for adjacent hits on a pad row, if they are closer in z and r-phi than the steering parameters _doubleHitResRPhi (default value 2.0 mm) and _doubleHitResZ (default value 5.0 mm) they are considered to overlap. Clusters of hits smaller than _maxMerge (default value 3) are merged into a single tracker hit, with the position given as the average poision of the hits in phi and in z. Clusters which have _maxMerge hits or more are determined to be identifiable as multiple hits, and are not added to the tracker hit collection. This of course means that good hits caught up in a cluster of background hits will be lossed.

Parameter Type Default Description
DiffusionCoeffRPhi float 0.025 R-Phi Diffusion Coefficent in TPC
DiffusionCoeffZ float 0.08 Z Diffusion Coefficent in TPC
DoubleHitResolutionRPhi float 2 Defines the minimum distance for two seperable hits in RPhi
DoubleHitResolutionZ float 5 Defines the minimum distance for two seperable hits in Z
HitSortingBinningRPhi float 2 Defines spatial slice in RP
HitSortingBinningZ float 5 Defines spatial slice in Z
MaxClusterSizeForMerge int 3 Defines the maximum number of adjacent hits which can be merged
N_eff int 22 Number of Effective electrons per pad in TPC
PointResolutionPadPhi float 0.9 Pad Phi Resolution constant in TPC
PointResolutionRPhi float 0.05 R-Phi Resolution constant in TPC
PointResolutionZ float 0.4 TPC Z Resolution Coefficent independent of diffusion
RejectCellID0 int 1 whether or not to use hits without proper cell ID (pad row)
SimTrkHitRelCollection string TPCTrackerHitRelations Name of TrackerHit SimTrackHit relation collection
TPCEndPlateModuleGapPhi float 1 Gap size in mm of the gaps between the endplace modules in Phi
TPCEndPlateModuleGapR float 1 Gap size in mm of the gaps between the endplace modules in R
TPCEndPlateModuleNumbers IntVec 14 18 23 28 32 37 42 46 Number of modules in the rings of the TPC endplate
TPCEndPlateModulePhi0s FloatVec 0 0.01 0.02 0.03 0.04 0.05 0.06 0.07 Phi0s of modules in the rings of the TPC endplate
TPCLowPtCollectionName string TPCLowPtCollection Name of the LowPt SimTrackerHit collection Produced by Mokka TPC Driver TPC0X
TPCPadRowHitCollectionName string TPCCollection Name of the default pad-row based SimTrackerHit collection
TPCSpacePointCollectionName string TPCSpacePointCollection Name of the additional space point collection which provides additional guide hits between pad row centers.
TPCTrackerHitsCol string TPCTrackerHits Name of the Output TrackerHit collection
UseRawHitsToStoreSimhitPointer bool false Store the pointer to the SimTrackerHits in RawHits (deprecated)
ExtrToSIT libMarlinTrkProcessors.so.2.12.8

ExtrToSIT refits an input track collection (TPC or VXD), and used IMarlinTrk tools to propagate it to SIT

Parameter Type Default Description
Chi2NDoFCut float 100 maximum acceptable chi2/ndof for the TPC tracks
DirInsideOut bool true direction for the extrapolation. if true it means we extrapolate from VXD, otherwise from TPC
DoCut float 2 maximum acceptable D0 at IP
EnergyLossOn bool true Use Energy Loss in Fit
InputTrackCollectionName string TruthTracks Name of the input track collection
InputTrackRelCollection string TruthTracksMCP Name of the MCParticle-Track Relations collection for input tracks
IsSpacePoints bool false If we use space points rather than hits (SIT)
MCParticleCollection string MCParticle Name of the MCParticle input collection
Max_Chi2_Incr double 1000 maximum allowable chi2 increment when moving from one site to another
MultipleScatteringOn bool true Use MultipleScattering in Fit
NHitsChi2 int 5 Maximal number of hits for which a track with n hits is better than one with n-1hits. (defaut 5)
OutputTrackCollectionName string RefittedTracks Name of the output track collection
OutputTrackRelCollection string RefittedTracksMCP Name of the MCParticle-Track Relations collection for output tracks
PropagateToLayer int 4 Which layer should the seed be propagated to
SearchSigma double 3 times d0(Z0) acceptable from track extrapolation point
SiliconCollectionName string SiliconTracks Name of the output silicon track collection
SmoothOn bool false Smooth All Mesurement Sites in Fit
TPCHitsCut int 6 minimum acceptable no of hits for the TPC tracks
TrackSystemName string DDKalTest Name of the track fitting system to be used (KalTest, DDKalTest, aidaTT, ... )
TrackerHitsRelInputCollections StringVec VXDTrackerHitRelations SITTrackerHitRelations Name of the lcrelation collections, that link the TrackerHits to their SimTrackerHits.
ZoCut float 5 maximum acceptable Z0 at IP
digitisedSITHits string SITTrackerHits Name of the SITTrackerHit collection
digitisedVXDHits string VTXTrackerHits Name of the VTXTrackerHit collection
ExtrToTracker libMarlinTrkProcessors.so.2.12.8

ExtrToTracker refits an input VXD track collection and uses IMarlinTrk tools to propagate it to the main tracker

Parameter Type Default Description
EnergyLossOn bool true Use Energy Loss in Fit
InputTrackCollectionName string TruthTracks Name of the input track collection
Max_Chi2_Incr double 1000 maximum allowable chi2 increment when moving from one site to another
MultipleScatteringOn bool true Use MultipleScattering in Fit
OutputNotUsedHitCollectionName string NotUsedHits Name of the output collection with the not used hits
OutputTrackCollectionName string ExtrTracks Name of the output track collection
PerformFinalRefit bool false perform a final refit of the extrapolated track
SearchSigma double 3 times d0(Z0) acceptable from track extrapolation point
SmoothOn bool false Smooth All Mesurement Sites in Fit
extrapolateForward bool true if true extrapolation in the forward direction (in-out), otherwise backward (out-in)
vecDigiHits StringVec ITrackerHits OTrackerHits ITrackerEndcapHits OTrackerEndcapHits vector of name of the digi hits collection - need to be syncro with vecSubdetName!
vecSubdetName StringVec InnerTrackerBarrel OuterTrackerBarrel InnerTrackerEndcap OuterTrackerEndcap vector of names of all subdetector to exrapolate to
FPCCDFullLDCTracking_MarlinTrk libMarlinTrkProcessors.so.2.12.8

Performs full tracking in ILD detector

Parameter Type Default Description
AngleCutForForcedMerging float 0.05 Cut on Opening Angle for forced merging of Si and TPC segments
AngleCutForMerging float 0.1 Cut on Opening Angle for merging Si and TPC segments
AssignETDHits int 1 Assign ETD Hits
AssignFTDHits int 1 Assign left over FTD hits
AssignSETHits int 1 Assign SET Hits
AssignSITHits int 1 Assign left over SIT hits
AssignTPCHits int 1 Assign left over TPC hits
AssignVTXHits int 1 Assign left over VTX hits
Chi2FitCut float 100 Cut on fit Chi2
CutOnSiHits int 4 Cut on the number of the Si hits for tracks with no TPC hits
CutOnTPCHits int 35 Cut on the number of the TPC hits for tracks with no Si hits
CutOnTrackD0 float 500 Cut on the track parameter D0
CutOnTrackZ0 float 500 Cut on the track parameter Z0
D0CutForForcedMerging float 50 Cut on D0 difference for forced merging of Si and TPC segments
D0CutForMerging float 500 Cut on D0 difference for merging of Si and TPC segments
D0CutToMergeTPCSegments float 100 Cut on D0 difference for merging TPC segments
Debug int 0 Activate debugging?
DeltaPCutToMergeTPCSegments float 0.1 Cut on dP/P difference for merging TPC segments
ETDHitCollection string ETDTrackerHits ETD Hit Collection Name
ETDHitToTrackDistance float 10 Cut on distance between track and ETD hits
EnergyLossOn bool true Use Energy Loss in Fit
FTDHitToTrackDistance float 2 Cut on distance between track and FTD hits
FTDPixelHitCollectionName string FTDPixelTrackerHits FTD Pixel Hit Collection Name
FTDPixelTrackerHitRelations string FTDPixelTrackerHitRelations Name of the LCRelation input collection
FTDSpacePointCollectionName string FTDSpacePoints FTD FTDSpacePoint Collection Name
FTDSpacePointRelations string FTDSpacePointRelations Name of the LCRelation input collection
FinalTrackCut_strategyA bool false Tracks which have SIT hit, TPC hit, or |costheta < 0.9| are stored. The others are discarded in the end of this processor. This is for reducing pair BG tracks.
ForbidOverlapInZComb int 0 Forbid overlap in Z for combining TPC segments with tracks having Si hits
ForbidOverlapInZTPC int 0 Forbid overlap in Z for the merged TPC segments
ForceSiTPCMerging int 0 Force merging of Si and TPC segments?
ForceTPCSegmentsMerging int 0 Force merging of TPC Segments?
InitialTrackErrorD0 float 1e+06 Value used for the initial d0 variance of the trackfit
InitialTrackErrorOmega float 0.0001 Value used for the initial omega variance of the trackfit
InitialTrackErrorPhi0 float 100 Value used for the initial phi0 variance of the trackfit
InitialTrackErrorTanL float 100 Value used for the initial tanL variance of the trackfit
InitialTrackErrorZ0 float 1e+06 Value used for the initial z0 variance of the trackfit
LDCTrackCollection string LDCTracks LDC track collection name
MaxAllowedPercentageOfOutliersForTrackCombination float 0.3 Maximum number of outliers allowed before track combination is vetoed
MaxAllowedSiHitRejectionsForTrackCombination int 2 Maximum number of outliers allowed before track combination is vetoed
MaxChi2ForSiliconTracks double 15 Max Chi2/ndf value allowed for Silicon Tracks.
MaxChi2PerHit double 100 Maximum Chi-squared value allowed when assigning a hit to a track
MinChi2ProbForSiliconTracks double 0.001 Minimum Chi-squared P value allowed for Silicon Tracks.
MultipleScatteringOn bool true Use MultipleScattering in Fit
NHitsExtrapolation int 35 number of hits for outward extrapolation
OmegaCutForForcedMerging float 0.15 Cut on Omega difference for forced merging of Si and TPC segments
OmegaCutForMerging float 0.25 Cut on Omega difference for merging Si and TPC segments
PtCutToMergeTPCSegments float 1.2 Cut on Pt of tracks for merging TPC segments
SETHitCollection string SETTrackerHits SET Hit Collection Name
SETHitToTrackDistance float 2 Cut on distance between track and SET hits
SETSpacePointRelations string SETSpacePointRelations Name of the LCRelation input collection
SITHitCollection string SITTrackerHits SIT Hit Collection Name
SITHitToTrackDistance float 2 Cut on distance between track and SIT hits
SITSpacePointRelations string SITSpacePointRelations Name of the LCRelation input collection
SiTracks string SiTracks Si Track Collection
SiTracksMCPRelColl string SiTracksMCP Si Track to Collection
SimTrackerHit of FTD_PIXEL (FTD_PIXELCollection) string FTD_PIXELCollection This is used to calculate picking efficiency of a track.
SimTrackerHit of FTD_STRIP (FTD_STRIPCollection) string FTD_STRIPCollection This is used to calculate picking efficiency of a track.
SimTrackerHit of SET (SETCollection) string SETCollection This is used to calculate picking efficiency of a track.
SimTrackerHit of SIT (SITCollection) string SITCollection This is used to calculate picking efficiency of a track.
SimTrackerHit of TPC (TPCCollection) string TPCCollection This is used to calculate picking efficiency of a track.
SimTrackerHit of VXD (VXDCollection) string VXDCollection This is used to calculate picking efficiency of a track.
SmoothOn bool true Smooth All Mesurement Sites in Fit
TPCHitCollection string TPCTrackerHits TPC Hit Collection Name
TPCHitToTrackDistance float 15 Cut on distance between track and TPC hits
TPCTrackerHitRelations string TPCTrackerHitRelations Name of the LCRelation input collection
TPCTracks string TPCTracks TPC Track Collection
TPCTracksMCPRelColl string TPCTracksMCP TPC Track to MCP Relation Collection Name
VTXHitCollection string VTXTrackerHits VTX Hit Collection Name
VTXHitToTrackDistance float 1.5 Cut on distance between track and VTX hits
VXDTrackerHitRelations string VXDTrackerHitRelations Name of the LCRelation input collection
VetoMergeMomentumCut float 2.5 Minimum momentum for which Veto is applicable
Z0CutForForcedMerging float 200 Cut on Z0 difference for forced merging of Si and TPC segments
Z0CutForMerging float 1000 Cut on Z0 difference for merging of Si and TPC segments
Z0CutToMergeTPCSegments float 5000 Cut on Z0 difference for merging TPC segments
cosThetaCutHighPtMerge float 0.99 Cut on cos theta between the two momentum vectors when considering merger of high Pt tracks
cosThetaCutSoftHighPtMerge float 0.998 cut on cos theta between the two momentum vectors when considering merger of high Pt tracks for softer dp/p cut
hitDistanceCutHighPtMerge float 25 cut on 3D distance between hit and helix extrapolation when considering merger of high Pt tracks
maxFractionOfOutliersCutHighPtMerge float 0.95 cut on maximum fraction of outliers when considering merger of high Pt tracks
maxHitDistanceCutHighPtMerge float 50 cut for max 3D distance between any hit and helix extrapolation when considering merger of high Pt tracks
momDiffCutHighPtMerge float 0.01 cut on dp/p when considering merger of high Pt tracks
momDiffCutSoftHighPtMerge float 0.25 softer cut on dp/p when considering merger of high Pt tracks
mydebug bool false mydebug
mydebugPrintMCP bool false mydebugPrintMCP
useMaxChi2RequirementForSiTrk bool true true : MaxChi2ForSiliconTracks is used. false : MinChi2ProbForSiliconTracks is used
FPCCDSiliconTracking_MarlinTrk libMarlinTrkProcessors.so.2.12.8

Pattern recognition in silicon trackers

Parameter Type Default Description
AngleCutForMerging float 0.1 Angle Cut For Merging
AttachRemainingHitsForFTD int 2 1:Fast, 2:Slow, 0:skip this process
AttachRemainingHitsForVXD int 2 1:Fast, 2:Slow, 3:VeryFast, 0:skip this process
CheckForDelta int 1 Check for Delta rays hits in hit-to-track assignment
Chi2FitCut float 120 Chi2 Fit Cut
Chi2FitCut_kalman float 120 Chi2 Fit Cut for BuildTrack_KalFit
Chi2WRphiTriplet float 1 Chi2WRphiTriplet
Chi2WZTriplet float 0.5 Chi2WZTriplet
CutOnD0 float 60 cut on D0 for tracks
CutOnPt_For_FTD_section double 0.05 cut on Pt for TestTriplet in FTD section
CutOnPt_For_VXD+SIT_section double 0.18 cut on Pt for TestTriplet in VXD+SIT section
CutOnZ0 float 100 cut on Z0 for tracks
EnergyLossOn bool true Use Energy Loss in Fit
FPCCD: Each_FPCCD_pixelSize(mm) FloatVec 0.005 0.005 0.01 0.01 0.01 0.01 Each ladder's FPCCD Pixel size(unit:mm) (for cluster rejection for FPCCD)
FPCCD: PixelHeight float 0.015 Pixel Height(mm) (for cluster rejection for FPCCD)
FTDPixelHitCollectionName string FTDPixelTrackerHits FTD Pixel Hit Collection Name
FTDPixelTrackerHitRelations string FTDPixelTrackerHitRelations Name of the LCRelation input collection
FTDSpacePointCollectionName string FTDSpacePoints FTD FTDSpacePoint Collection Name
FTDSpacePointRelations string FTDSpacePointRelations Name of the LCRelation input collection
FudgeFactorForSIT_rphi_SpatialResolution float 2 SIT's spatial resolution is not calculated precisely. (default : 2.0)
FudgeFactorForSIT_z_SpatialResolution float 1 SIT's spatial resolution is not calculated precisely. (default : 1.0)
InitialTrackErrorD0 float 1e+06 Value used for the initial d0 variance of the trackfit
InitialTrackErrorOmega float 0.0001 Value used for the initial omega variance of the trackfit
InitialTrackErrorPhi0 float 100 Value used for the initial phi0 variance of the trackfit
InitialTrackErrorTanL float 100 Value used for the initial tanL variance of the trackfit
InitialTrackErrorZ0 float 1e+06 Value used for the initial z0 variance of the trackfit
LayerCombinations IntVec 8 6 5 8 6 4 8 5 4 6 5 4 Combinations of Hits in Layers
LayerCombinationsFTD IntVec 13 11 9 13 11 8 13 10 9 13 10 8 12 11 9 12 11 8 12 10 9 12 10 8 11 9 7 11 9 6 11 8 7 11 8 6 10 9 7 10 9 6 10 8 7 9 7 5 9 7 4 9 6 5 9 6 4 8 7 5 8 7 4 8 6 5 8 6 4 7 5 3 7 5 2 7 4 3 7 4 2 6 5 3 6 5 2 6 4 3 6 4 2 5 3 1 5 3 0 5 2 1 5 2 0 4 3 1 4 3 0 4 2 1 4 2 0 Combinations of Hits in FTD
MCParticleCollectionName string MCParticle Name of the MCParticle input collection
MaxChi2PerHit double 100 Maximum Chi-squared value allowed when assigning a hit to a track (for KalTest)
MaxChi2PerHit2nd double 100 Maximum Chi-squared value allowed when assigning a hit to a track (especially for KalFit in this code)
MaxHitsPerSector int 100 Maximal number of hits allowed in one theta-phi sector in FTD (In VXD and SIT, this is not implemented)
MinDistCutAttachForFTD float 2.5 MinDistCutAttachForFTD
MinDistCutAttachForVXD float 0.5 MinDistCutAttachForVXD
MinDistToDelta float 0.25 Minimal distance of track hit to the delta electron hit
MinLayerToAttach int -1 MinLayerToAttach
MinMissAddition int 2 Allowed max number of MinMissAdditions in BuildTrack
MinimalHits int 3 minimal hits (default 3)
MultipleScatteringOn bool true Use MultipleScattering in Fit
NDivisionsInPhi int 1440 Number of divisions in Phi
NDivisionsInPhiFTD int 30 Number of divisions in Phi for FTD
NDivisionsInTheta int 640 Number of divisions in Theta
NDivisions_cosThetaRangeForBuildTrackForHighPt double 0.025 set width of cosTheta value [0,2].ex: 2/80 = 0.025 (This value emulates original SiliconTracking_MarlinTrk by default)
NDivisions_phiRangeForBuildTrackForHighPt double 4.5 set width of phi(deg) value [0,360].ex: 360deg/80 = 4.5 (This value emulates original SiliconTracking_MarlinTrk by default)
NHitsChi2 int 8 Maximal number of hits for which a track with n hits is better than one with n-1hits. (defaut 8)
SITHitCollectionName string SITSpacePoints SIT Hit Collection Name
SITSpacePointRelations string SITSpacePointRelations Name of the LCRelation input collection
SafetyPhi-Range_fix_ForTripletSearchAndExtrapolation int 1 Range += this
SafetyPhi-Range_ratio_ForTripletSearchAndExtrapolation float 0.1 Range <= (1 + this)*Range
SearchWindowForTripletInTheta int 16 num of theta-sectors used in making triplets
SiTrackCollectionName string SiTracks Silicon track Collection Name
SimTrackerHit of FTD_PIXEL (FTD_PIXELCollection) string FTD_PIXELCollection This is used to calculate picking efficiency of a track.
SimTrackerHit of FTD_STRIP (FTD_STRIPCollection) string FTD_STRIPCollection This is used to calculate picking efficiency of a track.
SimTrackerHit of SIT (SITCollection) string SITCollection This is used to calculate picking efficiency of a track.
SimTrackerHit of VXD (VXDCollection) string VXDCollection This is used to calculate picking efficiency of a track.
SmoothOn bool false Smooth All Mesurement Sites in Fit
UseClusterRejection bool false Use Cluster Rejection (for FPCCD VXD in dense pair-BG env. option)
UseFTD int 1 Use FTD
UseSIT int 1 Use SIT
VTXHitCollectionName string VXDTrackerHits VTX Hit Collection Name
VXDTrackerHitRelations string VXDTrackerHitRelations Name of the LCRelation input collection
fudgePhiRange int 2 fudgePhiRange for the iterative determination of search range in the extrapolation
fudgeThetaRange int 2 fudgeThetaRange for the iterative determination of search range in the extrapolation
keepCandidate bool false Option for AttachRemainingVTXHitsVeryFast (please fix false for now)
minDotOf2Clusters float 0.4 minimum dot of 2Clusters (for FPCCD VXD in dense pair-BG env. option)
mydebug bool false mydebug (code debuger for Mori)
mydebugIntersection bool false mydebugIntersection (code debuger for Mori)
mydebugKalFit bool false mydebugKalFit (code debuger for Mori)
mydebugstopwatch2 bool false mydebugstopwatch2 (code debuger for Mori)
nSigma_for_Build_phiTrack double 5 In extrapolation, search area in phi is determined by using sigma of d0, so you can enlarge this area by this value.
nSigma_for_Build_thetaTrack double 5 In extrapolation, search area in phi is determined by using sigma of d0, so you can enlarge this area by this value.
stopwatch bool false stopwatch (code debuger for Mori)
FullLDCTracking_MarlinTrk libMarlinTrkProcessors.so.2.12.8

Performs full tracking in ILD detector

Parameter Type Default Description
AngleCutForForcedMerging float 0.05 Cut on Opening Angle for forced merging of Si and TPC segments
AngleCutForMerging float 0.1 Cut on Opening Angle for merging Si and TPC segments
AssignETDHits int 1 Assign ETD Hits
AssignFTDHits int 1 Assign left over FTD hits
AssignSETHits int 1 Assign SET Hits
AssignSITHits int 1 Assign left over SIT hits
AssignTPCHits int 1 Assign left over TPC hits
AssignVTXHits int 1 Assign left over VTX hits
Chi2FitCut float 100 Cut on fit Chi2
CutOnSiHits int 4 Cut on the number of the Si hits for tracks with no TPC hits
CutOnTPCHits int 35 Cut on the number of the TPC hits for tracks with no Si hits
CutOnTrackD0 float 500 Cut on the track parameter D0
CutOnTrackZ0 float 500 Cut on the track parameter Z0
D0CutForForcedMerging float 50 Cut on D0 difference for forced merging of Si and TPC segments
D0CutForMerging float 500 Cut on D0 difference for merging of Si and TPC segments
D0CutToMergeTPCSegments float 100 Cut on D0 difference for merging TPC segments
Debug int 0 Activate debugging?
DeltaPCutToMergeTPCSegments float 0.1 Cut on dP/P difference for merging TPC segments
ETDHitCollection string ETDTrackerHits ETD Hit Collection Name
ETDHitToTrackDistance float 10 Cut on distance between track and ETD hits
EnergyLossErrorTPC float 0.05 Fractional error of dEdx in the TPC
EnergyLossOn bool true Use Energy Loss in Fit
FTDHitToTrackDistance float 2 Cut on distance between track and FTD hits
FTDPixelHitCollectionName string FTDPixelTrackerHits FTD Pixel Hit Collection Name
FTDSpacePointCollectionName string FTDSpacePoints FTD FTDSpacePoint Collection Name
ForbidOverlapInZComb int 0 Forbid overlap in Z for combining TPC segments with tracks having Si hits
ForbidOverlapInZTPC int 0 Forbid overlap in Z for the merged TPC segments
ForceSiTPCMerging int 0 Force merging of Si and TPC segments?
ForceTPCSegmentsMerging int 0 Force merging of TPC Segments?
ForwardTrackerDetectorName string FTD Name of the forward tracking detector in the geometry
InitialTrackErrorD0 float 1e+06 Value used for the initial d0 variance of the trackfit
InitialTrackErrorOmega float 0.0001 Value used for the initial omega variance of the trackfit
InitialTrackErrorPhi0 float 100 Value used for the initial phi0 variance of the trackfit
InitialTrackErrorTanL float 100 Value used for the initial tanL variance of the trackfit
InitialTrackErrorZ0 float 1e+06 Value used for the initial z0 variance of the trackfit
InnerTrackerDetectorName string SIT Name of the inner (barrel) tracking detector in the geometry
LDCTrackCollection string LDCTracks LDC track collection name
MaxAllowedPercentageOfOutliersForTrackCombination float 0.3 Maximum number of outliers allowed before track combination is vetoed
MaxAllowedSiHitRejectionsForTrackCombination int 2 Maximum number of outliers allowed before track combination is vetoed
MaxChi2PerHit double 100 Maximum Chi-squared value allowed when assigning a hit to a track
MinChi2ProbForSiliconTracks double 0.001 Minimum Chi-squared P value allowed for Silicon Tracks.
MultipleScatteringOn bool true Use MultipleScattering in Fit
NHitsExtrapolation int 35 number of hits for outward extrapolation
OmegaCutForForcedMerging float 0.15 Cut on Omega difference for forced merging of Si and TPC segments
OmegaCutForMerging float 0.25 Cut on Omega difference for merging Si and TPC segments
PtCutToMergeTPCSegments float 1.2 Cut on Pt of tracks for merging TPC segments
SETHitCollection string SETTrackerHits SET Hit Collection Name
SETHitToTrackDistance float 2 Cut on distance between track and SET hits
SITHitCollection string SITTrackerHits SIT Hit Collection Name
SITHitToTrackDistance float 2 Cut on distance between track and SIT hits
SiTracks string SiTracks Si Track Collection
SiTracksMCPRelColl string SiTracksMCP Si Track to Collection
SiliconExternalDetectorName string SET Name of the silicon external tracking detector in the geometry
SmoothOn bool true Smooth All Mesurement Sites in Fit
TPCHitCollection string TPCTrackerHits TPC Hit Collection Name
TPCHitToTrackDistance float 15 Cut on distance between track and TPC hits
TPCTracks string TPCTracks TPC Track Collection
TPCTracksMCPRelColl string TPCTracksMCP TPC Track to MCP Relation Collection Name
TrackSystemName string KalTest Name of the track fitting system to be used (KalTest, DDKalTest, aidaTT, ... )
VTXHitCollection string VTXTrackerHits VTX Hit Collection Name
VTXHitToTrackDistance float 1.5 Cut on distance between track and VTX hits
VertexDetectorName string VXD Name of the vertex (barrel) tracking detector in the geometry
VertexEndcapDetectorName string VertexEndcap Name of the vertex endcap tracking detector in the geometry
VetoMergeMomentumCut float 2.5 Minimum momentum for which Veto is applicable
Z0CutForForcedMerging float 200 Cut on Z0 difference for forced merging of Si and TPC segments
Z0CutForMerging float 1000 Cut on Z0 difference for merging of Si and TPC segments
Z0CutToMergeTPCSegments float 5000 Cut on Z0 difference for merging TPC segments
cosThetaCutHighPtMerge float 0.99 Cut on cos theta between the two momentum vectors when considering merger of high Pt tracks
cosThetaCutSoftHighPtMerge float 0.998 cut on cos theta between the two momentum vectors when considering merger of high Pt tracks for softer dp/p cut
hitDistanceCutHighPtMerge float 25 cut on 3D distance between hit and helix extrapolation when considering merger of high Pt tracks
maxFractionOfOutliersCutHighPtMerge float 0.95 cut on maximum fraction of outliers when considering merger of high Pt tracks
maxHitDistanceCutHighPtMerge float 50 cut for max 3D distance between any hit and helix extrapolation when considering merger of high Pt tracks
momDiffCutHighPtMerge float 0.01 cut on dp/p when considering merger of high Pt tracks
momDiffCutSoftHighPtMerge float 0.25 softer cut on dp/p when considering merger of high Pt tracks
RefitFinal libMarlinTrkProcessors.so.2.12.8

Refit processor that calls finaliseLCIOTrack after taking the trackstate from the existing track. No re-sorting of hits is done

Parameter Type Default Description
EnergyLossOn bool true Use Energy Loss in Fit
InputRelationCollectionName string SiTrackRelations Name of the input track to MCParticle relation collection
InputTrackCollectionName string TruthTracks Name of the input track collection
Max_Chi2_Incr double 1.79769e+308 maximum allowable chi2 increment when moving from one site to another
MinClustersOnTrackAfterFit int 4 Final minimum number of track clusters
MultipleScatteringOn bool true Use MultipleScattering in Fit
OutputRelationCollectionName string RefittedRelation Refit Track to MCParticle relation collection Name
OutputTrackCollectionName string RefittedTracks Name of the output track collection
ReferencePoint int -1 Identifier of the reference point to use for the fit initialisation, -1 means at 0 0 0
SmoothOn bool false Smooth All Mesurement Sites in Fit
extrapolateForward bool true if true extrapolation in the forward direction (in-out), otherwise backward (out-in)
RefitProcessor libMarlinTrkProcessors.so.2.12.8

RefitProcessor refits an input track collection, producing a new collection of tracks.

Parameter Type Default Description
EnergyLossOn bool true Use Energy Loss in Fit
FitDirection int -1 Fit direction: -1: backward [default], +1: forward
InitialTrackErrorD0 float 1e+06 Value used for the initial d0 variance of the trackfit
InitialTrackErrorOmega float 0.0001 Value used for the initial omega variance of the trackfit
InitialTrackErrorPhi0 float 100 Value used for the initial phi0 variance of the trackfit
InitialTrackErrorTanL float 100 Value used for the initial tanL variance of the trackfit
InitialTrackErrorZ0 float 1e+06 Value used for the initial z0 variance of the trackfit
InitialTrackState int -1 TrackState to use for initialization of the fit: -1: refit from hits [default], 1: AtIP, 2: AtFirstHit, 3: AtLastHit, 4:AtCalo
InputTrackCollectionName string TruthTracks Name of the input track collection
InputTrackRelCollection string TruthTracksMCP Name of the MCParticle-Track Relations collection for input tracks
MaxChi2PerHit float 100 Maximum Chi-squared value allowed when assigning a hit to a track
MultipleScatteringOn bool true Use MultipleScattering in Fit
OutputTrackCollectionName string RefittedTracks Name of the output track collection
OutputTrackRelCollection string RefittedTracksMCP Name of the MCParticle-Track Relations collection for output tracks
ParticleMass double 0.13957 particle mass that is used in the fit - default is the pion mass: 0.13957018 )
SmoothOn bool false Smooth All Mesurement Sites in Fit
TrackSystemName string KalTest Name of the track fitting system to be used (KalTest, DDKalTest, aidaTT, ... )
SetTrackerHitExtensions libMarlinTrkProcessors.so.2.12.8

Creates Track Collection from MC Truth. Can handle composite spacepoints as long as they consist of two TrackerHits

Parameter Type Default Description
TrackerHitsInputCollections StringVec VXDTrackerHits SITTrackerHits FTDPixelTrackerHits FTDSpacePointRelations TPCTrackerHits SETTrackerHits Name of the tracker hit input collections
TrackerHitsRelInputCollections StringVec VXDTrackerHitRelations SITTrackerHitRelations FTDPixelTrackerHitRelations FTDSpacePointRelations TPCTrackerHitRelations SETTrackerHitRelations Name of the lcrelation collections, that link the TrackerHits to their SimTrackerHits. Have to be in same order as TrackerHitsInputCollections!!!
SiliconTracking_MarlinTrk libMarlinTrkProcessors.so.2.12.8

Pattern recognition in silicon trackers

Parameter Type Default Description
AngleCutForMerging float 0.1 Angle Cut For Merging
AplySimpleUpdatedCoreBin bool false Use simple updated triplets searching core bin. (default is false for backward compatible)
CheckForDelta int 1 Check for Delta rays hits in hit-to-track assignment
Chi2FitCut float 120 Chi2 Fit Cut
Chi2WRphiQuartet float 1 Chi2WRphiQuartet
Chi2WRphiSeptet float 1 Chi2WRphiSeptet
Chi2WRphiTriplet float 1 Chi2WRphiTriplet
Chi2WZQuartet float 0.5 Chi2WZQuartet
Chi2WZSeptet float 0.5 Chi2WZSeptet
Chi2WZTriplet float 0.5 Chi2WZTriplet
CreateDiagnosticsHistograms bool false Create diagnostics histograms for internal analysis.
CutOnD0 float 100 cut on D0 for tracks
CutOnPt float 0.05 cut on Pt
CutOnZ0 float 100 cut on Z0 for tracks
DetectorTypeForDraw int 0 Detector type sent to MarlinCED for drawing
EnergyLossOn bool true Use Energy Loss in Fit
FTDPixelHitCollectionName string FTDPixelTrackerHits FTD Pixel Hit Collection Name
FTDSpacePointCollectionName string FTDSpacePoints FTD FTDSpacePoint Collection Name
FastAttachment int 0 Fast attachment
HelixMaxR float 2000 Max R (mm) Extent for drawing Helix if UseTPCForLimitsOfHelix false
InitialTrackErrorD0 float 1e+06 Value used for the initial d0 variance of the trackfit
InitialTrackErrorOmega float 0.0001 Value used for the initial omega variance of the trackfit
InitialTrackErrorPhi0 float 100 Value used for the initial phi0 variance of the trackfit
InitialTrackErrorTanL float 100 Value used for the initial tanL variance of the trackfit
InitialTrackErrorZ0 float 1e+06 Value used for the initial z0 variance of the trackfit
LayerCombinations IntVec 6 4 3 6 4 2 6 3 2 5 4 3 5 4 2 5 3 2 5 3 1 5 2 1 4 3 2 4 3 1 4 2 1 3 2 1 Combinations of Hits in Layers
LayerCombinationsFTD IntVec 6 5 4 6 5 3 5 4 3 5 4 2 5 4 1 5 3 2 5 3 1 5 2 1 4 3 2 4 3 1 4 3 0 4 2 1 4 2 0 4 1 0 3 2 1 3 2 0 3 1 0 2 1 0 Combinations of Hits in FTD
MCParticleCollectionName string MCParticle Name of the MCParticle input collection
MCpThreshold float 0.1 Transverse Momentum Threshold MC particles which will produce tracks GeV
MaxChi2PerHit double 100 Maximum Chi-squared value allowed when assigning a hit to a track
MaxHitsPerSector int 100 Maximal number of hits allowed in one theta-phi sector in VXD/SIT and FTD
MinDistCutAttach float 2.5 MinDistCutAttach
MinDistToDelta float 0.25 Minimal distance of track hit to the delta electron hit
MinLayerToAttach int -1 MinLayerToAttach
MinimalHits int 3 minimal hits (default 3)
MultipleScatteringOn bool true Use MultipleScattering in Fit
NDivisionsInPhi int 80 Number of divisions in Phi
NDivisionsInPhiFTD int 30 Number of divisions in Phi for FTD
NDivisionsInTheta int 80 Number of divisions in Theta
NHitsChi2 int 5 Maximal number of hits for which a track with n hits is better than one with n-1hits. (defaut 5)
SITHitCollectionName string SITTrackerHits SIT Hit Collection Name
SiTrackCollectionName string SiTracks Silicon track Collection Name
SmoothOn bool true Smooth All Mesurement Sites in Fit
TrackSystemName string KalTest Name of the track fitting system to be used (KalTest, DDKalTest, aidaTT, ... )
UseEventDisplay bool false When using UseIterativeFitting show status of each track fit using CED event display.
UseSIT int 1 Use SIT
UseSimpleAttachHitToTrack bool false Use simple AttachHitToTrack for merging split track segments. (default is false for backward compatible)
VTXHitCollectionName string VTXTrackerHits VTX Hit Collection Name
SplitCollectionByLayer libMarlinTrkProcessors.so.2.12.8

split a hit collection based on the layer number of the hits

Parameter Type Default Description
InputCollection string FTDCollection Name of the input collection with hits
OutputCollections StringVec FTD_PIXELCollection 0 1 FTD_STRIPCollection 2 6 Name of the output collection with start and end layer number
TrackSubsetProcessor libMarlinTrkProcessors.so.2.12.8

TrackSubsetProcessor takes tracks from multiple sources and outputs them (or modified versions, or a subset of them) as one track collection.

Parameter Type Default Description
EnergyLossOn bool true Use Energy Loss in Fit
InitialTrackErrorD0 float 1e+06 Value used for the initial d0 variance of the trackfit
InitialTrackErrorOmega float 0.0001 Value used for the initial omega variance of the trackfit
InitialTrackErrorPhi0 float 100 Value used for the initial phi0 variance of the trackfit
InitialTrackErrorTanL float 100 Value used for the initial tanL variance of the trackfit
InitialTrackErrorZ0 float 1e+06 Value used for the initial z0 variance of the trackfit
MaxChi2PerHit double 100 Maximum Chi-squared value allowed when assigning a hit to a track
MultipleScatteringOn bool true Use MultipleScattering in Fit
Omega double 0.75 The parameter omega for the HNN. Controls the influence of the quality indicator.
RemoveShortTracks bool false Remove short tracks from the list that have a longer track sharing the same hits
SmoothOn bool false Smooth All Measurement Sites in Fit
TrackInputCollections StringVec ForwardTracks SiTracks A vector of the input track collections
TrackOutputCollection string SubsetTracks Name of the output track collection
TrackSystemName string KalTest Name of the track fitting system to be used (KalTest, DDKalTest, aidaTT, ... )
TruthTrackFinder libMarlinTrkProcessors.so.2.12.8

TruthTrackFinder builds tracks out of all hits associated to an MC particle

Parameter Type Default Description
FitForward bool false If true fit 'forward' (go forward + smooth back adding last two hits with Kalman FIlter steps), otherwise fit backward
MCParticleCollectionName string MCParticle Name of the MCParticle input collection
SiTrackCollectionName string SiTracks Silicon track Collection Name
SiTrackRelationCollectionName string SiTrackRelations Silicon track particle relation Collection Name
SimTrackerHitRelCollectionNames StringVec VXDTrackerHitRelations Name of TrackerHit SimTrackHit relation collections
TrackerHitCollectionNames StringVec VXDTrackerHits Name of the TrackerHit input collections
UseTruthInPrefit bool false If true use the truth information to initialise the helical prefit, otherwise use prefit by fitting 3 hits
TruthTracker libMarlinTrkProcessors.so.2.12.8

Creates Track Collection from MC Truth. Can handle composite spacepoints as long as they consist of two TrackerHits

Parameter Type Default Description
CreatePrefitUsingMarlinTrk bool false When fitting take track parameters a full pre-fit for the initialisation of the Track Fit
DetectorTypeForDraw int 0 Detector type sent to MarlinCED for drawing
EnergyLossOn bool true Use Energy Loss in Fit
FitDirection int -1 Fit direction: -1: backward [default], +1: forward
FitTracksWithMarlinTrk bool true Fit the Tracks with MarlinTrk, otherwise take track parameters from MCParticle
HelixMaxR float 2000 Max R (mm) Extent for drawing Helix if UseTPCForLimitsOfHelix false
InitialTrackErrorD0 float 1e+06 Value used for the initial d0 variance of the trackfit
InitialTrackErrorOmega float 0.0001 Value used for the initial omega variance of the trackfit
InitialTrackErrorPhi0 float 100 Value used for the initial phi0 variance of the trackfit
InitialTrackErrorTanL float 100 Value used for the initial tanL variance of the trackfit
InitialTrackErrorZ0 float 1e+06 Value used for the initial z0 variance of the trackfit
MCParticleCollectionName string MCParticle Name of the MCParticle input collection
MCpThreshold float 0.1 Transverse Momentum Threshold MC particles which will produce tracks GeV
MaxChi2PerHit double 100 Maximum Chi-squared value allowed when assigning a hit to a track
MultipleScatteringOn bool true Use MultipleScattering in Fit
OutputTrackCollectionName string TruthTracks Name of the output track collection
OutputTrackRelCollection string TruthTracksMCP Name of the MCParticle-Track Relations collection for output tracks
OutputTrackSegmentCollectionName string TruthTrackSegments Name of the output track segment collection
OutputTrackSegmentRelCollection string TruthTrackSegmentsMCP Name of the MCParticle-Track Relations collection for output track segments
SmoothOn bool false Smooth All Mesurement Sites in Fit
TrackSystemName string KalTest Name of the track fitting system to be used (KalTest, DDKalTest, aidaTT, ... )
TrackerHitsInputCollections StringVec VXDTrackerHits SITTrackerHits FTDPixelTrackerHits FTDSpacePointRelations TPCTrackerHits SETTrackerHits Name of the tracker hit input collections
TrackerHitsRelInputCollections StringVec VXDTrackerHitRelations SITTrackerHitRelations FTDPixelTrackerHitRelations FTDSpacePointRelations TPCTrackerHitRelations SETTrackerHitRelations Name of the lcrelation collections, that link the TrackerHits to their SimTrackerHits. Have to be in same order as TrackerHitsInputCollections!!!
UseEventDisplay bool false When using UseIterativeFitting show status of each track fit using CED event display.
UseIterativeFitting bool false Fit the Tracks with MarlinTrk using iterative approach. If 3 consecutive hits fail to be included then the current fit is written out and a new fit started. Use instead of FitTracksWithMarlinTrk.
UseMCParticleParametersFotInitOfFit bool false When fitting take track parameters from MCParticle for the initialisation of the Track Fit
Overlay 7 processors
FPCCDOverlayBX libOverlay.so.0.23.1

Overlays LCGeneVTXPixelHits of background lcio files for many bunch crossings

Parameter Type Default Description
BackgroundFileNames StringVec overlay.slcio Name of the lcio input file(s) with background - assume one file per bunch crossing.
MaxNumberOfEventsPerFile int -1 Max number of events to read from one file - default: -1, i.e. one file per BX.
MergeCollections StringVec VTXPixelHits VTXPixelHits Pairs of collection names with one bx to be overlayed (BG name first)
NumberOfBunchCrossings int 100 Number of bunch crossings [s] - default 100
VTXPixelHits string VTXPixelHits collection of VTX PixelHits
VXDCollection string VXDCollection collection of VXD SimTrackerHits
removeOptionForVTX bool false True: remove VTXPixelhit Collection. False: leave it.
JoinEvents libOverlay.so.0.23.1

Opens an lcio file and adds all collections of the corresponding (run/event-number) events to the current event.

Parameter Type Default Description
ColNamePostFix string _1 post fix appended to all collection names
InputFileName string joinevents.slcio Name of the lcio input file
Overlay libOverlay.so.0.23.1

Opens a second (chain of) lcio file(s) and overlays events...

Parameter Type Default Description
CollectionMap StringVec MCParticle MCParticle Pairs of collection to be merged
ExcludeCollections StringVec List of collections to exclude for merging
InputFileNames StringVec undefined.slcio Name of the lcio input file(s)
NumberOverlayEvents int 0 Overlay each event with this number of background events. (default 0)
expBG double 1 Add additional background events according to a poisson distribution with this expectation value. (non, if parameter not set)
OverlayBX libOverlay.so.0.23.1

Overlays background lcio files for many bunch crossings

Parameter Type Default Description
BackgroundFileNames StringVec overlay.slcio Name of the lcio input file(s) with background - assume one file per bunch crossing.
BunchCrossingTime float 3e-07 time between bunch crossings [s] - default 3.0e-7 (300 ns)
MCParticle string MCParticle collection of MCParticles
MaxBXsTPC int 10 maximum of BXs to be overlayed for the TPC; -1: compute from length and BXtime; default 10
MaxNumberOfEventsPerFile int -1 Max number of events to read from one file - default: -1, i.e. one file per BX.
MergeCollections StringVec mcParticlesBG mcParticles Pairs of collection names with one bx to be overlayed (BG name first)
PhiRotateTPCHits bool false if true, rotate the bg events by a random azimuthal angle - default false
RandomSeed int 42 random seed - default 42
TPCCollections StringVec TPCCollection TPCCollection Pairs of TPC collection names to be overlayed (BG name first)
TPCDriftvelocity float 5e+07 [mm/s] (float) - default 5.0e+7 (5cm/us)
VXDCollection string VXDCollection collection of VXD SimTrackerHits
VXDLayerReadOutTimes FloatVec 50 50 200 200 200 200 readout time per layer in us - default 50. 50. 200. 200. 200. 200
keepPairsMCPinfo bool false keep MCP info for pair bkg particles studies
OverlayEvents libOverlay.so.0.23.1

Merge a number of events in a LCIO file into 1 event

Parameter Type Default Description
MergedCollectionNames StringVec VXDCollection SITCollection SETCollection FTDCollection Name of collections will be merged
OutputFileName string overlayEvent.slcio Name of the lcio output file
OverlayTiming libOverlay.so.0.23.1

Processor to overlay events from the background taking the timing of the subdetectors into account

Parameter Type Default Description
AllowReusingBackgroundFiles bool true If true the same background file can be used for the same event
BackgroundFileNames StringVec Name of the lcio input file(s) with background - assume one file per bunch crossing.
BeamCalCollection_IntegrationTime float 10 Integration time for the BeamCalCollection
Delta_t float 0.5 Time difference between bunches in the bunch train in ns
ETDCollection_Integration_Time float 10 Integration time for the ETDCollection
EcalBarrelCollection_Integration_Time float 10 Integration time for the EcalBarrelCollection / ECalBarrelCollection
EcalBarrelPreShowerCollection_Integration_Time float 10 Integration time for the EcalBarrelPreShowerCollection
EcalEndcapCollection_Integration_Time float 10 Integration time for the EcalEndcapCollection / ECalEndcapCollection
EcalEndcapPreShowerCollection_Integration_Time float 10 Integration time for the EcalEndcapPreShowerCollection
EcalEndcapRingCollection_Integration_Time float 10 Integration time for the EcalEndcapRingCollection
EcalEndcapRingPreShowerCollection_Integration_Time float 10 Integration time for the EcalEndcapRingPreShowerCollection
EcalPlugCollection_Integration_Time float 10 Integration time for the ECalPlugCollection
FTDCollection_Integration_Time float 10 Integration time for the FTDCollection
HcalBarrelRegCollection_Integration_Time float 10 Integration time for the HcalBarrelRegCollection / HCalBarrelCollection
HcalEndCapRingsCollection_Integration_Time float 10 Integration time for the HcalEndCapRingsCollection / HCalRingCollection
HcalEndCapsCollection_Integration_Time float 10 Integration time for the HcalEndCapsCollection / HCalEndcapCollection
InnerTrackerBarrelCollection_Integration_Time float 10 Integration time for the InnerTrackerBarrelCollection
InnerTrackerEndcapCollection_Integration_Time float 10 Integration time for the InnerTrackerEndcapCollection
LHcalCollection_Integration_Time float 10 Integration time for the LHcalCollection
LumiCalCollection_Integration_Time float 10 Integration time for the LumiCalCollection
MCParticleCollectionName string MCParticle The MC Particle Collection Name
MCPhysicsParticleCollectionName string MCPhysicsParticles The output MC Particle Collection Name for the physics event
MuonBarrelCollection_Integration_Time float 10 Integration time for the MuonBarrelCollection / YokeBarrelCollection
MuonEndCapCollection_Integration_Time float 10 Integration time for the MuonEndCapCollection / YokeEndcapCollection
NBunchtrain int 1 Number of bunches in a bunch train
NumberBackground float 1 Number of Background events to overlay - either fixed or Poisson mean
OuterTrackerBarrelCollection_Integration_Time float 10 Integration time for the OuterTrackerBarrelCollection
OuterTrackerEndcapCollection_Integration_Time float 10 Integration time for the OuterTrackerEndcapCollection
PhysicsBX int 1 Number of the Bunch crossing of the physics event
Poisson_random_NOverlay bool false Draw random number of Events to overlay from Poisson distribution with mean value NumberBackground
RandomBx bool false Place the physics event at an random position in the train: overrides PhysicsBX
SETCollection_Integration_Time float 10 Integration time for the SETCollection
SITCollection_Integration_Time float 10 Integration time for the SITCollection
StartBackgroundEventIndex int -1 Which background event to startWith
StartBackgroundFileIndex int -1 Which background file to startWith
Start_Integration_Time float -0.25 Starting integration time. Should be shortly before the BX, but may need to be shifted earlier if the vertex is smeared in time.
TPCCollection_Integration_Time float 10 Integration time for the TPCCollection
TPCDriftvelocity float 0.05 [mm/ns] (float) - default 5.0e-2 (5cm/us)
TPCSpacePointCollection_Integration_Time float 10 Integration time for the TPCSpacePointCollection
VXDCollection_Integration_Time float 10 Integration time for the VXDCollection
VertexBarrelCollection_Integration_Time float 10 Integration time for the VertexBarrelCollection
VertexEndcapCollection_Integration_Time float 10 Integration time for the VertexEndcapCollection
OverlayTimingGeneric libOverlay.so.0.23.1

Processor to overlay events from the background taking the timing of the subdetectors into account

Parameter Type Default Description
AllowReusingBackgroundFiles bool true If true the same background file can be used for the same event
BackgroundFileNames StringVec Name of the lcio input file(s) with background - assume one file per bunch crossing.
Collection_IntegrationTimes StringVec BeamCalCollection 10 Integration times for the Collections
Delta_t float 0.5 Time difference between bunches in the bunch train in ns
MCParticleCollectionName string MCParticle The MC Particle Collection Name
MCPhysicsParticleCollectionName string MCPhysicsParticles The output MC Particle Collection Name for the physics event
NBunchtrain int 1 Number of bunches in a bunch train
NumberBackground float 1 Number of Background events to overlay - either fixed or Poisson mean
PhysicsBX int 1 Number of the Bunch crossing of the physics event
Poisson_random_NOverlay bool false Draw random number of Events to overlay from Poisson distribution with mean value NumberBackground
RandomBx bool false Place the physics event at an random position in the train: overrides PhysicsBX
StartBackgroundEventIndex int -1 Which background event to startWith
StartBackgroundFileIndex int -1 Which background file to startWith
Start_Integration_Time float -0.25 Starting integration time. Should be shortly before the BX, but may need to be shifted earlier if the vertex is smeared in time.
TPCDriftvelocity float 0.05 [mm/ns] (float) - default 5.0e-2 (5cm/us)
fcalclusterer 4 processors
BeamCalClusterReco libFCalClusterer.so

BeamCalClusterReco reproduces the beamstrahlung background for a given number of bunch-crossings NumberOfBX and puts the signal hits from the lcio input file on top of that, and then clustering is attempted.

Parameter Type Default Description
BackgroundMethod string Gaussian How to estimate background [Gaussian, Parametrised, Pregenerated, Averaged, Empty]
BeamCalCollectionName string BeamCalCollection Name of BeamCal Collection
BeamCalHitsOutCollection string BeamCal_Hits Collection of CalorimeterHits from the BeamCal,only created when input are SimCalorimeterHits
CreateEfficiencyFile bool false Flag to create the TEfficiency for fast tagging library
DetectorName string BeamCal The Name of the Detector the reconstruction is for
DetectorStartingLayerID int 1 The ID of the first layer of the detector BeamCal 1: LumiCal: 0
ETCluster FloatVec 3 2 1 Energy in a Cluster to consider it an electron
ETPad FloatVec 0.5 0.3 0.2 Energy in a Pad, after subtraction of background required to consider it for signal
EfficiencyFilename string TaggingEfficiency.root The name of the rootFile which will contain the TEfficiency objects
InputFileBackgrounds StringVec BeamCal.root Root Inputfile(s)
LinearCalibrationFactor double 1 Multiply deposit energy by this factor to account for sampling fraction
LogWeightingConstant double -1 Weighting constant to use in logarithmic weighting of hits, if negative energy weighting is used
MCParticleCollectionName string MCParticle MCParticle Collection Name, only needed and used to estimate efficiencies
MaxPadDistance double 1e+10 Maximum Distance between primary tower and neighbours to put into one cluster
MinimumTowerSize int 4 Minimum number of pads in a single tower to be considered for signal
NShowerCountingLayers int 3 How many layers are used for shower fitting
NumberOfBX int 1 Number of Bunch Crossings of Background
PrintThisEvent int -1 Number of Event that should be printed to PDF File
ReadoutName string The Name of the DD4hep Readout belonging to the Detector the reconstruction is for, by default the name of the input collection
RecoClusterCollectionname string BCalClusters Name of the Reconstructed Cluster collection
RecoParticleCollectionname string BCalRecoParticle Name of the Reconstructed Particle collection
SigmaCut double 1 If not using ConstPadCuts, each pad SigmaCut*standardDeviation is considered for clusters
StartLookingInLayer int 10 Layer (inclusive) from which on we start looking for signal clusters
StartingRing FloatVec 0 1 2 Rings from which onwards the outside Thresholds are used
SubClusterEnergyID int 5 The ID where the SubClusterEnergy will be added: LumiCal=3, BeamCal=5 in DDPFOCreator.hh
TowerChi2ndfLimit double 5 Limit on square norm of tower energy chi2/ndf, where chi2 = (E_dep - E_bg)^2/sig^2. Reasonable value for pregenerated bkg is 5., for parametrised is 2.
UseChi2Selection bool false Use Chi2 selection criteria to detect high energy electron in the signal.
UseConstPadCuts bool true Use the cuts for the pads specified in ETPad. If false, the standard deviation of each pad times the SigmaCut Factor is used, the first entry in ETPad is used as a minimum energy to consider a pad at all
DrawBeamCalFromDD4hep libFCalClusterer.so

DrawBeamCalFromDD4hep draws segmentation from dd4hep with energy deposits in the lcio files

Parameter Type Default Description
BeamCalCollectionName string BeamCalCollection Name of BeamCal Collection
DrawDensities bool false Option to draw area density of deposited energy rather than deposited energy per cell. Meaningful for polar segmentation. Default false.
OutputFileBackground string BeamCal.root Root OutputFile
MarlinLumiCalClusterer libFCalClusterer.so

Reconstruction of clusters in the LumiCal detector

Parameter Type Default Description
ClusterMinNumHits int 15 Minimal number of hits in cluster
CutOnFiducuialVolume bool false Whether to cut clusters outside of the fiducial volume or not
ElementsPercentInShowerPeakLayer double 0.03 BP: Not sure what it is
EnergyCalibConst double 0.0105 Calibration const E_dep = EnergyCalibConst*E_primary ( default for LCal ILD)
LogWeigthConstant double 6 Sets minimum for logarithmic energy weights
LumiCal_Clusters string LumiCalClusters Collection of Cluster found in the LumiCal
LumiCal_Collection string LumiCalCollection Collection Containing Hits in the LumiCal
LumiCal_Hits string LumiCalHits Collection of CalorimtersHits from the LumiCal
LumiCal_RecoParticles string LumiCalRecoParticles Collection of Reconstructed Particles found in the LumiCal
MaxRecordNumber int 10 Number of event to work with
MemoryResidentTree int 0 Place for ROOT tree memory(1) or disk(0)
MiddleEnergyHitBoundFrac double 0.01 BP: see explanation in LumiCalClusterer.cpp
MinClusterEngy double 2 Sets minimum energy deposit for cluster to be accepted [GeV]
MinHitEnergy double 5e-06 Hit energy cut [Mev]
MoliereRadius double 16 Moliere radius, controls clusters separation distance [mm]
NumEventsTree int 500 Number of events in memory resident ROOT tree.
NumOfNearNeighbor int 6 Number of neighbor hits to consider
OutDirName string rootOut Name of output directory
OutRootFileName string Name of output ROOT file ( without suffix) NO DEFAULT. If no name provided root file will not be generated
SkipNEvents int 0 Number of events to skip at the begining of the LCIO file
WeightingMethod string LogMethod Hit positions weighting method (LogMthod, EnergyMethod )
ZLayerPhiOffset double 3.75 Relative offset of LCal z-layers [deg] default is half of the phi sector size
ReadBeamCal libFCalClusterer.so

ReadBeamCal reads the simulation for the pairs and creates two std::vector<double> in a tree, which can then be used later on for Overlay, calculation of fluctiuations, etc.

Parameter Type Default Description
BeamCalCollectionName string BeamCalCollection Name of BeamCal Collection
DetectorName string BeamCal The Name of the Detector the collections are from
DetectorStartingLayerID int 1 The ID of the first layer of the detector BeamCal 1: LumiCal: 0
OutputFileBackground string BeamCal.root Root OutputFile
ProbabilityFactor double 100 Probability [0,100%] for particle to be added to event. Allows the scaling ofthe background to smaller background rate
lcfiplus 2 processors
LcfiplusProcessor libLCFIPlus.so.0.11.1

Lcfiplus general processor

Parameter Type Default Description
Algorithms StringVec LCFIPlus algorithms to run
BeamSizeX float 0.000639 Bunch size in the X direction [mm]
BeamSizeY float 5.7e-06 Bunch size in the Y direction [mm]
BeamSizeZ float 0.0913 Bunch size in the Z direction [mm]
IgnoreLackOfVertexRP int 0 Keep running even if vertex RP collection is not present
MCPCollection string MC particle collection
MCPFORelation string Relation between MC and PFO particles
MagneticField float 0 Manually set magnetic field, overriding the value from DD4hep [T]
PFOCollection string Particle flow output collection
PIDAlgorithmName string LikelihoodPID ParticleID Algorithm Name
PrintEventNumber int 0 Event number printing period in std output: 0 = no printing
ReadSubdetectorEnergies int 1 Read subdetector energies (ILD)
TrackHitOrdering int 0 Track hit ordering: 0=ILD-LOI (default), 1=ILD-DBD, 2=CLICdet
UpdateVertexRPDaughters int 1 Writing back obtained vertices to input RP collections (which must be writable)
UseMCP int 0 Whether MCParticle collection is imported or not
TrackToPFOConverterProcessor libLCFIPlus.so.0.11.1

Processor to convert track collection into ReconstructedParticle collection

Parameter Type Default Description
InputTrackCollection string InputTracks Input track collection to convert
OutputPFOCollection string ConvertedTrackAsPFO Ouptut collection
marlinmlflavortagging 5 processors
DLJetTaggerProcessor libMarlinMLFlavorTagging.so

DLJetTaggerProcessor offers Jet tagging using a Deep-Learning model

Parameter Type Default Description
ModelScriptFile string dl_jet_tagger_model.pt Torch script file describing the model
PreprocessingParamsFile string dl_jet_tagger_pre_proc_params.txt File containing the parameters for pre-processing
DeepJetTaggerProcessor libMarlinMLFlavorTagging.so

DeepJetTaggerProcessor offers Jet tagging using the DeepJet Model

Parameter Type Default Description
CollectionPFOs string PandoraPFOs Name of the MCParticle collection
CollectionRefinedJets string RefinedJets Collection of refinded jets
CollectionRefinedVertices string RefinedVertex Name of the MCParticle collection
DeepJetFeatures_Charged StringVec Features for DeepJet : Charged jet constituents
DeepJetFeatures_Jets StringVec Features for DeepJet : Jets
DeepJetFeatures_Neutral StringVec Features for DeepJet : Neutral jet constituents
DeepJetFeatures_SV StringVec Features for DeepJet : Secondary Vertices
MeanChargedFeatures FloatVec Mean : Charged features
MeanJetFeatures FloatVec Mean : Jet features
MeanNeutralFeatures FloatVec Mean : Neutral features
MeanSVFeatures FloatVec Mean : SV features
ModelScriptFile string dl_jet_tagger_model.pt Torch script file describing the model
PreprocessingParamsFile string dl_jet_tagger_pre_proc_params.txt File containing the parameters for pre-processing
StdChargedFeatures FloatVec Std : Charged features
StdJetFeatures FloatVec Std : Jet features
StdNeutralFeatures FloatVec Std : Neutral features
StdSVFeatures FloatVec Std : SV features
ParticleNetTaggerProcessor libMarlinMLFlavorTagging.so

ParticleNetTaggerProcessor offers Jet tagging using a ParticleNet model

Parameter Type Default Description
CollectionPFOs string PandoraPFOs Name of the MCParticle collection
CollectionRefinedJets string RefinedJets Collection of refinded jets
CollectionRefinedVertices string RefinedVertex Name of the MCParticle collection
MeanPFFeatures FloatVec Mean : PF features
MeanSVFeatures FloatVec Mean : SV features
ModelScriptFile string dl_jet_tagger_model.pt Torch script file describing the model
ParticleNetFeatures_PFFeatures StringVec Features for ParticleNet : PF features
ParticleNetFeatures_PFPoints StringVec Features for ParticleNet : PF points
ParticleNetFeatures_SVFeatures StringVec Features for ParticleNet : SV features
ParticleNetFeatures_SVPoints StringVec Features for ParticleNet : SV points
PreprocessingParamsFile string dl_jet_tagger_pre_proc_params.txt File containing the parameters for pre-processing
StdPFFeatures FloatVec Std : PF features
StdSVFeatures FloatVec Std : SV features
ReadBTaggingVariables libMarlinMLFlavorTagging.so

ReadBTaggingVariables does whatever it does ...

Parameter Type Default Description
CollectionPFOs string PandoraPFOs Name of the MCParticle collection
CollectionRefinedJets string RefinedJets Name of the MCParticle collection
HeavyFlavorTagger string HeavyFlavorTagger Name of heavy flavor tagger
StoreVariablesForDeepMLFlavorTagger libMarlinMLFlavorTagging.so

StoreVariablesForDeepMLFlavorTagger

Parameter Type Default Description
CPIDName string TMVA_BDT_MC_12bins_singleP Name of the CPID PID entry
CollectionPFOs string PandoraPFOs Name of the MCParticle collection
CollectionPrimaryVertex string PrimaryVertex_NewVtx Name of the MCParticle collection
CollectionRefinedJets string RefinedJets Name of the MCParticle collection
CollectionRefinedVertices string RefinedVertex Name of the MCParticle collection
D0ProbFileName string D0ProbFileName Name of d0 probability file
DeepJetFeatures_Charged StringVec Features for DeepJet : Charged jet constituents
DeepJetFeatures_Jets StringVec Features for DeepJet : Jets
DeepJetFeatures_Neutral StringVec Features for DeepJet : Neutral jet constituents
DeepJetFeatures_SV StringVec Features for DeepJet : Secondary Vertices
ParticleNetFeatures_PFFeatures StringVec Features for ParticleNet : PF features
ParticleNetFeatures_PFPoints StringVec Features for ParticleNet : PF points
ParticleNetFeatures_SVFeatures StringVec Features for ParticleNet : SV features
ParticleNetFeatures_SVPoints StringVec Features for ParticleNet : SV points
Z0ProbFileName string Z0ProbFileName Name of z0 probability file
dEdxPID string dEdxPID dEdxPID or dEdxPIDv2?
pandoraanalysis 2 processors
PandoraPFACalibrator libPandoraAnalysis.so.2.0.1

PandoraPFACalibrator for calibration of PandoraPFA

Parameter Type Default Description
BCALcollections StringVec Name of the BCAL collection used to form clusters
ECALBarrelcollections StringVec Name of the ECAL barrel collection used to form clusters
ECALEndCapcollections StringVec Name of the ECAL EndCap collection used to form clusters
ECalToEMGeVCalibration float 1 Calibration from deposited ECAL to EM energy
ECalToHadGeVCalibrationBarrel float 1 Calibration from deposited ECAL barrel to Hadronic energy
ECalToHadGeVCalibrationEndCap float 1 Calibration from deposited ECAL endcap to Hadronic energy
ECalToMipCalibration float 1 Calibration from deposited ECAL energy to MIP
HCALcollections StringVec Name of the HCAL collection used to form clusters
HCalToEMGeVCalibration float 1 Calibration from deposited HCAL to EM energy
HCalToHadGeVCalibration float 1 Calibration from deposited HCAL to Hadronic energy
HCalToMipCalibration float 1 Calibration from deposited HCAL energy to MIP
InputMCParticleCollections StringVec Names of mc pfo collections
InputParticleCollectionName string PandoraPFANewPFOs Name of reconstructed particle collection
LCALcollections StringVec Name of the LCAL collection used to form clusters
LHCALcollections StringVec Name of the LHCAL collection used to form clusters
MCPfoCollections StringVec Names of mc pfo collections
MUONcollections StringVec Name of the MUON collection used to form clusters
MaxHCalHitHadronicEnergy float 10000 The maximum hadronic energy allowed for a single hcal hit
MuonToMipCalibration float 1 Calibration from deposited MUON energy to MIP
ReconstructedPfoCollections StringVec Names of reconstructed particle collections
RootFile string PandoraPFACalibrator.root Output root file name
PfoAnalysis libPandoraAnalysis.so.2.0.1

PfoAnalysis analyses output of PandoraPFANew

Parameter Type Default Description
BCalCollections StringVec Name of the BCal collection of calo hits used to form clusters
BCalCollectionsSimCaloHit StringVec Name of the BeamCal collection post Mokka, pre digitisation
CollectCalibrationDetails int 0 Whether to collect calibration details
ECalBarrelCollectionsSimCaloHit StringVec Name of the ECal Barrel collection post Mokka, pre digitisation
ECalCollections StringVec Name of the ECal collection of calo hits used to form clusters
ECalCollectionsSimCaloHit StringVec Name of the ECal collection post Mokka, pre digitisation
ECalEndCapCollectionsSimCaloHit StringVec Name of the ECal EndCap collection post Mokka, pre digitisation
ECalOtherCollectionsSimCaloHit StringVec Name of the ECal Other collection post Mokka, pre digitisation
HCalBarrelCollectionsSimCaloHit StringVec Name of the HCal Barrel collection post Mokka, pre digitisation
HCalCollections StringVec Name of the HCal collection of calo hits used to form clusters
HCalEndCapCollectionsSimCaloHit StringVec Name of the HCal EndCap collection post Mokka, pre digitisation
HCalOtherCollectionsSimCaloHit StringVec Name of the HCal Other collection post Mokka, pre digitisation
LCalCollections StringVec Name of the LCal collection of calo hits used to form clusters
LCalCollectionsSimCaloHit StringVec Name of the LCal collection post Mokka, pre digitisation
LHCalCollections StringVec Name of the LHCal collection of calo hits used to form clusters
LHCalCollectionsSimCaloHit StringVec Name of the LHCal collection post Mokka, pre digitisation
LookForQuarksWithMotherZ int 0 Flag to look for quarks with mother Z
MCParticleCollection string Name of mc particle collections
MCPfoSelectionLowEnergyNPCutOff float 1.2 MC pfo selection neutron and proton low energy cut-off
MCPfoSelectionMomentum float 0.01 MC pfo selection momentum
MCPfoSelectionRadius float 500 MC pfo selection radius
MuonCollections StringVec Name of the Muon collection of calo hits used to form clusters
MuonCollectionsSimCaloHit StringVec Name of the Muon collection post Mokka, pre digitisation
NBinsMuonCaloHitEnergyHist int 500 Number of bins in MuonDirectionCorrectedCaloHitEnergy histogram
PfoCollection string Name of input pfo collection
Printing int 0 Set the debug print level
RootFile string PFOAnalysis.root Name of the output root file
XUpperValueMuonCaloHitEnergyHist float 1 Upper value of x-range of MuonDirectionCorrectedCaloHitEnergy histogram
(unknown) 21 processors
AIDAProcessor

Processor that handles AIDA files. Creates on directory per processor. Processors only need to create and fill the histograms, clouds and tuples. Needs to be the first ActiveProcessor

Parameter Type Default Description
Compress int 1 compression of output file 0: false >0: true (default)
FileName string aida_file filename without extension
FileType string root type of output file root (default) or xml )
ConditionsProcessor

ConditionsProcessor provides access to conditions data transparently from LCIO files or a databases, using LCCD

Parameter Type Default Description
DBCondHandler StringVec conditionsName /lccd/myfolder HEAD Initialization of a conditions database handler
DBFileHandler StringVec conditionsName conditions.slcio collectionName Initialization of a conditions db file handler
DBInit string localhost:lccd_test:calvin:hobbes Initialization string for conditions database
DataFileHandler StringVec conditionsName Initialization of a data file handler
SimpleFileHandler StringVec conditionsName conditions.slcio collectionName Initialization of a simple conditions file handler
ConvertToMIPScale

transforms the energy amplitude of each calorimeter hit passing the cut into the MIP scale

Parameter Type Default Description
CutECAL float 0 Cut in MIPs on the amplitudes in the ECAL collection
CutHCAL float 0 Cut in MIPs on the amplitudes in the HCAL collection
ECALInputCollectionName string ECAL ECAL Input Collection Name
ECALOutputCollectionName string ECAL_MIP ECAL Output Collection Name, stores calorimeter hits with amplitudes in MIP energy scale
HCALInputCollectionName string HCAL HCAL Input Collection Name
HCALOutputCollectionName string HCAL_MIP HCAL Output Collection Name, stores calorimeter hits with amplitudes in MIP energy scale
MIPCoeffEcal FloatVec 1 1 Coefficients for the MIP calibration in the ECAL in GeV/MIP
MIPCoeffHcal FloatVec 1 Coefficients for the MIP calibration in the HCAL in GeV/MIP
CutOnCosThetaQQbar

The output condition of this processor is false as long as the |cos(theta)| > cutCosTheta and true otherwise.

Parameter Type Default Description
cutCosTheta double 1 cut on |cos(theta)|
CutOnGEANT4Bug

The output condition of this processor is true as long as no track has more than a factor of k more energy deposited in the calorimeter as its energy given by momentum and mass. This should cut out events where GEANT4 produces additional energy depositions. If at least one such a track is found the return value is false. Only tracks with an energy larger than eMin are taken into account.

Parameter Type Default Description
calibrCoeffECAL FloatVec 33.0235 93.5682 Calibration coefficients for ECAL
calibrCoeffHCAL FloatVec 21.1963 Calibration coefficients for HCAL
colNameRelationCaloHitToSimCaloHit string RelationCaloHit name of the LC Relation collection between Calorimeterhits and SimCalorimeterhits
colNameRelationTrackToMCP string TrueTrackToMCP name of the LC Relation collection between Tracks and MC particles
colNameTracks string Tracks name of the Track collection
eMin double 5 minimal energy of tracks taken into account (in GeV)
k double 1.75 if the track has more than k times its MC energy deposited the return value is set to false
DrawMCParticles

DrawMCParticles draws the MC Particle prediction w/o calorimeters in the ced display

Parameter Type Default Description
EnergyCut double 0.01 Energy Cut in GeV
MCCollectionName string MCParticle Name of the MCParticle collection
WaitForKeyboard int 1 Wait for Keyboard before proceed
rIn double 15.5 Radius of the innermost detector component (VTX) in cylindrical coordinates
zIn double 50 z coordinate of the innermost detector component (VTX) in cylindrical coordinates
EventSelector

EventSelector returns true if given event was specified in EventList

Parameter Type Default Description
EventList IntVec event list - pairs of Eventnumber RunNumber
LCIOOutputProcessor

Writes the current event to the specified LCIO outputfile. Needs to be the last ActiveProcessor.

Parameter Type Default Description
CompressionLevel int 6 The ZLIB compression level on writing. Set it to 0 for no compression
DropCollectionNames StringVec TPCHits HCalHits drops the named collections from the event
DropCollectionTypes StringVec SimTrackerHit SimCalorimeterHit drops all collections of the given type from the event
FullSubsetCollections StringVec MCParticlesSkimmed write complete objects in subset collections to the file (i.e. ignore subset flag)
KeepCollectionNames StringVec MyPreciousSimTrackerHits force keep of the named collections - overrules DropCollectionTypes (and DropCollectionNames)
LCIOOutputFile string outputfile.slcio name of output file
LCIOWriteMode string None write mode for output file: WRITE_APPEND, WRITE_NEW or None
SplitFileSizekB int 1992294 will split output file if size in kB exceeds given value - doesn't work with APPEND and NEW
MemoryMonitor

Simple processor to print out the memory consumption at defined intervals

Parameter Type Default Description
howOften int 1 Print Event Number Every N Events
PGDBP

Physical and Geometrical Database (for Boojum at least)

No parameters available.
PatchCollections

add missing collections to the event - either parsed from inputfiles or as given in PatchCollections

Parameter Type Default Description
ParseFiles bool false if true, all inputfiles are parsed for missing collections on init
PatchCollections StringVec BcalCollection SimCalorimeterHit list of collections to patch - pairs of CollectionName CollectionType
SelectEvents

SelectEvent Processor selects certain events from input files

Parameter Type Default Description
FirstEvent int 0 First Event
LastEvent int 0 Last Event
SelectNthEventsProcessor

SelectNthEventsProcessor Processor sets ReturnValue true for every nth event. The selection can be offset and/or inverted.

Parameter Type Default Description
InvertSelection bool false Inverts the ReturnValue; if true, every nth event's ReturnValue is false, all others are true; default: false
SelectionOffset int 0 Sets an offset m, so the Return Value of the mth event (and every nth before and after it) is set to true; default: 0
nEventToSelect int 1 Integer number n, every nth event's ReturnValue is set to true; default: 1
SimpleFastMCProcessor

SimpleFastMCProcessor creates ReconstrcutedParticles from MCParticles according to the resolution given in the steering file.

Parameter Type Default Description
ChargedResolution FloatVec 5e-05 0 1.5708 Resolution of charged particles in polar angle range: d(1/P) th_min th_max
InputCollectionName string MCParticle Name of the MCParticle input collection
MCTruthMappingCollectionName string MCTruthMapping Name of the MCTruthMapping output collection
MomentumCut float 0.001 No reconstructed particles are produced for smaller momenta (in [GeV])
NeutralHadronResolution FloatVec 0.04 0.5 0 1.5708 Resolution dE/E=A+B/sqrt(E/GeV) of neutral hadrons in polar angle range: A B th_min th_max
PhotonResolution FloatVec 0.01 0.1 0 1.5708 Resolution dE/E=A+B/sqrt(E/GeV) of photons in polar angle range: A B th_min th_max
RecoParticleCollectionName string ReconstructedParticles Name of the ReconstructedParticles output collection
SimpleTimer

MARLIN Processor 'SimpleTimer', offers simple timer utilities

Parameter Type Default Description
Mode int 0 Mode
SecondsToWait int 0 Seconds to Wait
SkipNEvents

The output condition of this processor is false for the first n LCEvents. Afterwards it is set to true.

Parameter Type Default Description
nSkip int 0 number of LCEvents to skip
Statusmonitor

Statusmonitor prints out information on running Marlin Job: Prints number of runs run and current number of the event. Counting is sequential and not the run or event ID.

Parameter Type Default Description
HowOften int 10000 Print the event number every N events
StdHepReader

Reads StdHep files as input and creates LCIO events with MCParticle collections. Make sure to not specify any LCIOInputFiles in the steering in order to read StdHep files.

Parameter Type Default Description
StdHepFileName string input.stdhep input file
TestProcessor

Simple processor to test the marlin application. Prints run and event number.

No parameters available.
garlicCutCalculator

GarlicClusterPropertiesProcessor makes histograms of EM shower properties

Parameter Type Default Description
hitFraction float 0.9 cluster parameters for this fraction of hits
maxCosth float 0.98 max costh to consider
maxDistPull float 10 maximum distance to pull cluster by one hit
outputFile string photonClusters.root name of file in which to save clustering histograms
validationPreProcessor

validatePilotProcessor gets names of simhit collections and ranges of parameters

Parameter Type Default Description
outputParamFilename string BLAH name of output parameter file