JGEOMETRY3D Namespace Reference

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	JCenter3D
	Center. 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	JOmega3D
	Direction set covering (part of) solid angle. More...
struct	JOmega3D_t
	Base class for direction set. 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...
class	JQuaternion3D
	Data structure for unit quaternion in three dimensions. 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	JRotation3D
	Rotation matrix. More...
class	JRotation3X
	Rotation around X-axis. More...
class	JRotation3Y
	Rotation around Y-axis. More...
class	JRotation3Z
	Rotation around Z-axis. More...
class	JRotator3D
	Rotation set. More...
class	JSegment3D
	Line segment in two dimensions. More...
class	JSmallestDistance3D
	Auxiliary class for determination of smallest distance between pair of 3D points. 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...
class	JWeighedCenter3D
	Weighed center. More...

Typedefs
typedef std::vector< JRotation3D >	JRotator3D_t
	Type definition of rotation set.
typedef std::pair< JPosition3D, JPosition3D >	JSegment3D_t
	Type definition of line segment in two dimensions.
typedef JTrack3D	JShower3D
	Type definition of 3D shower.
typedef JTrack3E	JShower3E
	Type definition of 3D shower with energy.
typedef JTrack3EY	JShower3EY
	Type definition of 3D shower with energy and Bjorken Y.
typedef std::pair< double, double >	JRangeZ
	< Type definition of range along y-axis.

Functions
void	randomize (JPosition3D *p)
	Randomize position.
void	randomize (JDirection3D *p)
	Randomize direction.
void	randomize (JQuaternion3D *p)
	Randomize quaternion.
void	randomize (JEulerAngle3D *p)
	Randomize Euler angle.
void	randomize (JEulerMatrix3D *p)
	Randomize Euler matrix.
JVector3D	getRandomPosition (const JSphere3D &sphere)
	Get random position.
JVector3D	getRandomPosition (const JCylinder3D &cylinder)
	Get random position.
double	getAngle (const JQuaternion3D &first, const JQuaternion3D &second)
	Get space angle between quanternions.

Variables
static const JSmallestDistance3D	getSmallestDistance3D
	Function object for smallest distance determination.
static const JVector3D	JVector3X_t (1, 0, 0)
	unit x-vector
static const JVector3D	JVector3Y_t (0, 1, 0)
	unit y-vector
static const JVector3D	JVector3Z_t (0, 0, 1)
	unit z-vector
static const JVersor3D	JVersor3X_t (1, 0, 0)
	unit x-vector
static const JVersor3D	JVersor3Y_t (0, 1, 0)
	unit y-vector
static const JVersor3D	JVersor3Z_t (0, 0, 1)
	unit z-vector

Detailed Description

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

Author

mdejong

mjongen

mdejong, adomi

Typedef Documentation

JRotator3D_t

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

Type definition of rotation set.

Definition at line 23 of file JRotator3D.hh.

JSegment3D_t

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

Type definition of line segment in two dimensions.

Definition at line 27 of file JSegment3D.hh.

JShower3D

typedef JTrack3D JGEOMETRY3D::JShower3D

Type definition of 3D shower.

Definition at line 19 of file JShower3D.hh.

JShower3E

typedef JTrack3E JGEOMETRY3D::JShower3E

Type definition of 3D shower with energy.

Definition at line 19 of file JShower3E.hh.

JShower3EY

typedef JTrack3EY JGEOMETRY3D::JShower3EY

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

Definition at line 19 of file JShower3EY.hh.

JRangeZ

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

randomize() [1/5]

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));
  };

randomize() [2/5]

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);
  };

randomize() [3/5]

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));
  }

randomize() [4/5]

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));
  }

randomize() [5/5]

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>());
  }

getRandomPosition() [1/2]

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);
  }

getRandomPosition() [2/2]

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);
  }

getAngle()

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

getSmallestDistance3D

const JSmallestDistance3D JGEOMETRY3D::getSmallestDistance3D

static

Function object for smallest distance determination.

Definition at line 246 of file JGeometry3DToolkit.hh.

JVector3X_t

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

static

unit x-vector

JVector3Y_t

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

static

unit y-vector

JVector3Z_t

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

static

unit z-vector

JVersor3X_t

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

static

unit x-vector

JVersor3Y_t

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

static

unit y-vector

JVersor3Z_t

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

static

unit z-vector