#include <SurfYZLine.h>

Inheritance diagram for trkf::SurfYZLine:

Public Member Functions
	SurfYZLine ()
	Default constructor. More...

	SurfYZLine (double x0, double y0, double z0, double phi)
	Initializing constructor. More...

virtual	~SurfYZLine ()
	Destructor. More...

double	x0 () const
	X origin. More...

double	y0 () const
	Y origin. More...

double	z0 () const
	Z origin. More...

double	phi () const
	Rotation angle about x-axis. More...

virtual Surface *	clone () const
	Clone method. More...

virtual bool	isTrackValid (const TrackVector &vec) const
	Surface-specific tests of validity of track parameters. More...

virtual void	toLocal (const double xyz[3], double uvw[3]) const
	Transform global to local coordinates. More...

virtual void	toGlobal (const double uvw[3], double xyz[3]) const
	Transform local to global coordinates. More...

virtual TrackVector	getDiff (const TrackVector &vec1, const TrackVector &vec2) const
	Calculate difference of two track parameter vectors. More...

virtual void	getPosition (const TrackVector &vec, double xyz[3]) const
	Get position of track. More...

virtual void	getMomentum (const TrackVector &vec, double mom[3], TrackDirection dir=UNKNOWN) const
	Get momentum vector of track. More...

virtual bool	isParallel (const Surface &surf) const
	Test whether two surfaces are parallel, within tolerance. More...

virtual double	distanceTo (const Surface &surf) const
	Find perpendicular distance to a parallel surface. More...

virtual bool	isEqual (const Surface &surf) const
	Test two surfaces for equality, within tolerance. More...

virtual std::ostream &	Print (std::ostream &out) const
	Printout. More...

Public Member Functions inherited from trkf::SurfLine
	SurfLine ()
	Default constructor. More...

virtual	~SurfLine ()
	Destructor. More...

double	PointingError (const TrackVector &vec, const TrackError &err) const
	Get pointing error of track. More...

void	getStartingError (TrackError &err) const
	Get starting error matrix for Kalman filter. More...

Public Member Functions inherited from trkf::Surface
	Surface ()
	Default constructor. More...

virtual	~Surface ()
	Destructor. More...

virtual TrackDirection	getDirection (const TrackVector &, TrackDirection dir=UNKNOWN) const
	Get direction of track (default UNKNOWN). More...

Private Attributes
double	fX0
	X origin. More...

double	fY0
	Y origin. More...

double	fZ0
	Z origin. More...

double	fPhi
	Rotation angle about x-axis. More...

Static Private Attributes
static double	fPhiTolerance = 1.e-10
	Phi tolerance for parallel. More...

static double	fSepTolerance = 1.e-6
	Separation tolerance for equal. More...

Additional Inherited Members
Public Types inherited from trkf::Surface
enum	TrackDirection { FORWARD, BACKWARD, UNKNOWN }
	Track direction enum. More...

Detailed Description

Definition at line 78 of file SurfYZLine.h.

Constructor & Destructor Documentation

trkf::SurfYZLine::SurfYZLine ( )

Default constructor.

Definition at line 25 of file SurfYZLine.cxx.

                          :
     fX0(0.),
     fY0(0.),
     fZ0(0.),
     fPhi(0.)
   {}

trkf::SurfYZLine::SurfYZLine	(	double	x0,
		double	y0,
		double	z0,
		double	phi
	)

Initializing constructor.

Arguments:

x0, y0, z0 - Global coordinates of local origin. phi - Rotation angle about x-axis.

Definition at line 39 of file SurfYZLine.cxx.

                                                                     :
     fX0(x0),
     fY0(y0),
     fZ0(z0),
     fPhi(phi)
   {}

trkf::SurfYZLine::~SurfYZLine ( )

virtual

Destructor.

Definition at line 47 of file SurfYZLine.cxx.

48 {}

Member Function Documentation

Surface * trkf::SurfYZLine::clone ( ) const

virtual

Clone method.

Implements trkf::Surface.

Definition at line 51 of file SurfYZLine.cxx.

   {
     return new SurfYZLine(*this);
   }

double trkf::SurfYZLine::distanceTo ( const Surface & surf ) const

virtual

Find perpendicular distance to a parallel surface.

Throw an exception if the other surface is not parallel.

Arguments:

surf - Other surface.

Returned value: Distance.

Implements trkf::Surface.

Definition at line 237 of file SurfYZLine.cxx.

   {
     // Check if the other surface is parallel to this one.
 
     bool parallel = isParallel(surf);
     if(!parallel)
       throw cet::exception("SurfYZLine") << "Attempt to find distance to non-parallel surface.\n";
 
     // Find the origin of the other surface in global coordinates,
     // then convert to our local coordinates.
 
     double otheruvw[3] = {0., 0., 0.};
     double xyz[3];
     double myuvw[3];
     surf.toGlobal(otheruvw, xyz);
     toLocal(xyz, myuvw);
 
     // Distance of v-axis to other surface origin.
 
     return std::hypot(myuvw[0], myuvw[2]);
   }

TrackVector trkf::SurfYZLine::getDiff	(	const TrackVector &	vec1,
		const TrackVector &	vec2
	)		const

virtual

Calculate difference of two track parameter vectors.

Calculate difference of two track parameter vectors, taking into account phi wrap.

Arguments:

vec1 - First vector. vec2 - Second vector.

Returns: vec1 - vec2

Reimplemented from trkf::Surface.

Definition at line 117 of file SurfYZLine.cxx.

   {
     TrackVector result = vec1 - vec2;
     while(result(2) <= -TMath::Pi())
       result(2) += TMath::TwoPi();
     while(result(2) > TMath::Pi())
       result(2) -= TMath::TwoPi();
     return result;
   }

void trkf::SurfYZLine::getMomentum	(	const TrackVector &	vec,
		double	mom[3],
		TrackDirection	dir = `UNKNOWN`
	)		const

virtual

Get momentum vector of track.

Arguments:

vec - Track state vector. mom - Momentum vector in global coordinate system. dir - Track direction (ignored).

Implements trkf::Surface.

Definition at line 161 of file SurfYZLine.cxx.

   {
 
     // Get momentum.
 
     double invp = std::abs(vec(4));
     double p = 1. / std::max(invp, 1.e-3);   // Capped at 1000. GeV/c.
 
     // Get track direction parameters.
 
     double phi = vec(2);
     double eta = vec(3);
 
     double sinphi = std::sin(phi);
     double cosphi = std::cos(phi);
     double sh = 1./std::cosh(eta);  // sech(eta)
     double th = std::tanh(eta);
 
     // Calculate momentum vector in local coordinate system.
 
     double pu = p * cosphi * sh;
     double pv = p * th;
     double pw = p * sinphi * sh;
 
     // Rotate momentum to global coordinte system.
 
     double sinfphi = std::sin(fPhi);
     double cosfphi = std::cos(fPhi);
 
     mom[0] = pu;
     mom[1] = pv * cosfphi - pw * sinfphi;
     mom[2] = pv * sinfphi + pw * cosfphi;
 
     return;
   }

void trkf::SurfYZLine::getPosition	(	const TrackVector &	vec,
		double	xyz[3]
	)		const

virtual

Get position of track.

Arguments:

vec - Track state vector. xyz - Position in global coordinate system.

Implements trkf::Surface.

Definition at line 134 of file SurfYZLine.cxx.

   {
     // Get position in local coordinate system.
 
     double phi = vec(2);
     double sinphi = std::sin(phi);
     double cosphi = std::cos(phi);
 
     double uvw[3];
     uvw[0] = -vec(0) * sinphi;
     uvw[1] = vec(1);
     uvw[2] = vec(0) * cosphi;
 
     // Transform to global coordinate system.
 
     toGlobal(uvw, xyz);
     return;
   }

bool trkf::SurfYZLine::isEqual ( const Surface & surf ) const

virtual

Test two surfaces for equality, within tolerance.

Test two surfaces for equality, within tolerance. Here equal is defined as having all surface parameters the same, not just having the surfaces coincide spatially, so that the local coordinate systems are the same between the two surfaces.

Arguments:

surf - Other surface.

Returned values: true if equal.

Implements trkf::Surface.

Definition at line 270 of file SurfYZLine.cxx.

   {
     bool result = false;
 
     // Test if the other surface is a SurfYZLine.
 
     const SurfYZLine* psurf = dynamic_cast<const SurfYZLine*>(&surf);
     if(psurf != 0) {
 
       // Test whether surface parameters are the same within tolerance.
 
       double delta_phi = TVector2::Phi_mpi_pi(fPhi - psurf->phi());
       double dx = fX0 - psurf->x0();
       double dy = fY0 - psurf->y0();
       double dz = fZ0 - psurf->z0();
       if(std::abs(delta_phi) <= fPhiTolerance &&
          std::abs(dx) <= fSepTolerance &&
          std::abs(dy) <= fSepTolerance &&
          std::abs(dz) <= fSepTolerance)
         result = true;
     }
     return result;
   }

bool trkf::SurfYZLine::isParallel ( const Surface & surf ) const

virtual

Test whether two surfaces are parallel, within tolerance.

Test whether two surfaces are parallel, within tolerance. This method will only return true if the other surface is a SurfYZLine.

Arguments:

surf - Other surface.

Returned value: true if parallel.

Implements trkf::Surface.

Definition at line 208 of file SurfYZLine.cxx.

   {
     bool result = false;
 
     // Test if the other surface is a SurfYZLine.
 
     const SurfYZLine* psurf = dynamic_cast<const SurfYZLine*>(&surf);
     if(psurf != 0) {
 
       // Test whether surface angle parameters are the same
       // within tolerance.
 
       double delta_phi = TVector2::Phi_mpi_pi(fPhi - psurf->phi());
       if(std::abs(delta_phi) <= fPhiTolerance)
         result = true;
     }
     return result;
   }

bool trkf::SurfYZLine::isTrackValid ( const TrackVector & vec ) const

virtual

Surface-specific tests of validity of track parameters.

Implements trkf::Surface.

Definition at line 57 of file SurfYZLine.cxx.

   {
     // Limit allowed range of eta parameter.
 
     return std::abs(vec(3)) < 10.;
   }

double trkf::SurfYZLine::phi ( ) const

inline

Rotation angle about x-axis.

Definition at line 95 of file SurfYZLine.h.

std::ostream & trkf::SurfYZLine::Print ( std::ostream & out ) const

virtual

Printout.

Implements trkf::Surface.

Definition at line 295 of file SurfYZLine.cxx.

   {
     out << "SurfYZLine{ x0=" << fX0 << ", y0=" << fY0 << ", z0=" << fZ0 << ", phi=" << fPhi << "}";
     return out;
   }

void trkf::SurfYZLine::toGlobal	(	const double	uvw[3],
		double	xyz[3]
	)		const

virtual

Transform local to global coordinates.

Arguments:

uvw - Cartesian coordinates in local coordinate system. xyz - Cartesian coordinates in global coordinate system.

Implements trkf::Surface.

Definition at line 93 of file SurfYZLine.cxx.

   {
     double sinphi = std::sin(fPhi);
     double cosphi = std::cos(fPhi);
 
     // x = x0 + u
     xyz[0] = fX0 + uvw[0];
 
     // y = y0 + v*cos(phi) - w*sin(phi)
     xyz[1] = fY0 + uvw[1] * cosphi - uvw[2] * sinphi;
 
     // z = z0 + v*sin(phi) + w*cos(phi)
     xyz[2] = fZ0 + uvw[1] * sinphi + uvw[2] * cosphi;
   }

void trkf::SurfYZLine::toLocal	(	const double	xyz[3],
		double	uvw[3]
	)		const

virtual

Transform global to local coordinates.

Arguments:

xyz - Cartesian coordinates in global coordinate system. uvw - Cartesian coordinates in local coordinate system.

Implements trkf::Surface.

Definition at line 71 of file SurfYZLine.cxx.

   {
     double sinphi = std::sin(fPhi);
     double cosphi = std::cos(fPhi);
 
     // u = x-x0
     uvw[0] = xyz[0] - fX0;
 
     // v =  (y-y0)*cos(phi) + (z-z0)*sin(phi)
     uvw[1] = (xyz[1] - fY0) * cosphi + (xyz[2] - fZ0) * sinphi;
 
     // w = -(y-y0)*sin(phi) + (z-z0)*cos(phi)
     uvw[2] = -(xyz[1] - fY0) * sinphi + (xyz[2] - fZ0) * cosphi;
   }

double trkf::SurfYZLine::x0 ( ) const

inline

X origin.

Definition at line 92 of file SurfYZLine.h.

double trkf::SurfYZLine::y0 ( ) const

inline

Y origin.

Definition at line 93 of file SurfYZLine.h.

double trkf::SurfYZLine::z0 ( ) const

inline

Z origin.

Definition at line 94 of file SurfYZLine.h.

Member Data Documentation

double trkf::SurfYZLine::fPhi

private

Rotation angle about x-axis.

Definition at line 143 of file SurfYZLine.h.

double trkf::SurfYZLine::fPhiTolerance = 1.e-10

staticprivate

Phi tolerance for parallel.

Definition at line 135 of file SurfYZLine.h.

double trkf::SurfYZLine::fSepTolerance = 1.e-6

staticprivate

Separation tolerance for equal.

Definition at line 136 of file SurfYZLine.h.

double trkf::SurfYZLine::fX0

private

X origin.

Definition at line 140 of file SurfYZLine.h.

double trkf::SurfYZLine::fY0

private

Y origin.

Definition at line 141 of file SurfYZLine.h.

double trkf::SurfYZLine::fZ0

private

Z origin.

Definition at line 142 of file SurfYZLine.h.

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

Public Member Functions

Private Attributes

Static Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation