org.hps.recon.particle

Class HpsReconParticleDriver

java.lang.Object

org.lcsim.util.Driver

org.hps.recon.particle.ReconParticleDriver

org.hps.recon.particle.HpsReconParticleDriver

public class HpsReconParticleDriver
extends ReconParticleDriver

The main HPS implementation of ReconParticleDriver. Method generates V0 candidates and does vertex fits.

Author:

Omar Moreno

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	HpsReconParticleDriver.Constraint Represents a type of constraint for vertex fitting.

Nested classes/interfaces inherited from class org.lcsim.util.Driver

org.lcsim.util.Driver.AbortRunException, org.lcsim.util.Driver.NextEventException

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	_patchVertexTrackParameters
private boolean	_storeCovTrkMomList
protected List<org.lcsim.event.ReconstructedParticle>	beamConMollerCandidates Stores reconstructed Moller candidate particles generated with beam spot constraints.
protected String	beamConMollerCandidatesColName LCIO collection name for Moller candidate particles generated with beam spot constraints.
protected List<org.lcsim.event.Vertex>	beamConMollerVertices Stores reconstructed Moller candidate vertices generated with beam spot constraints.
protected String	beamConMollerVerticesColName LCIO collection name for Moller candidate vertices generated with beam spot constraints.
private Map<Integer,double[]>	beamPositionMap
private double[]	beamPositionToUse
private static int[]	DOF
private boolean	includeUnmatchedTracksInFSP
private boolean	makeConversionCols
private boolean	makeMollerCols
protected List<org.lcsim.event.ReconstructedParticle>	targetConMollerCandidates Stores reconstructed Moller candidate particles generated with target constraints.
protected String	targetConMollerCandidatesColName LCIO collection name for Moller candidate particles generated with target constraints.
protected List<org.lcsim.event.Vertex>	targetConMollerVertices Stores reconstructed Moller candidate vertices generated with target constraints.
protected String	targetConMollerVerticesColName LCIO collection name for Moller candidate vertices generated with target constraints.
protected List<org.lcsim.event.ReconstructedParticle>	unconstrainedMollerCandidates Stores reconstructed Moller candidate particles generated without constraints.
protected String	unconstrainedMollerCandidatesColName LCIO collection name for Moller candidate particles generated without constraints.
protected List<org.lcsim.event.Vertex>	unconstrainedMollerVertices Stores reconstructed Moller candidate vertices generated without constraints.
protected String	unconstrainedMollerVerticesColName LCIO collection name for Moller candidate vertices generated without constraints.
protected List<org.lcsim.event.ReconstructedParticle>	unconstrainedVcCandidates
protected String	unconstrainedVcCandidatesColName
protected List<org.lcsim.event.Vertex>	unconstrainedVcVertices
protected String	unconstrainedVcVerticesColName
private boolean	useInternalVertexXYPositions

Fields inherited from class org.hps.recon.particle.ReconParticleDriver

beamConV0Candidates, beamConV0CandidatesColName, beamConV0Vertices, beamConV0VerticesColName, beamEnergy, beamPosition, beamSize, bField, cuts, debug, ecal, ELECTRON, enableTrackClusterMatchPlots, finalStateParticles, hitToRotated, hitToStrips, isMC, isMonteCarlo, matcher, MOLLER_BOT, MOLLER_TOP, POSITRON, targetConV0Candidates, targetConV0CandidatesColName, targetConV0Vertices, targetConV0VerticesColName, trackCollectionNames, unconstrainedV0Candidates, unconstrainedV0CandidatesColName, unconstrainedV0Vertices, unconstrainedV0VerticesColName, useCorrectedClusterPositionsForMatching

Fields inherited from class org.lcsim.util.Driver

HLEVEL_DEFAULT, HLEVEL_FULL, HLEVEL_HIGH, HLEVEL_NORMAL, HLEVEL_OFF

Constructor Summary

Constructors

Constructor and Description
HpsReconParticleDriver()

Method Summary

Modifier and Type	Method and Description
void	findMollers(List<org.lcsim.event.ReconstructedParticle> electrons)
void	findV0s(List<org.lcsim.event.ReconstructedParticle> electrons, List<org.lcsim.event.ReconstructedParticle> positrons)
protected void	findVertices(List<org.lcsim.event.ReconstructedParticle> electrons, List<org.lcsim.event.ReconstructedParticle> positrons) Creates reconstructed V0 candidate particles and vertices for electron positron pairs using no constraints, beam constraints, and target constraints.
private BilliorVertex	fitVertex(HpsReconParticleDriver.Constraint constraint, org.lcsim.event.ReconstructedParticle electron, org.lcsim.event.ReconstructedParticle positron) Fits a vertex from an electron/positron track pair using the indicated constraint.
private double	invMass(Hep3Vector p1, Hep3Vector p2)
private void	makeMollerCandidates(org.lcsim.event.ReconstructedParticle topElectron, org.lcsim.event.ReconstructedParticle botElectron)
static org.lcsim.event.ReconstructedParticle	makeReconstructedParticle(org.lcsim.event.ReconstructedParticle electron, org.lcsim.event.ReconstructedParticle positron, BilliorVertex vtxFit) Creates a reconstructed V0 candidate particle from an electron, positron, and billior vertex.
private void	makeV0Candidates(org.lcsim.event.ReconstructedParticle electron, org.lcsim.event.ReconstructedParticle positron)
protected List<org.lcsim.event.ReconstructedParticle>	particleCuts(List<org.lcsim.event.ReconstructedParticle> finalStateParticles)
private void	patchVertex(BilliorVertex v)
protected void	process(org.lcsim.event.EventHeader event) Processes the track and cluster collections in the event into reconstructed particles and V0 candidate particles and vertices.
void	setIncludeUnmatchedTracksInFSP(boolean setUMTrks)
void	setMakeConversionCols(boolean input)
void	setMakeMollerCols(boolean input)
void	setMaxMollerP(double input)
void	setMaxVertexClusterDt(double input)
void	setMaxVertexP(double input)
void	setMinMollerChisqProb(double input)
void	setMinMollerP(double input)
void	setMinVertexChisqProb(double input)
void	setPatchVertexTrackParameters(boolean b)
void	setStoreVertexCovars(boolean input)
void	setUseInternalVertexXYPositions(boolean b)
private List<BilliorTrack>	shiftTracksToVertex(List<org.lcsim.event.ReconstructedParticle> particles, Hep3Vector vtxPos)
protected void	startOfData() Sets the default LCIO collection names if they are not already defined previously.
private BilliorTrack	toBilliorTrack(org.lcsim.event.Track track) Converts a Track object to a BilliorTrack object.
private BilliorTrack	toBilliorTrack(org.lcsim.event.TrackState trackstate) Converts a TrackState object to a BilliorTrack object.

Methods inherited from class org.hps.recon.particle.ReconParticleDriver

detectorChanged, endOfData, makeReconstructedParticles, printDebug, setBeamConV0CandidatesColName, setBeamConV0VerticesColName, setBeamPositionX, setBeamPositionY, setBeamPositionZ, setBeamSigmaX, setBeamSigmaY, setDebug, setDisablePID, setEcalClusterCollectionName, setFinalStateParticlesColName, setIsMC, setMaxElectronP, setMaxMatchChisq, setMaxMatchDt, setNSigmaPositionMatch, setOtherElectronsColName, setSnapToEdge, setTargetConV0CandidatesColName, setTargetConV0VerticesColName, setTrackClusterMatchPlots, setTrackClusterTimeOffset, setTrackCollectionName, setTrackCollectionNames, setUnconstrainedV0CandidatesColName, setUnconstrainedV0VerticesColName, setUseCorrectedClusterPositionsForMatching

Methods inherited from class org.lcsim.util.Driver

add, clearStatistics, contains, drivers, getConditionsManager, getHistogramLevel, getLogger, getName, getRandom, printStatistics, processChildren, remove, resume, setHistogramLevel, setLogLevel, setRandom, suspend

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

unconstrainedMollerCandidatesColName

protected String unconstrainedMollerCandidatesColName

LCIO collection name for Moller candidate particles generated without constraints.

beamConMollerCandidatesColName

protected String beamConMollerCandidatesColName

LCIO collection name for Moller candidate particles generated with beam spot constraints.

targetConMollerCandidatesColName

protected String targetConMollerCandidatesColName

LCIO collection name for Moller candidate particles generated with target constraints.

unconstrainedMollerVerticesColName

protected String unconstrainedMollerVerticesColName

LCIO collection name for Moller candidate vertices generated without constraints.

beamConMollerVerticesColName

protected String beamConMollerVerticesColName

LCIO collection name for Moller candidate vertices generated with beam spot constraints.

targetConMollerVerticesColName

protected String targetConMollerVerticesColName

LCIO collection name for Moller candidate vertices generated with target constraints.

unconstrainedMollerCandidates

protected List<org.lcsim.event.ReconstructedParticle> unconstrainedMollerCandidates

Stores reconstructed Moller candidate particles generated without constraints.

beamConMollerCandidates

protected List<org.lcsim.event.ReconstructedParticle> beamConMollerCandidates

Stores reconstructed Moller candidate particles generated with beam spot constraints.

targetConMollerCandidates

protected List<org.lcsim.event.ReconstructedParticle> targetConMollerCandidates

Stores reconstructed Moller candidate particles generated with target constraints.

unconstrainedMollerVertices

protected List<org.lcsim.event.Vertex> unconstrainedMollerVertices

Stores reconstructed Moller candidate vertices generated without constraints.

beamConMollerVertices

protected List<org.lcsim.event.Vertex> beamConMollerVertices

Stores reconstructed Moller candidate vertices generated with beam spot constraints.

targetConMollerVertices

protected List<org.lcsim.event.Vertex> targetConMollerVertices

Stores reconstructed Moller candidate vertices generated with target constraints.

unconstrainedVcCandidatesColName

protected String unconstrainedVcCandidatesColName

unconstrainedVcVerticesColName

protected String unconstrainedVcVerticesColName

unconstrainedVcCandidates

protected List<org.lcsim.event.ReconstructedParticle> unconstrainedVcCandidates

unconstrainedVcVertices

protected List<org.lcsim.event.Vertex> unconstrainedVcVertices

makeConversionCols

private boolean makeConversionCols

makeMollerCols

private boolean makeMollerCols

includeUnmatchedTracksInFSP

private boolean includeUnmatchedTracksInFSP

useInternalVertexXYPositions

private boolean useInternalVertexXYPositions

beamPositionMap

private Map<Integer,double[]> beamPositionMap

beamPositionToUse

private double[] beamPositionToUse

DOF

private static final int[] DOF

_patchVertexTrackParameters

private boolean _patchVertexTrackParameters

_storeCovTrkMomList

private boolean _storeCovTrkMomList

Constructor Detail

HpsReconParticleDriver

public HpsReconParticleDriver()

Method Detail

setMaxMollerP

public void setMaxMollerP(double input)

setMinMollerP

public void setMinMollerP(double input)

setMaxVertexClusterDt

public void setMaxVertexClusterDt(double input)

setMaxVertexP

public void setMaxVertexP(double input)

setMinMollerChisqProb

public void setMinMollerChisqProb(double input)

setMinVertexChisqProb

public void setMinVertexChisqProb(double input)

setIncludeUnmatchedTracksInFSP

public void setIncludeUnmatchedTracksInFSP(boolean setUMTrks)

setUseInternalVertexXYPositions

public void setUseInternalVertexXYPositions(boolean b)

process

protected void process(org.lcsim.event.EventHeader event)

Processes the track and cluster collections in the event into reconstructed particles and V0 candidate particles and vertices. These reconstructed particles are then stored in the event.

Overrides:

process in class ReconParticleDriver

Parameters:

event - - The event to process.

setMakeConversionCols

public void setMakeConversionCols(boolean input)

setMakeMollerCols

public void setMakeMollerCols(boolean input)

setStoreVertexCovars

public void setStoreVertexCovars(boolean input)

particleCuts

protected List<org.lcsim.event.ReconstructedParticle> particleCuts(List<org.lcsim.event.ReconstructedParticle> finalStateParticles)

Specified by:

particleCuts in class ReconParticleDriver

findV0s

public void findV0s(List<org.lcsim.event.ReconstructedParticle> electrons,
                    List<org.lcsim.event.ReconstructedParticle> positrons)

findMollers

public void findMollers(List<org.lcsim.event.ReconstructedParticle> electrons)

findVertices

protected void findVertices(List<org.lcsim.event.ReconstructedParticle> electrons,
                            List<org.lcsim.event.ReconstructedParticle> positrons)

Creates reconstructed V0 candidate particles and vertices for electron positron pairs using no constraints, beam constraints, and target constraints. These are saved to the appropriate lists in the super class.

Specified by:

findVertices in class ReconParticleDriver

Parameters:

electrons - - The list of electrons.

positrons - - The list of positrons.

startOfData

protected void startOfData()

Sets the default LCIO collection names if they are not already defined previously.

Overrides:

startOfData in class ReconParticleDriver

fitVertex

private BilliorVertex fitVertex(HpsReconParticleDriver.Constraint constraint,
                                org.lcsim.event.ReconstructedParticle electron,
                                org.lcsim.event.ReconstructedParticle positron)

Fits a vertex from an electron/positron track pair using the indicated constraint.

Parameters:

constraint - - The constraint type to use.

electron - - The electron track.

positron - - The positron track.

Returns:

Returns the reconstructed vertex as a BilliorVertex object. mg--8/14/17--add the displaced vertex refit for the UNCONSTRAINED and BS_CONSTRAINED fits

makeV0Candidates

private void makeV0Candidates(org.lcsim.event.ReconstructedParticle electron,
                              org.lcsim.event.ReconstructedParticle positron)

makeMollerCandidates

private void makeMollerCandidates(org.lcsim.event.ReconstructedParticle topElectron,
                                  org.lcsim.event.ReconstructedParticle botElectron)

makeReconstructedParticle

public static org.lcsim.event.ReconstructedParticle makeReconstructedParticle(org.lcsim.event.ReconstructedParticle electron,
                                                                              org.lcsim.event.ReconstructedParticle positron,
                                                                              BilliorVertex vtxFit)

Creates a reconstructed V0 candidate particle from an electron, positron, and billior vertex.

Parameters:

electron - - The electron.

positron - - The positron.

vtxFit - - The billior vertex.

Returns:

Returns a reconstructed particle with properties generated from the child particles and vertex given as an argument.

toBilliorTrack

private BilliorTrack toBilliorTrack(org.lcsim.event.Track track)

Converts a Track object to a BilliorTrack object.

Parameters:

track - - The original track.

Returns:

Returns the original track as a BilliorTrack object.

toBilliorTrack

private BilliorTrack toBilliorTrack(org.lcsim.event.TrackState trackstate)

Converts a TrackState object to a BilliorTrack object.

Parameters:

track - - The original track state

Returns:

Returns the original track as a BilliorTrack object.

setPatchVertexTrackParameters

public void setPatchVertexTrackParameters(boolean b)

patchVertex

private void patchVertex(BilliorVertex v)

invMass

private double invMass(Hep3Vector p1,
                       Hep3Vector p2)

shiftTracksToVertex

private List<BilliorTrack> shiftTracksToVertex(List<org.lcsim.event.ReconstructedParticle> particles,
                                               Hep3Vector vtxPos)