#include "Shower.h"

Public Member Functions
	Shower ()

	Shower (TVector3 const &dcosVtx, TVector3 const &dcosVtxErr, TVector3 const &xyz, TVector3 const &xyzErr, std::vector< double > TotalEnergy, std::vector< double > TotalEnergyErr, std::vector< double > dEdx, std::vector< double > dEdxErr, int bestplane, int id, double length, double openAngle)

	Shower (TVector3 const &dcosVtx, TVector3 const &dcosVtxErr, TVector3 const &xyz, TVector3 const &xyzErr, std::vector< double > TotalEnergy, std::vector< double > TotalEnergyErr, std::vector< double > dEdx, std::vector< double > dEdxErr, int bestplane, int id=util::kBogusI)

void	set_id (const int id)

void	set_total_energy (const std::vector< double > &q)

void	set_total_energy_err (const std::vector< double > &q)

void	set_total_MIPenergy (const std::vector< double > &q)

void	set_total_MIPenergy_err (const std::vector< double > &q)

void	set_total_best_plane (const int q)

void	set_direction (const TVector3 &dir)

void	set_direction_err (const TVector3 &dir_e)

void	set_start_point (const TVector3 &xyz)

void	set_start_point_err (const TVector3 &xyz_e)

void	set_dedx (const std::vector< double > &q)

void	set_dedx_err (const std::vector< double > &q)

void	set_length (const double &l)

void	set_open_angle (const double &a)

int	ID () const

const TVector3 &	Direction () const

const TVector3 &	DirectionErr () const

const TVector3 &	ShowerStart () const

const TVector3 &	ShowerStartErr () const

const std::vector< double > &	Energy () const

const std::vector< double > &	EnergyErr () const

const std::vector< double > &	MIPEnergy () const

const std::vector< double > &	MIPEnergyErr () const

int	best_plane () const

double	Length () const

double	OpenAngle () const

const std::vector< double > &	dEdx () const

const std::vector< double > &	dEdxErr () const

bool	has_open_angle () const
	Returns whether the shower has a valid opening angle. More...

bool	has_length () const
	Returns whether the shower has a valid length. More...

Private Attributes
int	fID
	Default constructor. More...

TVector3	fDCosStart
	direction cosines at start of shower More...

TVector3	fSigmaDCosStart
	uncertainty on initial direction cosines More...

TVector3	fXYZstart
	direction cosines at start of shower More...

TVector3	fSigmaXYZstart
	uncertainty on initial direction cosines More...

std::vector< double >	fTotalEnergy
	Calculated Energy per each plane. More...

std::vector< double >	fSigmaTotalEnergy
	Calculated Energy per each plane. More...

std::vector< double >	fdEdx
	Calculated dE/dx per each plane. More...

std::vector< double >	fSigmadEdx
	Calculated dE/dx per each plane. More...

std::vector< double >	fTotalMIPEnergy
	Calculated Energy per each plane. More...

std::vector< double >	fSigmaTotalMIPEnergy
	Calculated Energy per each plane. More...

int	fBestPlane

double	fLength
	Shower length [cm]. More...

double	fOpenAngle
	Opening angle [rad]. More...

Static Private Attributes
static constexpr double	InvalidLength = std::numeric_limits<double>::lowest()
	The magic constant indicating the invalidity of the shower length variable. More...

static constexpr double	InvalidOpeningAngle = std::numeric_limits<double>::lowest()
	The magic constant indicating the invalidity of the opening angle variable. More...

Friends
std::ostream &	operator<< (std::ostream &stream, Shower const &a)

bool	operator< (const Shower &a, const Shower &b)

Detailed Description

Definition at line 19 of file Shower.h.

Constructor & Destructor Documentation

recob::Shower::Shower ( )

Definition at line 20 of file Shower.cxx.

20 {}

recob::Shower::Shower	(	TVector3 const &	dcosVtx,
		TVector3 const &	dcosVtxErr,
		TVector3 const &	xyz,
		TVector3 const &	xyzErr,
		std::vector< double >	TotalEnergy,
		std::vector< double >	TotalEnergyErr,
		std::vector< double >	dEdx,
		std::vector< double >	dEdxErr,
		int	bestplane,
		int	id,
		double	length,
		double	openAngle
	)

Definition at line 23 of file Shower.cxx.

     : fID(id)
     , fDCosStart(dcosVtx)
     , fSigmaDCosStart(dcosVtxErr)
     , fXYZstart(xyz)
     , fSigmaXYZstart(xyzErr)
     , fTotalEnergy(std::move(TotalEnergy))
     , fSigmaTotalEnergy(std::move(TotalEnergyErr))
     , fdEdx(std::move(dEdx))
     , fSigmadEdx(std::move(dEdxErr))
     , fBestPlane(bestplane)
     , fLength(length)
     , fOpenAngle(openAngle)
   {}

recob::Shower::Shower	(	TVector3 const &	dcosVtx,
		TVector3 const &	dcosVtxErr,
		TVector3 const &	xyz,
		TVector3 const &	xyzErr,
		std::vector< double >	TotalEnergy,
		std::vector< double >	TotalEnergyErr,
		std::vector< double >	dEdx,
		std::vector< double >	dEdxErr,
		int	bestplane,
		int	id = `util::kBogusI`
	)

inline

Legacy constructor (with no length and no opening angle).

Deprecated:: Use the complete constructor instead!

Definition at line 102 of file Shower.h.

       : Shower(dcosVtx,
                dcosVtxErr,
                xyz,
                xyzErr,
                TotalEnergy,
                TotalEnergyErr,
                dEdx,
                dEdxErr,
                bestplane,
                id,
                InvalidLength,
                InvalidOpeningAngle)
     {}

Member Function Documentation

int recob::Shower::best_plane ( ) const

inline

Definition at line 223 of file Shower.h.

References fBestPlane.

Referenced by lar_pandora::PFParticleAnalysis::analyze(), recob::operator<<(), DUNE::NeutrinoShowerEff::processEff(), and set_open_angle().

 {
   return fBestPlane;
 }

const std::vector< double > & recob::Shower::dEdx ( ) const

inline

Definition at line 235 of file Shower.h.

References fdEdx.

Referenced by ems::MultiEMShowers::analyze(), evd::RecoBaseDrawer::DrawShower3D(), recob::operator<<(), DUNE::NeutrinoShowerEff::processEff(), and set_open_angle().

 {
   return fdEdx;
 }

const std::vector< double > & recob::Shower::dEdxErr ( ) const

inline

Definition at line 239 of file Shower.h.

References fSigmadEdx.

Referenced by set_open_angle().

 {
   return fSigmadEdx;
 }

const TVector3 & recob::Shower::Direction ( ) const

inline

Definition at line 188 of file Shower.h.

References fDCosStart.

Referenced by lar_pandora::PFParticleAnalysis::analyze(), NuShowerEff::analyze(), ems::MultiEMShowers::analyze(), evd::RecoBaseDrawer::DrawShower3D(), mvapid::MVAAlg::LinFitShower(), DUNE::NeutrinoShowerEff::processEff(), TrackProducerFromPFParticle::produce(), trkf::KalmanFilterFinalTrackFitter::produce(), and set_open_angle().

 {
   return fDCosStart;
 }

const TVector3 & recob::Shower::DirectionErr ( ) const

inline

Definition at line 192 of file Shower.h.

References fSigmaDCosStart.

Referenced by set_open_angle().

 {
   return fSigmaDCosStart;
 }

const std::vector< double > & recob::Shower::Energy ( ) const

inline

Definition at line 206 of file Shower.h.

References fTotalEnergy.

Referenced by recob::operator<<(), DUNE::NeutrinoShowerEff::processEff(), TrackProducerFromPFParticle::produce(), and set_open_angle().

 {
   return fTotalEnergy;
 }

const std::vector< double > & recob::Shower::EnergyErr ( ) const

inline

Definition at line 210 of file Shower.h.

References fSigmaTotalEnergy.

Referenced by set_open_angle().

 {
   return fSigmaTotalEnergy;
 }

bool recob::Shower::has_length ( ) const

inline

Returns whether the shower has a valid length.

Definition at line 252 of file Shower.h.

References fLength.

Referenced by evd::RecoBaseDrawer::DrawShower3D(), and set_open_angle().

 {
   return fLength >= 0.0;
 }

bool recob::Shower::has_open_angle ( ) const

inline

Returns whether the shower has a valid opening angle.

Definition at line 248 of file Shower.h.

References fOpenAngle.

Referenced by evd::RecoBaseDrawer::DrawShower3D(), and set_open_angle().

 {
   return fOpenAngle >= 0.0;
 }

int recob::Shower::ID ( ) const

inline

Definition at line 183 of file Shower.h.

References fID.

Referenced by lar_pandora::PFParticleAnalysis::analyze(), recob::operator<(), recob::operator<<(), lar_pandora::LArPandoraEventDump::PrintShower(), trkf::KalmanFilterFinalTrackFitter::produce(), evd::RecoBaseDrawer::Prong3D(), evd::RecoBaseDrawer::ProngOrtho(), and set_open_angle().

 {
   return fID;
 }

double recob::Shower::Length ( ) const

inline

Definition at line 227 of file Shower.h.

References fLength.

Referenced by lar_pandora::PFParticleAnalysis::analyze(), NuShowerEff::analyze(), evd::RecoBaseDrawer::DrawShower3D(), lar_pandora::LArPandoraEventDump::PrintShower(), DUNE::NeutrinoShowerEff::processEff(), and set_open_angle().

 {
   return fLength;
 }

const std::vector< double > & recob::Shower::MIPEnergy ( ) const

inline

Definition at line 215 of file Shower.h.

References fTotalMIPEnergy.

Referenced by DUNE::NeutrinoShowerEff::processEff(), and set_open_angle().

 {
   return fTotalMIPEnergy;
 }

const std::vector< double > & recob::Shower::MIPEnergyErr ( ) const

inline

Definition at line 219 of file Shower.h.

References fSigmaTotalMIPEnergy.

Referenced by set_open_angle().

 {
   return fSigmaTotalMIPEnergy;
 }

double recob::Shower::OpenAngle ( ) const

inline

Definition at line 231 of file Shower.h.

References fOpenAngle.

Referenced by lar_pandora::PFParticleAnalysis::analyze(), evd::RecoBaseDrawer::DrawShower3D(), lar_pandora::LArPandoraEventDump::PrintShower(), and set_open_angle().

 {
   return fOpenAngle;
 }

void recob::Shower::set_dedx ( const std::vector< double > & q )

inline

Definition at line 138 of file Shower.h.

Referenced by cluster::TrajCluster::produce(), and showerreco::ShowerRecoAlg::RecoOneShower().

138 { fdEdx = q; }

recob::Shower::fdEdx

std::vector< double > fdEdx

Calculated dE/dx per each plane.

Definition: Shower.h:32

void recob::Shower::set_dedx_err ( const std::vector< double > & q )

inline

Definition at line 139 of file Shower.h.

Referenced by cluster::TrajCluster::produce().

139 { fSigmadEdx = q; }

recob::Shower::fSigmadEdx

std::vector< double > fSigmadEdx

Calculated dE/dx per each plane.

Definition: Shower.h:33

void recob::Shower::set_direction ( const TVector3 & dir )

inline

Definition at line 134 of file Shower.h.

References dir.

Referenced by shwf::ShowerCheater::produce(), cluster::TrajCluster::produce(), shwf::ShowerReco::produce(), and showerreco::ShowerRecoAlg::RecoOneShower().

134 { fDCosStart = dir; }

recob::Shower::fDCosStart

TVector3 fDCosStart

direction cosines at start of shower

Definition: Shower.h:26

dir

TDirectory * dir

Definition: macro.C:5

void recob::Shower::set_direction_err ( const TVector3 & dir_e )

inline

Definition at line 135 of file Shower.h.

Referenced by shwf::ShowerCheater::produce(), cluster::TrajCluster::produce(), and shwf::ShowerReco::produce().

135 { fSigmaDCosStart = dir_e; }

recob::Shower::fSigmaDCosStart

TVector3 fSigmaDCosStart

uncertainty on initial direction cosines

Definition: Shower.h:27

void recob::Shower::set_id ( const int id )

inline

Definition at line 127 of file Shower.h.

Referenced by shwf::ShowerCheater::produce(), cluster::TrajCluster::produce(), and shower::EMShower::produce().

127 { fID = id; }

recob::Shower::fID

int fID

Default constructor.

Definition: Shower.h:25

void recob::Shower::set_length ( const double & l )

inline

Definition at line 140 of file Shower.h.

Referenced by cluster::TrajCluster::produce(), and showerreco::ShowerRecoAlg::RecoOneShower().

140 { fLength = l; }

recob::Shower::fLength

double fLength

Shower length [cm].

Definition: Shower.h:48

void recob::Shower::set_open_angle ( const double & a )

inline

Definition at line 141 of file Shower.h.

References best_plane(), dEdx(), dEdxErr(), Direction(), DirectionErr(), Energy(), EnergyErr(), f, has_length(), has_open_angle(), ID(), Length(), MIPEnergy(), MIPEnergyErr(), OpenAngle(), operator<, operator<<, ShowerStart(), and ShowerStartErr().

Referenced by cluster::TrajCluster::produce().

141 { fOpenAngle = a; }

recob::Shower::fOpenAngle

double fOpenAngle

Opening angle [rad].

Definition: Shower.h:62

void recob::Shower::set_start_point ( const TVector3 & xyz )

inline

Definition at line 136 of file Shower.h.

Referenced by cluster::TrajCluster::produce(), and showerreco::ShowerRecoAlg::RecoOneShower().

136 { fXYZstart = xyz; }

recob::Shower::fXYZstart

TVector3 fXYZstart

direction cosines at start of shower

Definition: Shower.h:28

void recob::Shower::set_start_point_err ( const TVector3 & xyz_e )

inline

Definition at line 137 of file Shower.h.

Referenced by cluster::TrajCluster::produce().

137 { fSigmaXYZstart = xyz_e; }

recob::Shower::fSigmaXYZstart

TVector3 fSigmaXYZstart

uncertainty on initial direction cosines

Definition: Shower.h:29

void recob::Shower::set_total_best_plane ( const int q )

inline

Definition at line 132 of file Shower.h.

Referenced by cluster::TrajCluster::produce(), and showerreco::ShowerRecoAlg::RecoOneShower().

132 { fBestPlane = q; }

recob::Shower::fBestPlane

int fBestPlane

Definition: Shower.h:37

void recob::Shower::set_total_energy ( const std::vector< double > & q )

inline

Definition at line 128 of file Shower.h.

Referenced by cluster::TrajCluster::produce(), and showerreco::ShowerRecoAlg::RecoOneShower().

128 { fTotalEnergy = q; }

recob::Shower::fTotalEnergy

std::vector< double > fTotalEnergy

Calculated Energy per each plane.

Definition: Shower.h:30

void recob::Shower::set_total_energy_err ( const std::vector< double > & q )

inline

Definition at line 129 of file Shower.h.

Referenced by cluster::TrajCluster::produce().

129 { fSigmaTotalEnergy = q; }

recob::Shower::fSigmaTotalEnergy

std::vector< double > fSigmaTotalEnergy

Calculated Energy per each plane.

Definition: Shower.h:31

void recob::Shower::set_total_MIPenergy ( const std::vector< double > & q )

inline

Definition at line 130 of file Shower.h.

Referenced by cluster::TrajCluster::produce(), and showerreco::ShowerRecoAlg::RecoOneShower().

130 { fTotalMIPEnergy = q; }

recob::Shower::fTotalMIPEnergy

std::vector< double > fTotalMIPEnergy

Calculated Energy per each plane.

Definition: Shower.h:35

void recob::Shower::set_total_MIPenergy_err ( const std::vector< double > & q )

inline

Definition at line 131 of file Shower.h.

Referenced by cluster::TrajCluster::produce().

131 { fSigmaTotalMIPEnergy = q; }

recob::Shower::fSigmaTotalMIPEnergy

std::vector< double > fSigmaTotalMIPEnergy

Calculated Energy per each plane.

Definition: Shower.h:36

const TVector3 & recob::Shower::ShowerStart ( ) const

inline

Definition at line 197 of file Shower.h.

References fXYZstart.

Referenced by lar_pandora::PFParticleAnalysis::analyze(), NuShowerEff::analyze(), ems::MultiEMShowers::analyze(), evd::RecoBaseDrawer::DrawShower3D(), evd::RecoBaseDrawer::DrawShowerOrtho(), mvapid::MVAAlg::LinFitShower(), lar_pandora::LArPandoraEventDump::PrintShower(), DUNE::NeutrinoShowerEff::processEff(), TrackProducerFromPFParticle::produce(), shower::EMShower::produce(), trkf::KalmanFilterFinalTrackFitter::produce(), set_open_angle(), and mvapid::MVAAlg::SortShower().

 {
   return fXYZstart;
 }

const TVector3 & recob::Shower::ShowerStartErr ( ) const

inline

Definition at line 201 of file Shower.h.

References fSigmaXYZstart.

Referenced by set_open_angle().

 {
   return fSigmaXYZstart;
 }

Friends And Related Function Documentation

bool operator<	(	const Shower &	a,
		const Shower &	b
	)

friend

Definition at line 62 of file Shower.cxx.

Referenced by set_open_angle().

   {
     if (a.ID() != b.ID()) return a.ID() < b.ID();
 
     return false; //They are equal
   }

std::ostream& operator<<	(	std::ostream &	stream,
		Shower const &	a
	)

friend

Definition at line 50 of file Shower.cxx.

Referenced by set_open_angle().

   {
     o << std::setiosflags(std::ios::fixed) << std::setprecision(3);
     o << " Shower ID " << std::setw(4) << std::right << a.ID();
     o << " Energy    " << std::setw(4) << std::right << a.Energy()[a.best_plane()];
     o << " dEdx    " << std::setw(4) << std::right << a.dEdx()[a.best_plane()];
     return o;
   }

Member Data Documentation

int recob::Shower::fBestPlane

private

Definition at line 37 of file Shower.h.

Referenced by best_plane().

TVector3 recob::Shower::fDCosStart

private

direction cosines at start of shower

Definition at line 26 of file Shower.h.

Referenced by Direction().

std::vector<double> recob::Shower::fdEdx

private

Calculated dE/dx per each plane.

Definition at line 32 of file Shower.h.

Referenced by dEdx().

int recob::Shower::fID

private

Default constructor.

Definition at line 25 of file Shower.h.

Referenced by ID().

double recob::Shower::fLength

private

Shower length [cm].

The length of a shower, and should be greater than 0. The characteristic depends on shower reconstruction algorithms. For example, in PCAShowerParticleBuildingAlgorithm (larpandora), it is defined as the three standard deviations of the spacepoint distribution along the principal axis.

Definition at line 48 of file Shower.h.

Referenced by has_length(), and Length().

double recob::Shower::fOpenAngle

private

Opening angle [rad].

The angle is defined in the $[ 0, \pi/2 ]$ range. It is defined as the angle of the shower cone. The characteristic depends on shower reconstruction algorithms. For example, in PCAShowerParticleBuildingAlgorithm (larpandora), it is defined as the ratio of the standard deviation of the spacepoint distribution along the principal axis to that along the secondary axis.

Definition at line 62 of file Shower.h.

Referenced by has_open_angle(), and OpenAngle().

TVector3 recob::Shower::fSigmaDCosStart

private

uncertainty on initial direction cosines

Definition at line 27 of file Shower.h.

Referenced by DirectionErr().

std::vector<double> recob::Shower::fSigmadEdx

private

Calculated dE/dx per each plane.

Definition at line 33 of file Shower.h.

Referenced by dEdxErr().

std::vector<double> recob::Shower::fSigmaTotalEnergy

private

Calculated Energy per each plane.

Definition at line 31 of file Shower.h.

Referenced by EnergyErr().

std::vector<double> recob::Shower::fSigmaTotalMIPEnergy

private

Calculated Energy per each plane.

Definition at line 36 of file Shower.h.

Referenced by MIPEnergyErr().

TVector3 recob::Shower::fSigmaXYZstart

private

uncertainty on initial direction cosines

Definition at line 29 of file Shower.h.

Referenced by ShowerStartErr().

std::vector<double> recob::Shower::fTotalEnergy

private

Calculated Energy per each plane.

Definition at line 30 of file Shower.h.

Referenced by Energy().

std::vector<double> recob::Shower::fTotalMIPEnergy

private

Calculated Energy per each plane.

Definition at line 35 of file Shower.h.

Referenced by MIPEnergy().

TVector3 recob::Shower::fXYZstart

private

direction cosines at start of shower

Definition at line 28 of file Shower.h.

Referenced by ShowerStart().

constexpr double recob::Shower::InvalidLength = std::numeric_limits<double>::lowest()

staticprivate

The magic constant indicating the invalidity of the shower length variable.

This internal constant represents invalid shower length. It is how the function has_length() determines the validity of fLength.

Definition at line 73 of file Shower.h.

constexpr double recob::Shower::InvalidOpeningAngle = std::numeric_limits<double>::lowest()

staticprivate

The magic constant indicating the invalidity of the opening angle variable.

This internal constant represents invalid opening angle. It is how the function has_open_angle() determines the validity of fOpenAngle.

Definition at line 84 of file Shower.h.

The documentation for this class was generated from the following files:

lardataobj/v09_18_03/source/lardataobj/RecoBase/Shower.h
lardataobj/v09_18_03/source/lardataobj/RecoBase/Shower.cxx

Public Member Functions

Private Attributes

Static Private Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation