Functions
Point	CaloTwoThreshShowerStartingPoint (const CaloHits &caloHits, const Line &showerAxis, const CaloGeoParams &caloGeoParams, float thr1, float thr2, float radius, float distSecond, float threshold=0.0f)
	Compute the shower starting point using a two-threshold algorithm. More...

float	CaloLocalEnergy (const CaloHits &hits, const Line &line, const CaloGeoParams &geoParams, float radius, float innerRadius=0, Point refPoint=defaultValue< Point >, float startPos=std::numeric_limits< float >::lowest(), float endPos=std::numeric_limits< float >::max(), float threshold=0.0f)
	Computes the energy deposit around the given line. More...

float	CaloLongitudinalMoment (unsigned int order, const CaloHits &hits, const Vec3D &dir, const Point &refPoint, const CaloGeoParams &geoParams, float threshold=0.0f)
	Computes the logitudinal moment of the CALO hits distribution. More...

float	CaloLateralMoment (unsigned int order, const CaloHits &hits, const Line &dir, const CaloGeoParams &geoParams, float threshold=0.0f)
	Computes the lateral moment of the CALO hits distribution. More...

BinnedProfile< float >	CaloSignalLongitudinalProfile (const CaloHits &hits, const Line &line, const CaloGeoParams &geoParams, float maxRadius, float longitudinalDistStep, float threshold=0.0f)
	Computes the longitudinal profile of the CALO energy deposit distribution. More...

BinnedProfile< float >	CaloLateralMomentLongitudinalProfile (const CaloHits &hits, const Line &line, const CaloGeoParams &geoParams, float maxRadius, float longitudinalDistStep, float momentOrder, float threshold=0.0f)
	Calculate the longitudinal profile of the lateral momenta according to user defined longitudinal step. More...

Function Documentation

◆ CaloLateralMoment()

float Herd::Reconstruction::CaloLateralMoment	(	unsigned int	order,
		const CaloHits &	hits,
		const Line &	dir,
		const CaloGeoParams &	geoParams,
		float	threshold = `0.0f`
	)

Computes the lateral moment of the CALO hits distribution.

This routine computes the moment of the CALO hits 3D distribution along the given direction, referring the position of each cube to the given reference point. A threshold is applied to the CALO hits.

Parameters

order	The order of the moment.
hits	The CALO hits.
dir	The direction along which the momenta are computed.
geoParams	The CALO geometric parameters.
threshold	The threshold for the single cube energy deposit.

◆ CaloLateralMomentLongitudinalProfile()

BinnedProfile< float > Herd::Reconstruction::CaloLateralMomentLongitudinalProfile	(	const CaloHits &	hits,
		const Line &	line,
		const CaloGeoParams &	geoParams,
		float	maxRadius,
		float	longitudinalDistStep,
		float	momentOrder,
		float	threshold = `0.0f`
	)

Calculate the longitudinal profile of the lateral momenta according to user defined longitudinal step.

Calculate the longitudinal profile of the lateral moment according to user defined longitudinal step, starting from the entrance point in CALO of the given line. The minimum amount of steps required to cover the range spanned starting from the interaction point to the track exit point on the CALO will be guaranteed, meaning that the profile last bin will almost always end outside the calo.

Parameters

hits	The CALO hits.
line	The direction along which the momenta are computed.
geoParams	The CALO geometric parameters.
maxRadius	The maximum distance from axis of the hits considered
longitudinalDistStep	The value of the longitudinal step to be considered
momentOrder	The order or the moment to compute
threshold	The threshold for the single cube energy deposit.

◆ CaloLocalEnergy()

float Herd::Reconstruction::CaloLocalEnergy	(	const CaloHits &	hits,
		const Line &	line,
		const CaloGeoParams &	geoParams,
		float	radius,
		float	innerRadius = `0`,
		Point	refPoint = `defaultValue<Point>`,
		float	startPos = `std::numeric_limits<float>::lowest()`,
		float	endPos = `std::numeric_limits<float>::max()`,
		float	threshold = `0.0f`
	)

Computes the energy deposit around the given line.

This routine computes the energy deposit in a hollow cylinder around a given line. It is possible to specify the minimum and maximum radius, the threshold to apply to the CALO hits, and a point along the line to serve as reference for minimum and maximum longitudinal distances, in order to limit the longitudinal dimension of the cylinder.

Parameters

hits	The CALO hits.
line	The line around which the local energy deposit is computed.
geoParams	The CALO geometric parameters.
radius	The maximum radius of the hollow cylinder (cm).
innerRadius	The minimum radius of the hollow cylinder (cm); set to 0 for a full cylinder.
refPoint	The reference point along the given line.
startPos	The minimum longitudinal coordinate of the cylinder with respect to the refPoint (cm).
endPos	The maximum longitudinal coordinate of the cylinder with respect to the refPoint (cm).
threshold	The threshold to apply to the CALO hits.

Returns: The total energy deposit inside the defined region.

Exceptions

#Exception if a given parameter is not valid (e.g. radius < innerRadius, refPoint not lying on line etc.).

◆ CaloLongitudinalMoment()

float Herd::Reconstruction::CaloLongitudinalMoment	(	unsigned int	order,
		const CaloHits &	hits,
		const Vec3D &	dir,
		const Point &	refPoint,
		const CaloGeoParams &	geoParams,
		float	threshold = `0.0f`
	)

Computes the logitudinal moment of the CALO hits distribution.

This routine computes the moment of the CALO hits 3D distribution along the given direction, referring the position of each cube to the given reference point. A threshold is applied to the CALO hits.

Parameters

order	The order of the moment.
hits	The CALO hits.
dir	The direction along which the momenta are computed.
refPoint	the reference point for the CALO cubes position
geoParams	The CALO geometric parameters.
threshold	The threshold for the single cube energy deposit.

Returns: The momenta of the CALO hits spatial distribution.

◆ CaloSignalLongitudinalProfile()

BinnedProfile< float > Herd::Reconstruction::CaloSignalLongitudinalProfile	(	const CaloHits &	hits,
		const Line &	line,
		const CaloGeoParams &	geoParams,
		float	maxRadius,
		float	longitudinalDistStep,
		float	threshold = `0.0f`
	)

Computes the longitudinal profile of the CALO energy deposit distribution.

Calculate the longitudinal profile of the energy deposit according to user defined longitudinal step, starting from the entrance point in CALO of the given line. The minimum amount of steps required to cover the range spanned starting from the interaction point to the track exit point on the CALO will be guaranteed, meaning that the profile last bin will almost always end outside the calo.

Parameters

hits	The CALO hits.
line	The direction along which the momenta are computed.
geoParams	The CALO geometric parameters.
maxRadius	The maximum distance from axis of the hits considered
longitudinalDistStep	The value of the longitudinal step to be considered
threshold	The threshold for the single cube energy deposit.

◆ CaloTwoThreshShowerStartingPoint()

Point Herd::Reconstruction::CaloTwoThreshShowerStartingPoint	(	const CaloHits &	caloHits,
		const Line &	showerAxis,
		const CaloGeoParams &	caloGeoParams,
		float	thr1,
		float	thr2,
		float	radius,
		float	distSecond,
		float	threshold = `0.0f`
	)

Compute the shower starting point using a two-threshold algorithm.

This function searches for the first hit from the entry point in CALO of the given shower axis whose signal is above thr1, then validate it as interaction point only if a subsequent hit along the axis within a longitudinal distance "distSecond" from it with and with a signal exceeding by thr2 the signal of the candidate hit is found. Only hits contained inside the given radius from the axis and above the overall threshold are considered.

Parameters

caloHits	The CALO hits.
showerAxis	The axis/track along which the interaction point is searched.
caloGeoParams	The CALO geometric parameters.
thr1	The energy deposit threshold for the identification of the interaction point.
thr2	The energy deposit threshold for the confirmation of the interaction point.
radius	The maximum distance of hits from the axis/track.
distSecond	The maximum longitudinal distance between the candidate interaction point and the confirmation hit.
threshold	The overall energy deposit threshold.

Returns: The shower starting point, or defaultValue<Point> if no starting point is found.

Functions

Function Documentation

◆ CaloLateralMoment()

◆ CaloLateralMomentLongitudinalProfile()

◆ CaloLocalEnergy()

◆ CaloLongitudinalMoment()

◆ CaloSignalLongitudinalProfile()

◆ CaloTwoThreshShowerStartingPoint()