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 void	cacheTransformation ()
	cache the current position, rotation and other parameters (e.g. surface deformations) 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	restoreCachedTransformation ()
	restore the previously cached transformation 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...
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 *	theCachedSurfaceDeformation
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
GlobalVector	theCachedDisplacement
RotationType	theCachedRotation
AlignableSurface	theCachedSurface
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(), GeomDet::surfaceDeformation(), and Alignable::theDeepComponents.

                                                                 : // rely on non-NULL pointer!
  Alignable(geomDetUnit->geographicalId().rawId(), geomDetUnit->surface()),
  theAlignmentPositionError(0),
  theSurfaceDeformation(0),
  theCachedSurfaceDeformation(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 36 of file AlignableDetUnit.cc.

References theAlignmentPositionError, theCachedSurfaceDeformation, and theSurfaceDeformation.

{
  delete theAlignmentPositionError;
  delete theSurfaceDeformation;
  delete theCachedSurfaceDeformation;
}

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 84 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 116 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 96 of file AlignableDetUnit.cc.

References addAlignmentPositionError(), PV3DBase< T, PVType, FrameType >::basicVector(), TkRotation< T >::multiplyInverse(), Alignable::surface(), AlignableSurface::toGlobal(), and create_public_lumi_plots::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 44 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 138 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 192 of file AlignableDetUnit.cc.

References asHepMatrix(), 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 = asHepMatrix(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 83 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 169 of file AlignableDetUnit.cc.

References Alignable::geomDetId(), Alignable::globalPosition(), Alignable::globalRotation(), Alignments::m_align, DetId::rawId(), makeMuonMisalignmentScenario::rot, create_public_lumi_plots::transform, 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;

}

void AlignableDetUnit::cacheTransformation ( )

virtual

cache the current position, rotation and other parameters (e.g. surface deformations)

Reimplemented from Alignable.

Definition at line 224 of file AlignableDetUnit.cc.

References SurfaceDeformation::clone(), Alignable::theCachedDisplacement, Alignable::theCachedRotation, Alignable::theCachedSurface, theCachedSurfaceDeformation, Alignable::theDisplacement, Alignable::theRotation, Alignable::theSurface, and theSurfaceDeformation.

{
  theCachedSurface = theSurface;
  theCachedDisplacement = theDisplacement;
  theCachedRotation = theRotation;

  if (theCachedSurfaceDeformation) {
    delete theCachedSurfaceDeformation;
    theCachedSurfaceDeformation = 0;
  }

  if (theSurfaceDeformation)
    theCachedSurfaceDeformation = theSurfaceDeformation->clone();
}

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 156 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 51 of file AlignableDetUnit.cc.

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

Referenced by Vispa.Gui.WidgetContainer.WidgetContainer::autosize(), Vispa.Gui.VispaWidget.VispaWidget::dragWidget(), Vispa.Gui.VispaWidget.VispaWidget::setZoom(), and 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::restoreCachedTransformation ( )

virtual

restore the previously cached transformation

Reimplemented from Alignable.

Definition at line 240 of file AlignableDetUnit.cc.

References setSurfaceDeformation(), Alignable::theCachedDisplacement, Alignable::theCachedRotation, Alignable::theCachedSurface, theCachedSurfaceDeformation, Alignable::theDisplacement, Alignable::theRotation, Alignable::theSurface, and theSurfaceDeformation.

{
  theSurface = theCachedSurface;
  theDisplacement = theCachedDisplacement;
  theRotation = theCachedRotation;

  if (theSurfaceDeformation) {
    delete theSurfaceDeformation;
    theSurfaceDeformation = 0;
  }

  if (theCachedSurfaceDeformation) {
    this->setSurfaceDeformation(theCachedSurfaceDeformation, false);
  }
}

void AlignableDetUnit::rotateInGlobalFrame ( const RotationType &  rotation )

virtual

Rotation with respect to the global reference frame.

Implements Alignable.

Definition at line 61 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 71 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 126 of file AlignableDetUnit.cc.

References SurfaceDeformation::clone(), and theSurfaceDeformation.

Referenced by addSurfaceDeformation(), AlignableDetUnit(), and restoreCachedTransformation().

{
  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 213 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 87 of file AlignableDetUnit.h.

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

SurfaceDeformation* AlignableDetUnit::theCachedSurfaceDeformation

private

Definition at line 89 of file AlignableDetUnit.h.

Referenced by cacheTransformation(), restoreCachedTransformation(), and ~AlignableDetUnit().

SurfaceDeformation* AlignableDetUnit::theSurfaceDeformation

private

Definition at line 88 of file AlignableDetUnit.h.

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