Auxiliary classes and methods for 3D geometrical objects and operations. More...

Classes
class	JAngle3D
	Data structure for angles in three dimensions. More...

class	JAxis3D
	Axis object. More...

class	JCylinder3D
	Cylinder object. More...

class	JDirection3D
	Data structure for direction in three dimensions. More...

struct	JEigenValues3D
	Eigen values in 3D. More...

class	JEulerAngle3D
	Data structure for Euler angles in three dimensions. More...

class	JEulerMatrix3D
	Euler matrix. More...

class	JCenter3D
	Center. More...

class	JWeighedCenter3D
	Weighed center. More...

class	JSmallestDistance3D
	Auxiliary class for determination of smallest distance between pair of 3D points. More...

struct	JOmega3D_t
	Base class for direction set. More...

class	JOmega3D
	Direction set covering (part of) solid angle. More...

class	JPolyline3D
	Data structure for polyline in three dimensions. More...

class	JPosition3D
	Data structure for position in three dimensions. More...

struct	JQuaternion2D
	This class represents a rotation. More...

struct	JQuaternion3X
	This class represents a rotation around the x-axis. More...

struct	JQuaternion3Y
	This class represents a rotation around the y-axis. More...

struct	JQuaternion3Z
	This class represents a rotation around the z-axis. More...

class	JQuaternion3D
	Data structure for unit quaternion in three dimensions. More...

class	JRotation3X
	Rotation around X-axis. More...

class	JRotation3Y
	Rotation around Y-axis. More...

class	JRotation3Z
	Rotation around Z-axis. More...

class	JRotation3D
	Rotation matrix. More...

class	JRotator3D
	Rotation set. More...

class	JSegment3D
	Line segment in two dimensions. More...

class	JSphere3D
	3D sphere. More...

class	JTime
	Time. More...

class	JTrack3D
	3D track. More...

class	JTrack3E
	3D track with energy. More...

class	JTrack3EY
	3D track with energy and Bjorken Y. More...

struct	JTransformation3D
	Transformation. More...

class	JVector3D
	Data structure for vector in three dimensions. More...

class	JVersor3D
	Data structure for normalised vector in three dimensions. More...

class	JVersor3Z
	Data structure for normalised vector in positive z-direction. More...

class	JVertex3D
	3D vertex. More...

Typedefs
typedef std::vector< JRotation3D >	JRotator3D_t
	Type definition of rotation set. More...

typedef std::pair< JPosition3D, JPosition3D >	JSegment3D_t
	Type definition of line segment in two dimensions. More...

typedef JTrack3D	JShower3D
	Type definition of 3D shower. More...

typedef JTrack3E	JShower3E
	Type definition of 3D shower with energy. More...

typedef JTrack3EY	JShower3EY
	Type definition of 3D shower with energy and Bjorken Y. More...

typedef std::pair< double, double >	JRangeZ
	< Type definition of range along y-axis. More...

Functions
void	randomize (JPosition3D *p)
	Randomize position. More...

void	randomize (JDirection3D *p)
	Randomize direction. More...

void	randomize (JQuaternion3D *p)
	Randomize quaternion. More...

void	randomize (JEulerAngle3D *p)
	Randomize Euler angle. More...

void	randomize (JEulerMatrix3D *p)
	Randomize Euler matrix. More...

JVector3D	getRandomPosition (const JSphere3D &sphere)
	Get random position. More...

JVector3D	getRandomPosition (const JCylinder3D &cylinder)
	Get random position. More...

const JCylinder3D	getMaximumContainmentVolume ()
	Auxiliary function to retrieve the maximum cylindrical containment volume. More...

double	getAngle (const JQuaternion3D &first, const JQuaternion3D &second)
	Get space angle between quanternions. More...

Variables
static const JSmallestDistance3D	getSmallestDistance3D
	Function object for smallest distance determination. More...

static const JVector3D	JVector3X_t (1, 0, 0)
	unit x-vector More...

static const JVector3D	JVector3Y_t (0, 1, 0)
	unit y-vector More...

static const JVector3D	JVector3Z_t (0, 0, 1)
	unit z-vector More...

static const JVersor3D	JVersor3X_t (1, 0, 0)
	unit x-vector More...

static const JVersor3D	JVersor3Y_t (0, 1, 0)
	unit y-vector More...

static const JVersor3D	JVersor3Z_t (0, 0, 1)
	unit z-vector More...

Detailed Description

Auxiliary classes and methods for 3D geometrical objects and operations.

Author: mdejong; mjongen; mdejong, adomi

Typedef Documentation

typedef std::vector<JRotation3D> JGEOMETRY3D::JRotator3D_t

Type definition of rotation set.

Definition at line 23 of file JRotator3D.hh.

typedef std::pair<JPosition3D, JPosition3D> JGEOMETRY3D::JSegment3D_t

Type definition of line segment in two dimensions.

Definition at line 27 of file JSegment3D.hh.

typedef JTrack3D JGEOMETRY3D::JShower3D

Type definition of 3D shower.

Definition at line 19 of file JShower3D.hh.

typedef JTrack3E JGEOMETRY3D::JShower3E

Type definition of 3D shower with energy.

Definition at line 19 of file JShower3E.hh.

typedef JTrack3EY JGEOMETRY3D::JShower3EY

Type definition of 3D shower with energy and Bjorken Y.

Definition at line 19 of file JShower3EY.hh.

typedef std::pair<double, double> JGEOMETRY3D::JRangeZ

< Type definition of range along y-axis.

Type definition of range along z-axis.

Definition at line 26 of file JVector3D.hh.

Function Documentation

void JGEOMETRY3D::randomize ( JPosition3D * p )

inline

Randomize position.

Parameters

p	pointer to valid object

Definition at line 34 of file JGeometry3DTestkit.hh.

   {
     new (p) JPosition3D(getRandom<double>(-1.0, +1.0),
                         getRandom<double>(-1.0, +1.0),
                         getRandom<double>(-1.0, +1.0));
   };

void JGEOMETRY3D::randomize ( JDirection3D * p )

inline

Randomize direction.

Parameters

p	pointer to valid object

Definition at line 47 of file JGeometry3DTestkit.hh.

   {
     double x, y, z;
 
     gRandom->Sphere(x, y, z, 1.0);
 
     new (p) JDirection3D(x, y, z);
   };

void JGEOMETRY3D::randomize ( JQuaternion3D * p )

inline

Randomize quaternion.

Parameters

p	pointer to valid object

Definition at line 62 of file JGeometry3DTestkit.hh.

   {
     double x, y, z;
 
     gRandom->Sphere(x, y, z, 1.0);
 
     const double alpha = getRandom<double>(-2.0*PI, +2.0*PI);
 
     new (p) JQuaternion3D(alpha, JVersor3D(x, y, z));
   }

void JGEOMETRY3D::randomize ( JEulerAngle3D * p )

inline

Randomize Euler angle.

Parameters

p	pointer to valid object

Definition at line 79 of file JGeometry3DTestkit.hh.

   {
     new (p) JEulerAngle3D(getRandom<double>(0.0, PI),
                           getRandom<double>(0.0, PI),
                           getRandom<double>(0.0, PI));
   }

void JGEOMETRY3D::randomize ( JEulerMatrix3D * p )

inline

Randomize Euler matrix.

Parameters

p	pointer to valid object

Definition at line 92 of file JGeometry3DTestkit.hh.

   {
     new (p) JEulerMatrix3D(getRandom<JEulerAngle3D>());
   }

JVector3D JGEOMETRY3D::getRandomPosition ( const JSphere3D & sphere )

inline

Get random position.

The positions are uniformly distributed in given sphere.

Parameters

sphere sphere

Returns: position

Definition at line 105 of file JGeometry3DTestkit.hh.

   {
     const double R3max = sphere.getRadius() * sphere.getRadius() * sphere.getRadius();
 
     const double R3  = gRandom->Uniform(0.0, R3max);
     const double ct  = gRandom->Uniform(-1.0, +1.0);
     const double phi = gRandom->Uniform(-PI, +PI);
     
     const double R   = cbrt(R3);
     const double st  = sqrt((1.0 + ct) * (1.0 - ct));
 
     return sphere.getPosition() + JVector3D(R * st * cos(phi),
                                             R * st * sin(phi),
                                             R * ct);
   }

JVector3D JGEOMETRY3D::getRandomPosition ( const JCylinder3D & cylinder )

inline

Get random position.

The positions are uniformly distributed in given cylinder.

Parameters

cylinder cylinder

Returns: position

Definition at line 129 of file JGeometry3DTestkit.hh.

   {
     const double R2max = cylinder.getRadius() * cylinder.getRadius();
 
     const double R2  = gRandom->Uniform(0.0, R2max);
     const double phi = gRandom->Uniform(-PI, +PI);
     const double z   = gRandom->Uniform(cylinder.getZmin(), cylinder.getZmax());
 
     const double R   = sqrt(R2);
 
     return JVector3D(cylinder.getX()  +  R * cos(phi),
                      cylinder.getY()  +  R * sin(phi),
                      z);
   }

const JCylinder3D JGEOMETRY3D::getMaximumContainmentVolume ( )

inline

Auxiliary function to retrieve the maximum cylindrical containment volume.

Returns: maximum cylindrical containment volume

Definition at line 250 of file JGeometry3DToolkit.hh.

   {
     using namespace JPP;
 
     const double R_Earth = R_EARTH_KM * 1e3; // m
     
     const JVector2D center(0.0, 0.0);
     const JCircle2D circle(center, R_Earth);
     
     return JCylinder3D(circle, -R_Earth, R_Earth);
   }

double JGEOMETRY3D::getAngle	(	const JQuaternion3D &	first,
		const JQuaternion3D &	second
	)

inline

Get space angle between quanternions.

Parameters

first	first quanternion
second	second quanternion

Returns: angle [deg]

Definition at line 1165 of file JQuaternion3D.hh.

   {
     double dot = (first.getA() * second.getA()  +
                   first.getB() * second.getB()  +
                   first.getC() * second.getC()  +
                   first.getD() * second.getD());
     
     dot = 2.0 * dot * dot  -  1.0;
 
     if      (dot > +1.0)
       return   0.0;
     else if (dot < -1.0)
       return 180.0;
     else
       return 0.5 * acos(dot) * 180.0 / JMATH::PI;
   }

Variable Documentation

const JSmallestDistance3D JGEOMETRY3D::getSmallestDistance3D

static

Function object for smallest distance determination.

Definition at line 266 of file JGeometry3DToolkit.hh.

const JVector3D JGEOMETRY3D::JVector3X_t(1, 0, 0)

static

unit x-vector

const JVector3D JGEOMETRY3D::JVector3Y_t(0, 1, 0)

static

unit y-vector

const JVector3D JGEOMETRY3D::JVector3Z_t(0, 0, 1)

static

unit z-vector

const JVersor3D JGEOMETRY3D::JVersor3X_t(1, 0, 0)

static

unit x-vector

const JVersor3D JGEOMETRY3D::JVersor3Y_t(0, 1, 0)

static

unit y-vector

const JVersor3D JGEOMETRY3D::JVersor3Z_t(0, 0, 1)

static

unit z-vector

Classes

Typedefs

Functions

Variables

Detailed Description

Typedef Documentation

Function Documentation

Variable Documentation