AlignableDetUnit Class Reference

#include <AlignableDetUnit.h>

Inheritance diagram for AlignableDetUnit:

Public Member Functions
virtual void	addAlignmentPositionError (const AlignmentPositionError &ape, bool)
virtual void	addAlignmentPositionErrorFromLocalRotation (const RotationType &rot, bool)
virtual void	addAlignmentPositionErrorFromRotation (const RotationType &rot, bool)
virtual void	addComponent (Alignable *)
	No components here => exception! More...
virtual void	addSurfaceDeformation (const SurfaceDeformation *deformation, bool)
	Add surface deformation parameters to the existing ones (2nd argument without effect) More...
	AlignableDetUnit (const GeomDetUnit *geomDetUnit)
	Constructor from GeomDetUnit - must not be NULL pointer! More...
virtual StructureType	alignableObjectId () const
	Return the alignable type identifier. More...
virtual AlignmentErrors *	alignmentErrors () const
	Return vector of alignment errors. More...
const AlignmentPositionError *	alignmentPositionError () const
	alignment position error - for checking only, otherwise use alignmentErrors() above! More...
virtual Alignments *	alignments () const
	Return vector of alignment data. More...
virtual Alignables	components () const
	Returns a null vector (no components here) More...
virtual void	dump () const
	Printout information about GeomDet. More...
virtual void	move (const GlobalVector &displacement)
	Move with respect to the global reference frame. More...
virtual void	recursiveComponents (Alignables &result) const
	Do nothing (no components here, so no subcomponents either...) More...
virtual void	rotateInGlobalFrame (const RotationType &rotation)
	Rotation with respect to the global reference frame. More...
virtual void	setAlignmentPositionError (const AlignmentPositionError &ape, bool)
	Set the AlignmentPositionError (no components => second argument ignored) More...
virtual void	setSurfaceDeformation (const SurfaceDeformation *deformation, bool)
	Set surface deformation parameters (2nd argument without effect) More...
virtual int	surfaceDeformationIdPairs (std::vector< std::pair< int, SurfaceDeformation * > > &) const
	Return surface deformations. More...
virtual	~AlignableDetUnit ()
	Destructor. More...
Public Member Functions inherited from Alignable
	Alignable (align::ID, const AlignableSurface &)
	Alignable (align::ID, const RotationType &)
AlignmentParameters *	alignmentParameters () const
	Get the AlignmentParameters. More...
const Alignables &	deepComponents () const
const GlobalVector &	displacement () const
	Return change of the global position since the creation of the object. More...
bool	firstCompsWithParams (Alignables &paramComps) const
const DetId &	geomDetId () const
const PositionType &	globalPosition () const
	Return the global position of the object. More...
const RotationType &	globalRotation () const
	Return the global orientation of the object. More...
align::ID	id () const
	Return the ID of Alignable, i.e. DetId of 'first' component GeomDet(Unit). More...
Alignable *	mother () const
	Return pointer to container alignable (if any) More...
virtual void	rotateAroundGlobalAxis (const GlobalVector &axis, Scalar radians)
	Rotation around arbitratry global axis. More...
virtual void	rotateAroundGlobalX (Scalar radians)
	Rotation around global x-axis. More...
virtual void	rotateAroundGlobalY (Scalar radians)
	Rotation around global y-axis. More...
virtual void	rotateAroundGlobalZ (Scalar radians)
	Rotation around global z-axis. More...
virtual void	rotateAroundLocalAxis (const LocalVector &axis, Scalar radians)
	Rotation around arbitratry local axis. More...
virtual void	rotateAroundLocalX (Scalar radians)
	Rotation around local x-axis. More...
virtual void	rotateAroundLocalY (Scalar radians)
	Rotation around local y-axis. More...
virtual void	rotateAroundLocalZ (Scalar radians)
	Rotation around local z-axis. More...
virtual void	rotateInLocalFrame (const RotationType &rotation)
	Rotation intepreted in the local reference frame. More...
const RotationType &	rotation () const
	Return change of orientation since the creation of the object. More...
void	setAlignmentParameters (AlignmentParameters *dap)
	Set the AlignmentParameters. More...
void	setMother (Alignable *mother)
	Assign mother to alignable. More...
void	setSurvey (const SurveyDet *)
	Set survey info. More...
const int	size () const
	Return number of direct components. More...
const AlignableSurface &	surface () const
	Return the Surface (global position and orientation) of the object. More...
AlignmentSurfaceDeformations *	surfaceDeformations () const
	Return surface deformations, sorted by DetId. More...
const SurveyDet *	survey () const
	Return survey info. More...
virtual	~Alignable ()
	Destructor. More...

Private Attributes
AlignmentPositionError *	theAlignmentPositionError
SurfaceDeformation *	theSurfaceDeformation

Additional Inherited Members
Public Types inherited from Alignable
typedef align::Alignables	Alignables
typedef align::GlobalVector	GlobalVector
typedef align::LocalVector	LocalVector
typedef align::PositionType	PositionType
typedef align::RotationType	RotationType
typedef align::Scalar	Scalar
typedef align::StructureType	StructureType
Protected Member Functions inherited from Alignable
void	addDisplacement (const GlobalVector &displacement)
void	addRotation (const RotationType &rotation)
Protected Attributes inherited from Alignable
Alignables	theDeepComponents
DetId	theDetId
GlobalVector	theDisplacement
align::ID	theId
RotationType	theRotation
AlignableSurface	theSurface

Detailed Description

A concrete class that allows to (mis)align a DetUnit.

Typically all AlignableComposites have (directly or indirectly) this one as the ultimate component.

Definition at line 13 of file AlignableDetUnit.h.

Constructor & Destructor Documentation

AlignableDetUnit::AlignableDetUnit

(

const GeomDetUnit *

geomDetUnit

)

Constructor from GeomDetUnit - must not be NULL pointer!

Definition at line 15 of file AlignableDetUnit.cc.

References GeomDet::alignmentPositionError(), setAlignmentPositionError(), setSurfaceDeformation(), GeomDetUnit::surfaceDeformation(), and Alignable::theDeepComponents.

                                                                 : // rely on non-NULL pointer!
  Alignable(geomDetUnit->geographicalId().rawId(), geomDetUnit->surface()),
  theAlignmentPositionError(0),
  theSurfaceDeformation(0)
{
  if (geomDetUnit->alignmentPositionError()) { // take over APE from geometry
    // 2nd argument w/o effect:
    this->setAlignmentPositionError(*(geomDetUnit->alignmentPositionError()), false);
  }

  if (geomDetUnit->surfaceDeformation()) { // take over surface modification
    // 2nd argument w/o effect:
    this->setSurfaceDeformation(geomDetUnit->surfaceDeformation(), false);
  }
  
  theDeepComponents.push_back(this);

}

AlignableDetUnit::~AlignableDetUnit ( )

virtual

Destructor.

Definition at line 35 of file AlignableDetUnit.cc.

References theAlignmentPositionError, and theSurfaceDeformation.

{
  delete theAlignmentPositionError;
  delete theSurfaceDeformation;
}

Member Function Documentation

void AlignableDetUnit::addAlignmentPositionError ( const AlignmentPositionError &  ape, bool  propagateDown  )

virtual

Add (or set if it does not exist yet) the AlignmentPositionError (no components => second argument without effect)

Implements Alignable.

Definition at line 82 of file AlignableDetUnit.cc.

References setAlignmentPositionError(), and theAlignmentPositionError.

Referenced by addAlignmentPositionErrorFromRotation().

{

  if ( !theAlignmentPositionError )
    this->setAlignmentPositionError( ape, propagateDown ); // 2nd argument w/o effect
  else 
    *theAlignmentPositionError += ape;
}

void AlignableDetUnit::addAlignmentPositionErrorFromLocalRotation ( const RotationType &  rot, bool  propagateDown  )

virtual

Add (or set if it does not exist yet) the AlignmentPositionError resulting from a rotation in the local reference frame (no components => second argument without effect)

Implements Alignable.

Definition at line 114 of file AlignableDetUnit.cc.

References addAlignmentPositionErrorFromRotation(), Alignable::globalRotation(), and TkRotation< T >::multiplyInverse().

{

  RotationType globalRot = globalRotation().multiplyInverse(rot*globalRotation());
  this->addAlignmentPositionErrorFromRotation(globalRot, propagateDown); // 2nd argument w/o effect

}

void AlignableDetUnit::addAlignmentPositionErrorFromRotation ( const RotationType &  rot, bool  propagateDown  )

virtual

Add (or set if it does not exist yet) the AlignmentPositionError resulting from a rotation in the global reference frame (no components => second argument without effect)

Implements Alignable.

Definition at line 94 of file AlignableDetUnit.cc.

References addAlignmentPositionError(), PV3DBase< T, PVType, FrameType >::basicVector(), TkRotation< T >::multiplyInverse(), Alignable::surface(), AlignableSurface::toGlobal(), and tablePrinter::width.

Referenced by addAlignmentPositionErrorFromLocalRotation().

{

  // average error calculated by movement of a local point at
  // (xWidth/2,yLength/2,0) caused by the rotation rot
  GlobalVector localPositionVector = surface().toGlobal( LocalVector(.5 * surface().width(),
                                     .5 * surface().length(),
                                     0.) );

  LocalVector::BasicVectorType lpvgf = localPositionVector.basicVector();
  GlobalVector gv( rot.multiplyInverse(lpvgf) - lpvgf );

  AlignmentPositionError  ape( gv.x(),gv.y(),gv.z() );
  this->addAlignmentPositionError( ape, propagateDown ); // 2nd argument w/o effect

}

void AlignableDetUnit::addComponent ( Alignable *  )

virtual

No components here => exception!

Implements Alignable.

Definition at line 42 of file AlignableDetUnit.cc.

References edm::hlt::Exception.

{
  throw cms::Exception("LogicError") 
    << "AlignableDetUnit cannot have components, but try to add one!";
}

void AlignableDetUnit::addSurfaceDeformation ( const SurfaceDeformation *  deformation, bool  propagateDown  )

virtual

Add surface deformation parameters to the existing ones (2nd argument without effect)

Implements Alignable.

Definition at line 136 of file AlignableDetUnit.cc.

References SurfaceDeformation::add(), setSurfaceDeformation(), theSurfaceDeformation, and SurfaceDeformation::type().

{
  if (!deformation) {
    // nothing to do
  } else if (!theSurfaceDeformation) {
    this->setSurfaceDeformation(deformation, propagateDown); // fine since no components
  } else if (!theSurfaceDeformation->add(*deformation)) {
    edm::LogError("Alignment") << "@SUB=AlignableDetUnit::addSurfaceDeformation"
                   << "Cannot add deformation type " << deformation->type()
                   << " to type " << theSurfaceDeformation->type()
                   << ", so erase deformation information.";
    delete theSurfaceDeformation;
    theSurfaceDeformation = 0;
  }
}

virtual StructureType AlignableDetUnit::alignableObjectId ( ) const

inlinevirtual

Return the alignable type identifier.

Implements Alignable.

Definition at line 62 of file AlignableDetUnit.h.

References align::AlignableDetUnit.

{ return align::AlignableDetUnit; }

AlignmentErrors * AlignableDetUnit::alignmentErrors ( void  ) const

virtual

Return vector of alignment errors.

Implements Alignable.

Definition at line 191 of file AlignableDetUnit.cc.

References Alignable::geomDetId(), AlignmentPositionError::globalError(), AlignmentErrors::m_alignError, GlobalErrorBase< T, ErrorWeightType >::matrix(), DetId::rawId(), and theAlignmentPositionError.

{
  
  AlignmentErrors* m_alignmentErrors = new AlignmentErrors();
  
  uint32_t detId = this->geomDetId().rawId();
 
  CLHEP::HepSymMatrix clhepSymMatrix(3,0);
  if ( theAlignmentPositionError ) // Might not be set
    clhepSymMatrix = theAlignmentPositionError->globalError().matrix();
  
  AlignTransformError transformError( clhepSymMatrix, detId );
  
  m_alignmentErrors->m_alignError.push_back( transformError );
  
  return m_alignmentErrors;

}

const AlignmentPositionError* AlignableDetUnit::alignmentPositionError ( ) const

inline

alignment position error - for checking only, otherwise use alignmentErrors() above!

Definition at line 77 of file AlignableDetUnit.h.

References theAlignmentPositionError.

Referenced by AlignableDetOrUnitPtr::alignmentPositionError().

{ return theAlignmentPositionError;}

Alignments * AlignableDetUnit::alignments ( void  ) const

virtual

Return vector of alignment data.

Implements Alignable.

Definition at line 167 of file AlignableDetUnit.cc.

References Alignable::geomDetId(), Alignable::globalPosition(), Alignable::globalRotation(), Alignments::m_align, DetId::rawId(), x, TkRotation< T >::xx(), TkRotation< T >::xy(), TkRotation< T >::xz(), detailsBasic3DVector::y, TkRotation< T >::yx(), TkRotation< T >::yy(), TkRotation< T >::yz(), detailsBasic3DVector::z, TkRotation< T >::zx(), TkRotation< T >::zy(), and TkRotation< T >::zz().

{

  Alignments* m_alignments = new Alignments();
  RotationType rot( this->globalRotation() );
  
  // Get alignments (position, rotation, detId)
  CLHEP::Hep3Vector clhepVector( globalPosition().x(), globalPosition().y(), globalPosition().z() );
  CLHEP::HepRotation clhepRotation( CLHEP::HepRep3x3( rot.xx(), rot.xy(), rot.xz(),
                                        rot.yx(), rot.yy(), rot.yz(),
                                        rot.zx(), rot.zy(), rot.zz() ) );
  uint32_t detId = this->geomDetId().rawId();
  
  AlignTransform transform( clhepVector, clhepRotation, detId );

  // Add to alignments container
  m_alignments->m_align.push_back( transform );

  return m_alignments;

}

virtual Alignables AlignableDetUnit::components ( ) const

inlinevirtual

Returns a null vector (no components here)

Implements Alignable.

Definition at line 28 of file AlignableDetUnit.h.

{ return Alignables(); }

void AlignableDetUnit::dump ( void  ) const

virtual

Printout information about GeomDet.

Implements Alignable.

Definition at line 154 of file AlignableDetUnit.cc.

References Alignable::displacement(), Alignable::globalPosition(), Alignable::globalRotation(), and Alignable::rotation().

{

  edm::LogInfo("AlignableDump") 
    << " AlignableDetUnit has position = " << this->globalPosition() 
    << ", orientation:" << std::endl << this->globalRotation() << std::endl
    << " total displacement and rotation: " << this->displacement() << std::endl
    << this->rotation();

}

void AlignableDetUnit::move ( const GlobalVector &  displacement )

virtual

Move with respect to the global reference frame.

Implements Alignable.

Definition at line 49 of file AlignableDetUnit.cc.

References Alignable::addDisplacement(), GloballyPositioned< T >::move(), and Alignable::theSurface.

Referenced by python.Vispa.Gui.WidgetContainer.WidgetContainer::autosize(), python.Vispa.Gui.VispaWidget.VispaWidget::dragWidget(), python.Vispa.Gui.VispaWidget.VispaWidget::setZoom(), and python.Vispa.Gui.PortConnection.PointToPointConnection::updateConnection().

{
  
  theSurface.move( displacement );
  this->addDisplacement( displacement );

}

virtual void AlignableDetUnit::recursiveComponents ( Alignables &  result ) const

inlinevirtual

Do nothing (no components here, so no subcomponents either...)

Implements Alignable.

Definition at line 31 of file AlignableDetUnit.h.

{}

void AlignableDetUnit::rotateInGlobalFrame ( const RotationType &  rotation )

virtual

Rotation with respect to the global reference frame.

Implements Alignable.

Definition at line 59 of file AlignableDetUnit.cc.

References Alignable::addRotation(), GloballyPositioned< T >::rotate(), and Alignable::theSurface.

{
  
  theSurface.rotate( rotation );
  this->addRotation( rotation );
  
}

void AlignableDetUnit::setAlignmentPositionError ( const AlignmentPositionError &  ape, bool    )

virtual

Set the AlignmentPositionError (no components => second argument ignored)

Implements Alignable.

Definition at line 69 of file AlignableDetUnit.cc.

References theAlignmentPositionError.

Referenced by addAlignmentPositionError(), and AlignableDetUnit().

{

  if ( !theAlignmentPositionError ) 
    theAlignmentPositionError = new AlignmentPositionError( ape );
  else
    *theAlignmentPositionError = ape;

}

void AlignableDetUnit::setSurfaceDeformation ( const SurfaceDeformation *  deformation, bool    )

virtual

Set surface deformation parameters (2nd argument without effect)

Implements Alignable.

Definition at line 124 of file AlignableDetUnit.cc.

References SurfaceDeformation::clone(), and theSurfaceDeformation.

Referenced by addSurfaceDeformation(), and AlignableDetUnit().

{
  delete theSurfaceDeformation; // OK for zero pointers
  if (deformation) {
    theSurfaceDeformation = deformation->clone();
  } else {
    theSurfaceDeformation = 0;
  }
}

int AlignableDetUnit::surfaceDeformationIdPairs ( std::vector< std::pair< int, SurfaceDeformation * > > &  result ) const

virtual

Return surface deformations.

Implements Alignable.

Definition at line 212 of file AlignableDetUnit.cc.

References Alignable::geomDetId(), query::result, and theSurfaceDeformation.

{
  if ( theSurfaceDeformation ) {
    result.push_back( std::pair<int,SurfaceDeformation*>(this->geomDetId().rawId(),theSurfaceDeformation) );
    return 1;
  }
  
  return 0;
}

Member Data Documentation

AlignmentPositionError* AlignableDetUnit::theAlignmentPositionError

private

Definition at line 81 of file AlignableDetUnit.h.

Referenced by addAlignmentPositionError(), alignmentErrors(), alignmentPositionError(), setAlignmentPositionError(), and ~AlignableDetUnit().

SurfaceDeformation* AlignableDetUnit::theSurfaceDeformation

private

Definition at line 82 of file AlignableDetUnit.h.

Referenced by addSurfaceDeformation(), setSurfaceDeformation(), surfaceDeformationIdPairs(), and ~AlignableDetUnit().