DDTransform.h File Reference

#include "DetectorDescription/Core/interface/DDBase.h"
#include "DetectorDescription/Core/interface/DDName.h"
#include "DetectorDescription/Core/interface/DDRotationMatrix.h"
#include <memory>

Go to the source code of this file.

Classes
class	DDRotation
	Represents a uniquely identifyable rotation matrix. More...

Functions
DDRotation	DDanonymousRot (std::unique_ptr< DDRotationMatrix > rot)
	Defines a anonymous rotation or rotation-reflection matrix. More...
std::unique_ptr< DDRotationMatrix >	DDcreateRotationMatrix (double thetaX, double phiX, double thetaY, double phiY, double thetaZ, double phiZ)
	create a new DDRotationMatrix in the GEANT3 style. More...
DDRotation	DDrot (const DDName &name, std::unique_ptr< DDRotationMatrix > rot)
	Definition of a uniquely identifiable rotation matrix named by DDName name. More...
DDRotation	DDrot (const DDName &name, double thetaX, double phiX, double thetaY, double phiY, double thetaZ, double phiZ)
	Definition of a uniquely identifiable rotation matrix named by DDName name in the GEANT3 style. More...
std::unique_ptr< DDRotation >	DDrotPtr (const DDName &name, std::unique_ptr< DDRotationMatrix > rot)
DDRotation	DDrotReflect (const DDName &name, double thetaX, double phiX, double thetaY, double phiY, double thetaZ, double phiZ)
	Defines a rotation-reflection in the Geant3 way. More...
DDRotation	DDrotReflect (const DDName &name, DDRotationMatrix *rot)
std::ostream &	operator<< (std::ostream &, const DDRotation &)

Function Documentation

DDRotation DDanonymousRot

(

std::unique_ptr< DDRotationMatrix >

rot

)

Defines a anonymous rotation or rotation-reflection matrix.

It can't be addressed by a unique DDName. Once created, it's the users responsibility to keep the reference object DDRotation! Will be mostly used by algorithmic positioning.

Definition at line 177 of file DDRotation.cc.

References DDRotation::DDRotation(), and eostools::move().

Referenced by DDTIBLayerAlgo::execute().

{
  return DDRotation( std::move( rot ));
}

std::unique_ptr<DDRotationMatrix> DDcreateRotationMatrix	(	double	thetaX,
		double	phiX,
		double	thetaY,
		double	phiY,
		double	thetaZ,
		double	phiZ
	)

create a new DDRotationMatrix in the GEANT3 style.

The Matrix must be orthonormal - left or right handed - otherwise a DDException is thrown; memory of the returned pointer belongs to the caller

Definition at line 149 of file DDRotation.cc.

References trackerTree::check(), CONVERT_TO, funct::cos(), Exception, connectstrParser::o, funct::sin(), x, y, and z.

Referenced by DDHGCalNoTaperEndcap::createQuarter(), DDTIBLayerAlgo::execute(), and DDAngular::execute().

{
  // define 3 unit std::vectors forming the new left-handed axes 
  DD3Vector x(cos(phiX)*sin(thetaX), sin(phiX)*sin(thetaX), cos(thetaX));
  DD3Vector y(cos(phiY)*sin(thetaY), sin(phiY)*sin(thetaY), cos(thetaY));
  DD3Vector z(cos(phiZ)*sin(thetaZ), sin(phiZ)*sin(thetaZ), cos(thetaZ));
  
  double tol = 1.0e-3; // Geant4 compatible
  double check = (x.Cross(y)).Dot(z);// in case of a LEFT-handed orthogonal system this must be -1, RIGHT-handed: +1
  if ((1.-fabs(check))>tol) {
    std::ostringstream o;
    o << "matrix is not an (left or right handed) orthonormal matrix! (in deg)" << std::endl
      << " thetaX=" << CONVERT_TO( thetaX, deg ) << " phiX=" << CONVERT_TO( phiX, deg ) << std::endl
      << " thetaY=" << CONVERT_TO( thetaY, deg ) << " phiY=" << CONVERT_TO( phiY, deg ) << std::endl
      << " thetaZ=" << CONVERT_TO( thetaZ, deg ) << " phiZ=" << CONVERT_TO( phiZ, deg ) << std::endl;
    edm::LogError("DDRotation") << o.str() << std::endl;
     
    throw cms::Exception("DDException") << o.str();
  }
  
  return std::make_unique<DDRotationMatrix>(x.x(),y.x(),z.x(),
                        x.y(),y.y(),z.y(),
                        x.z(),y.z(),z.z());
}            

DDRotation DDrot	(	const DDName &	ddname,
		std::unique_ptr< DDRotationMatrix >	rot
	)

Definition of a uniquely identifiable rotation matrix named by DDName name.

DDrot() returns a reference-object DDRotation representing the rotation matrix rot.

The user must not free memory allocated for rot!

Definition at line 80 of file DDRotation.cc.

References DDRotation::DDRotation(), and eostools::move().

Referenced by DDPixFwdBlades::computeNippleParameters(), DDHCalBarrelAlgo::constructGeneralVolume(), DDHCalEndcapAlgo::constructGeneralVolume(), DDHGCalNoTaperEndcap::createQuarter(), DDTIDModulePosAlgo::execute(), DDPixBarLayerAlgo::execute(), DDTECOptoHybAlgo::execute(), DDHCalXtalAlgo::execute(), DDHCalTestBeamAlgo::execute(), DDHGCalWafer::execute(), DDHGCalWaferAlgo::execute(), DDTIBLayerAlgo_MTCC::execute(), DDGEMAngular::execute(), DDMuonAngular::execute(), DDPixBarLayerUpgradeAlgo::execute(), DDPixFwdDiskAlgo::execute(), DDPixPhase1FwdDiskAlgo::execute(), DDTIBLayerAlgo::execute(), DDHCalAngular::execute(), DDHCalTBCableAlgo::execute(), DDHCalTBZposAlgo::execute(), DDTIDRingAlgo::execute(), DDTrackerAngular::execute(), DDTECPhiAlgo::execute(), DDTrackerPhiAlgo::execute(), DDTIDAxialCableAlgo::execute(), DDTECAxialCableAlgo::execute(), DDTrackerPhiAltAlgo::execute(), DDTECPhiAltAlgo::execute(), DDHCalFibreBundle::execute(), DDTrackerAngularV1::execute(), DDLinear::execute(), DDAngular::execute(), DDTrackerRingAlgo::execute(), DDPixFwdBlades::execute(), DDDividedTubsPhi::makeDDRotation(), DDDividedConsPhi::makeDDRotation(), DDDividedPolyconePhi::makeDDRotation(), DDDividedPolyhedraPhi::makeDDRotation(), DDTBH4Algo::myrot(), DDEcalBarrelNewAlgo::myrot(), DDEcalBarrelAlgo::myrot(), DDEcalEndcapAlgo::myrot(), DDLRotationSequence::processElement(), DDLRotationByAxis::processElement(), DDLRotationAndReflection::processElement(), regressionTest_first(), and regressionTest_setup().

{
   // memory of rot goes sto DDRotationImpl!!
  return DDRotation(ddname, std::move( rot ));
}

DDRotation DDrot	(	const DDName &	name,
		double	thetaX,
		double	phiX,
		double	thetaY,
		double	phiY,
		double	thetaZ,
		double	phiZ
	)

Definition of a uniquely identifiable rotation matrix named by DDName name in the GEANT3 style.

DDrot() returns a reference-object DDRotation representing the rotation matrix.

Definition at line 94 of file DDRotation.cc.

References trackerTree::check(), funct::cos(), DDRotation::DDRotation(), Exception, DDName::name(), funct::sin(), x, y, and z.

{
   // define 3 unit std::vectors
  DD3Vector x(cos(phiX)*sin(thetaX), sin(phiX)*sin(thetaX), cos(thetaX));
  DD3Vector y(cos(phiY)*sin(thetaY), sin(phiY)*sin(thetaY), cos(thetaY));
  DD3Vector z(cos(phiZ)*sin(thetaZ), sin(phiZ)*sin(thetaZ), cos(thetaZ));
  
  double tol = 1.0e-3; // Geant4 compatible
  double check = (x.Cross(y)).Dot(z); // in case of a LEFT-handed orthogonal system this must be -1
  if (fabs(1.-check)>tol) {
    edm::LogError("DDRotation") << ddname << " is not a RIGHT-handed orthonormal matrix!" << std::endl;
    throw cms::Exception("DDException") << ddname.name() << " is not RIGHT-handed!";
  }
  
  return DDRotation( ddname,
             std::make_unique<DDRotationMatrix>(x.x(),y.x(),z.x(),
                            x.y(),y.y(),z.y(),
                            x.z(),y.z(),z.z()));
}

std::unique_ptr<DDRotation> DDrotPtr	(	const DDName &	name,
		std::unique_ptr< DDRotationMatrix >	rot
	)

Definition at line 87 of file DDRotation.cc.

References DDBase< DDName, std::unique_ptr< DDRotationMatrix > >::ddname(), and eostools::move().

Referenced by DDLPosPart::processElement().

{
   // memory of rot goes sto DDRotationImpl!!
  return std::make_unique<DDRotation>( ddname, std::move( rot ));
}

DDRotation DDrotReflect	(	const DDName &	ddname,
		double	thetaX,
		double	phiX,
		double	thetaY,
		double	phiY,
		double	thetaZ,
		double	phiZ
	)

Defines a rotation-reflection in the Geant3 way.

The resulting matrix MUST be a LEFThanded orthonormal system, otherwise a DDException will be thrown!

Definition at line 124 of file DDRotation.cc.

References trackerTree::check(), funct::cos(), DDRotation::DDRotation(), Exception, DDName::name(), funct::sin(), x, y, and z.

Referenced by DDLRotationAndReflection::processElement().

{
  // define 3 unit std::vectors forming the new left-handed axes 
  DD3Vector x(cos(phiX)*sin(thetaX), sin(phiX)*sin(thetaX), cos(thetaX));
  DD3Vector y(cos(phiY)*sin(thetaY), sin(phiY)*sin(thetaY), cos(thetaY));
  DD3Vector z(cos(phiZ)*sin(thetaZ), sin(phiZ)*sin(thetaZ), cos(thetaZ));
  
  double tol = 1.0e-3; // Geant4 compatible
  double check = (x.Cross(y)).Dot(z); // in case of a LEFT-handed orthogonal system this must be -1
  if (fabs(1.+check)>tol) {
    edm::LogError("DDRotation") << ddname << " is not a LEFT-handed orthonormal matrix!" << std::endl;
    throw cms::Exception("DDException") << ddname.name() << " is not LEFT-handed!";
  }
  
  return DDRotation( ddname,
             std::make_unique<DDRotationMatrix>(x.x(),y.x(),z.x(),
                            x.y(),y.y(),z.y(),
                            x.z(),y.z(),z.z()));  
}       

DDRotation DDrotReflect	(	const DDName &	name,
		DDRotationMatrix *	rot
	)

std::ostream& operator<<	(	std::ostream &	,
		const DDRotation &
	)

Definition at line 21 of file DDRotation.cc.

References CONVERT_TO, DDBase< N, C >::isDefined(), submit::rm, and DDRotation::rotation().

{
  DDBase<DDName,DDRotationMatrix*>::def_type defined(r.isDefined());
  if (defined.first) {
    os << *(defined.first) << " ";
    if (defined.second) {
      const DDRotationMatrix & rm = r.rotation();
      DDAxisAngle   ra(rm);
      os << "t=" << CONVERT_TO( ra.Axis().Theta(), deg ) << "deg "
         << "p=" << CONVERT_TO( ra.Axis().Phi(), deg ) << "deg "
     << "a=" << CONVERT_TO( ra.Angle(), deg ) << "deg"; 
    }
    else {
      os << "* rotation not defined * ";  
    }
  }  
  else {
    os << "* rotation not declared * ";  
  }  
  return os;
}