recob::Shower Class Reference

#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 21 of file Shower.cxx.

  {
  }

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 26 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 107 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 200 of file Shower.h.

References fBestPlane.

Referenced by lar_pandora::PFParticleAnalysis::analyze(), lar::example::ShowerCalibrationGaloreFromPID::correction(), lar::example::ShowerCalibrationGaloreFromPID::correctionFactor(), recob::operator<<(), DUNE::NeutrinoShowerEff::processEff(), and set_open_angle().

{ return fBestPlane;               }

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

inline

Definition at line 203 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 204 of file Shower.h.

References fSigmadEdx.

Referenced by set_open_angle().

{ return fSigmadEdx;     }

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

inline

Definition at line 189 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 190 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 195 of file Shower.h.

References fTotalEnergy.

Referenced by lar::example::ShowerCalibrationGaloreFromPID::correction(), lar::example::ShowerCalibrationGaloreFromPID::correctionFactor(), recob::operator<<(), DUNE::NeutrinoShowerEff::processEff(), and set_open_angle().

{ return fTotalEnergy;          }

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

inline

Definition at line 196 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 211 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 210 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 187 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 201 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 198 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 199 of file Shower.h.

References fSigmaTotalMIPEnergy.

Referenced by set_open_angle().

{ return fSigmaTotalMIPEnergy;     }

double recob::Shower::OpenAngle ( ) const

inline

Definition at line 202 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 139 of file Shower.h.

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

{ fdEdx = q;        }

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

inline

Definition at line 140 of file Shower.h.

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

{ fSigmadEdx = q;        }

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

inline

Definition at line 135 of file Shower.h.

References dir.

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

{ fDCosStart = dir;        }

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

inline

Definition at line 136 of file Shower.h.

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

{ fSigmaDCosStart = dir_e; }

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

inline

Definition at line 128 of file Shower.h.

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

{ fID = id;                 }

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

inline

Definition at line 141 of file Shower.h.

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

{ fLength = l; }    

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

inline

Definition at line 142 of file Shower.h.

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

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

{ fOpenAngle = a;   }

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

inline

Definition at line 137 of file Shower.h.

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

{ fXYZstart = xyz;        }

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

inline

Definition at line 138 of file Shower.h.

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

{ fSigmaXYZstart = xyz_e; }

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

inline

Definition at line 133 of file Shower.h.

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

{ fBestPlane = q;        }

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

inline

Definition at line 129 of file Shower.h.

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

{ fTotalEnergy = q;         }

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

inline

Definition at line 130 of file Shower.h.

Referenced by cluster::TrajCluster::produce(), and ems::MergeEMShower3D::produce().

{ fSigmaTotalEnergy = q;    }

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

inline

Definition at line 131 of file Shower.h.

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

{ fTotalMIPEnergy = q;      }

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

inline

Definition at line 132 of file Shower.h.

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

{ fSigmaTotalMIPEnergy = q; }

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

inline

Definition at line 192 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(), shower::EMShower::produce(), TrackProducerFromPFParticle::produce(), trkf::KalmanFilterFinalTrackFitter::produce(), set_open_angle(), and mvapid::MVAAlg::SortShower().

{ return fXYZstart;          }

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

inline

Definition at line 193 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 67 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 55 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 39 of file Shower.h.

Referenced by best_plane().

TVector3 recob::Shower::fDCosStart

private

direction cosines at start of shower

Definition at line 28 of file Shower.h.

Referenced by Direction().

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

private

Calculated dE/dx per each plane.

Definition at line 34 of file Shower.h.

Referenced by dEdx().

int recob::Shower::fID

private

Default constructor.

Definition at line 27 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 50 of file Shower.h.

Referenced by has_length(), and Length().

double recob::Shower::fOpenAngle

private

Opening angle [rad].

The angle is defined in the 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 64 of file Shower.h.

Referenced by has_open_angle(), and OpenAngle().

TVector3 recob::Shower::fSigmaDCosStart

private

uncertainty on initial direction cosines

Definition at line 29 of file Shower.h.

Referenced by DirectionErr().

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

private

Calculated dE/dx per each plane.

Definition at line 35 of file Shower.h.

Referenced by dEdxErr().

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

private

Calculated Energy per each plane.

Definition at line 33 of file Shower.h.

Referenced by EnergyErr().

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

private

Calculated Energy per each plane.

Definition at line 38 of file Shower.h.

Referenced by MIPEnergyErr().

TVector3 recob::Shower::fSigmaXYZstart

private

uncertainty on initial direction cosines

Definition at line 31 of file Shower.h.

Referenced by ShowerStartErr().

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

private

Calculated Energy per each plane.

Definition at line 32 of file Shower.h.

Referenced by Energy().

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

private

Calculated Energy per each plane.

Definition at line 37 of file Shower.h.

Referenced by MIPEnergy().

TVector3 recob::Shower::fXYZstart

private

direction cosines at start of shower

Definition at line 30 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 76 of file Shower.h.

Referenced by set_open_angle().

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 88 of file Shower.h.

Referenced by set_open_angle().

---

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

• /cvmfs/larsoft.opensciencegrid.org/products/lardataobj/v07_06_00/source/lardataobj/RecoBase/Shower.h
• /cvmfs/larsoft.opensciencegrid.org/products/lardataobj/v07_06_00/source/lardataobj/RecoBase/Shower.cxx