Cone Class Reference

#include <Cone.h>

Inheritance diagram for Cone:

Public Types
typedef ReferenceCountingPointer< Cone >	ConePointer
typedef ReferenceCountingPointer< Cone >	ConstConePointer
Public Types inherited from Surface
using	Base = GloballyPositioned< float >
using	Side = SurfaceOrientation::Side
Public Types inherited from GloballyPositioned< float >
typedef Point3DBase< float, GlobalTag >	GlobalPoint
typedef Vector3DBase< float, GlobalTag >	GlobalVector
typedef Point3DBase< float, LocalTag >	LocalPoint
typedef Vector3DBase< float, LocalTag >	LocalVector
typedef Point3DBase< float, GlobalTag >	PositionType
typedef TkRotation< float >	RotationType
typedef float	Scalar

Public Member Functions
template<typename... Args>
	Cone (const PositionType &vert, Geom::Theta< Scalar > angle, Args &&...args)
	Cone (const PositionType &pos, const RotationType &rot, const PositionType &vert, Geom::Theta< Scalar > angle)
Geom::Theta< float >	openingAngle () const
	Angle of the cone. More...
Side	side (const LocalPoint &p, Scalar tolerance) const override
Side	side (const GlobalPoint &p, Scalar tolerance) const override
ConstReferenceCountingPointer< TangentPlane >	tangentPlane (const GlobalPoint &) const override
ConstReferenceCountingPointer< TangentPlane >	tangentPlane (const LocalPoint &) const override
GlobalPoint	vertex () const
	Global position of the cone vertex. More...
Public Member Functions inherited from Surface
const Bounds &	bounds () const
const MediumProperties &	mediumProperties () const
std::pair< float, float > const &	phiSpan () const
std::pair< float, float > const &	rSpan () const
void	setMediumProperties (const MediumProperties &mp)
GlobalPoint	toGlobal (const Point2DBase< Scalar, LocalTag > lp) const
std::pair< float, float > const &	zSpan () const
	~Surface () override
Public Member Functions inherited from BasicReferenceCounted
void	addReference () const
	BasicReferenceCounted ()
	BasicReferenceCounted (const BasicReferenceCounted &)
	BasicReferenceCounted (BasicReferenceCounted &&)=default
BasicReferenceCounted &	operator= (BasicReferenceCounted &&)=default
BasicReferenceCounted &	operator= (const BasicReferenceCounted &)
unsigned int	references () const
void	removeReference () const
virtual	~BasicReferenceCounted ()
Public Member Functions inherited from GloballyPositioned< float >
float	eta () const
	GloballyPositioned ()
	GloballyPositioned (const PositionType &pos, const RotationType &rot)
void	move (const GlobalVector &displacement)
float	phi () const
const PositionType &	position () const
void	rotate (const RotationType &rotation)
const RotationType &	rotation () const
GlobalPoint	toGlobal (const LocalPoint &lp) const
Point3DBase< U, GlobalTag >	toGlobal (const Point3DBase< U, LocalTag > &lp) const
GlobalVector	toGlobal (const LocalVector &lv) const
Vector3DBase< U, GlobalTag >	toGlobal (const Vector3DBase< U, LocalTag > &lv) const
LocalPoint	toLocal (const GlobalPoint &gp) const
Point3DBase< U, LocalTag >	toLocal (const Point3DBase< U, GlobalTag > &gp) const
LocalVector	toLocal (const GlobalVector &gv) const
Vector3DBase< U, LocalTag >	toLocal (const Vector3DBase< U, GlobalTag > &gv) const
virtual	~GloballyPositioned ()

Static Public Member Functions
static ConePointer	build (const PositionType &pos, const RotationType &rot, const PositionType &vert, Geom::Theta< Scalar > angle)
Static Public Member Functions inherited from GloballyPositioned< float >
static float	iniEta ()
static float	iniPhi ()

Private Attributes
Geom::Theta< Scalar >	theAngle
GlobalPoint	theVertex

Additional Inherited Members
Protected Member Functions inherited from Surface
	Surface ()
	Surface (const PositionType &pos, const RotationType &rot)
	Surface (const PositionType &pos, const RotationType &rot, Bounds *bounds)
	Surface (const PositionType &pos, const RotationType &rot, MediumProperties mp)
	Surface (const PositionType &pos, const RotationType &rot, MediumProperties mp, Bounds *bounds)
	Surface (const Surface &iSurface)
	Surface (Surface &&iSurface)
Protected Attributes inherited from Surface
extstd::clone_ptr< Bounds >	theBounds
MediumProperties	theMediumProperties

Detailed Description

A Cone.

Warning

Surfaces are reference counted, so only ReferenceCountingPointer should be used to point to them. For this reason, they should be using the static build() method. (The normal constructors will become private in the future).

Definition at line 17 of file Cone.h.

Member Typedef Documentation

typedef ReferenceCountingPointer<Cone> Cone::ConePointer

Definition at line 27 of file Cone.h.

typedef ReferenceCountingPointer<Cone> Cone::ConstConePointer

Definition at line 28 of file Cone.h.

Constructor & Destructor Documentation

template<typename... Args>

Cone::Cone ( const PositionType &  vert, Geom::Theta< Scalar >  angle, Args &&...  args  )

inline

Definition at line 21 of file Cone.h.

Referenced by build().

                        :
    Surface(std::forward<Args>(args)...), 
    theVertex(vert), theAngle(angle) {}

Cone::Cone ( const PositionType &  pos, const RotationType &  rot, const PositionType &  vert, Geom::Theta< Scalar >  angle  )

inline

Do not use this constructor directly; use the static build method, which returns a ReferenceCountingPointer. This constructor will soon become private

Definition at line 47 of file Cone.h.

                                                       :
    Surface( pos, rot), theVertex(vert), theAngle(angle) {}

Member Function Documentation

static ConePointer Cone::build ( const PositionType &  pos, const RotationType &  rot, const PositionType &  vert, Geom::Theta< Scalar >  angle  )

inlinestatic

Construct a cone with the specified vertex and opening angle. The reference frame is defined by pos and rot; the cone axis is parallel to the local Z axis.

Definition at line 34 of file Cone.h.

References Cone().

Referenced by psClasses.BuildThread::run().

                                        {
    return ConePointer(new Cone(vert, angle, pos, rot));
  }

Geom::Theta<float> Cone::openingAngle ( ) const

inline

Angle of the cone.

Definition at line 58 of file Cone.h.

References theAngle.

Referenced by SteppingHelixPropagator::refToMagVolume(), MagGeoBuilderFromDDD::volumeHandle::sameSurface(), and side().

{return theAngle;}

Side Cone::side ( const LocalPoint &  p, Scalar  tolerance  ) const

inlineoverridevirtual

Returns the side of the surface on which the point is. Not defined for 1-sided surfaces (Moebius leaf etc.) For normal 2-sided surfaces the meaning of side is surface type dependent.

Implements Surface.

Definition at line 63 of file Cone.h.

References AlCaHLTBitMon_ParallelJobs::p, side(), tangentPlane(), Surface::toGlobal(), and tolerance.

Referenced by side().

{return side( toGlobal(p), tolerance);}

Surface::Side Cone::side ( const GlobalPoint &  p, Scalar  tolerance  ) const

overridevirtual

Reimplemented from Surface.

Definition at line 22 of file Cone.cc.

References delta, SurfaceOrientation::negativeSide, SurfaceOrientation::onSurface, openingAngle(), p1, Geom::pi(), SurfaceOrientation::positiveSide, tolerance, vertex(), PV3DBase< T, PVType, FrameType >::x(), PV3DBase< T, PVType, FrameType >::y(), and PV3DBase< T, PVType, FrameType >::z().

                                                                    {
  // FIXME: should be done in local coordinates as this is not correct in the case the verstex is not on the (global) Z axis!!!!

  // tolerance is interpreted as max distance from cone surface.
  // FIXME: check case when vertex().z()==inf.
  GlobalPoint p1(p.x(), p.y(), p.z()-vertex().z());

  // handle the singularity of p=vertex (i.e. p1.mag() undefined)
  if (p1.mag()<tolerance) return SurfaceOrientation::onSurface;
  double delta = double(p1.theta())- double(openingAngle());
  if (fabs(delta) < tolerance/p1.mag()) return SurfaceOrientation::onSurface;
  
  if (p1.theta() < Geom::pi()/2.) {
    return (delta>0. ?  SurfaceOrientation::positiveSide : SurfaceOrientation::negativeSide);
  } else {
    return (delta>0. ?  SurfaceOrientation::negativeSide : SurfaceOrientation::positiveSide);
  }
}

ConstReferenceCountingPointer< TangentPlane > Cone::tangentPlane ( const GlobalPoint &  ) const

overridevirtual

Tangent plane to surface from global point. Returns a plane, tangent to the Surface at a point. The point must be on the surface. The return type is a ReferenceCountingPointer, so the plane will be deleted automatically when no longer needed.

Implements Surface.

Definition at line 8 of file Cone.cc.

References gather_cfg::cout.

Referenced by side().

                                                                                        {
  // FIXME: to be implemented...
  std::cout << "*** WARNING: Cone::tangentPlane not implemented." <<std::endl;
  abort();
  return ConstReferenceCountingPointer<TangentPlane>();
}

ConstReferenceCountingPointer< TangentPlane > Cone::tangentPlane ( const LocalPoint &  ) const

overridevirtual

Tangent plane to surface from local point.

Implements Surface.

Definition at line 15 of file Cone.cc.

References gather_cfg::cout.

                                                                                       {
  // FIXME: to be implemented...
  std::cout << "*** WARNING: Cone::tangentPlane not implemented." <<std::endl;
  abort();
  return ConstReferenceCountingPointer<TangentPlane>();
}

GlobalPoint Cone::vertex ( ) const

inline

Global position of the cone vertex.

Definition at line 55 of file Cone.h.

References theVertex.

Referenced by Tau.Tau::dxy(), SteppingHelixPropagator::refToMagVolume(), MagGeoBuilderFromDDD::volumeHandle::sameSurface(), and side().

{return theVertex;}

Member Data Documentation

Geom::Theta<Scalar> Cone::theAngle

private

Definition at line 75 of file Cone.h.

Referenced by openingAngle().

GlobalPoint Cone::theVertex

private

Definition at line 74 of file Cone.h.

Referenced by vertex().