---

AlignableComposite Class Reference

#include <Alignment/CommonAlignment/interface/AlignableComposite.h>

Inheritance diagram for AlignableComposite:

List of all members.

Public Member Functions
virtual void	addAlignmentPositionError (const AlignmentPositionError &ape)
	Add the AlignmentPositionError to all the components of the composite.
virtual void	addAlignmentPositionErrorFromLocalRotation (const RotationType &rotation)
	Add position error to all components as resulting from given local rotation.
virtual void	addAlignmentPositionErrorFromRotation (const RotationType &rotation)
	Add position error to all components as resulting from global rotation.
virtual void	addComponent (Alignable *component)
	Add a component and set its mother to this alignable.
	AlignableComposite (align::ID id, StructureType aType, const RotationType &rot=RotationType())
	Constructor for a composite with given rotation.
virtual StructureType	alignableObjectId () const
	Return the alignable type identifier.
virtual AlignmentErrors *	alignmentErrors () const
	Return vector of alignment errors.
virtual Alignments *	alignments () const
	Return alignment data.
virtual Alignables	components () const
	Return vector of direct components.
virtual void	dump () const
	Recursive printout of alignable structure.
virtual void	move (const GlobalVector &displacement)
	Move with respect to the global reference frame.
virtual void	moveComponentLocal (const int i, const LocalVector &localDisplacement)
	Move a single component with respect to the local reference frame.
virtual void	moveComponentsLocal (const LocalVector &localDisplacement)
	Move with respect to the local reference frame.
virtual void	recursiveComponents (Alignables &result) const
	Provide all components, subcomponents etc. (cf. description in base class).
virtual void	rotateInGlobalFrame (const RotationType &rotation)
	Rotation interpreted in global reference frame.
virtual void	setAlignmentPositionError (const AlignmentPositionError &ape)
	Set the AlignmentPositionError to all the components of the composite.
virtual	~AlignableComposite ()
	deleting its components
Protected Member Functions
	AlignableComposite (const GeomDet *geomDet)
	Constructor from GeomDet, only for use in AlignableDet.
void	setSurface (const AlignableSurface &s)
Protected Attributes
StructureType	theStructureType
Private Member Functions
	AlignableComposite ()
	default constructor hidden
Private Attributes
Alignables	theComponents

---

Detailed Description

Definition at line 25 of file AlignableComposite.h.

---

Constructor & Destructor Documentation

AlignableComposite::AlignableComposite	(	align::ID	id,
		StructureType	aType,
		const RotationType &	rot = RotationType()
	)

Constructor for a composite with given rotation.

Position can be found from average of daughters' positions later, using addComponent(Alignable*).

Definition at line 20 of file AlignableComposite.cc.

                                                               :
  Alignable(id, rot),
  theStructureType(type)
{
}

AlignableComposite::~AlignableComposite

(

)

[virtual]

deleting its components

Definition at line 28 of file AlignableComposite.cc.

References i, and theComponents.

{
  for (unsigned int i = 0; i < theComponents.size(); ++i) delete theComponents[i];
}

AlignableComposite::AlignableComposite

(

const GeomDet *

geomDet

)

[explicit, protected]

Constructor from GeomDet, only for use in AlignableDet.

Definition at line 14 of file AlignableComposite.cc.

                                                               : 
  Alignable( geomDet->geographicalId().rawId(), geomDet->surface() ),
  theStructureType(align::AlignableDet)
{
}

AlignableComposite::AlignableComposite

(

)

[inline, private]

default constructor hidden

Definition at line 96 of file AlignableComposite.h.

Referenced by AlignableTracker::buildBarrel(), and AlignableTracker::buildTRK().

: Alignable (0, RotationType()) {};

---

Member Function Documentation

void AlignableComposite::addAlignmentPositionError

(

const AlignmentPositionError &

ape

)

[virtual]

Add the AlignmentPositionError to all the components of the composite.

Implements Alignable.

Reimplemented in AlignableDet.

Definition at line 171 of file AlignableComposite.cc.

References components(), and i.

Referenced by AlignableDet::addAlignmentPositionError().

{

  Alignables comp = this->components();
  for ( Alignables::const_iterator i=comp.begin(); i!=comp.end(); i++) 
    (*i)->addAlignmentPositionError(ape);

}

void AlignableComposite::addAlignmentPositionErrorFromLocalRotation

(

const RotationType &

rotation

)

[virtual]

Add position error to all components as resulting from given local rotation.

Adds the AlignmentPositionError (in x,y,z coordinates) that would result on the various components from a possible Rotation of a composite the rotation matrix is in interpreted in LOCAL coordinates of the composite.

Implements Alignable.

Reimplemented in AlignableDet.

Definition at line 219 of file AlignableComposite.cc.

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

Referenced by AlignableDet::addAlignmentPositionErrorFromLocalRotation().

{

  RotationType globalRot = globalRotation().multiplyInverse(rot*globalRotation());
  this->addAlignmentPositionErrorFromRotation(globalRot);

}

void AlignableComposite::addAlignmentPositionErrorFromRotation

(

const RotationType &

rotation

)

[virtual]

Add position error to all components as resulting from global rotation.

Adds the AlignmentPositionError (in x,y,z coordinates) that would result on the various components from a possible Rotation of a composite the rotation matrix is in interpreted in GLOBAL coordinates.

Implements Alignable.

Reimplemented in AlignableDet.

Definition at line 185 of file AlignableComposite.cc.

References PV3DBase< T, PVType, FrameType >::basicVector(), components(), Alignable::globalPosition(), i, and TkRotation< T >::multiplyInverse().

Referenced by addAlignmentPositionErrorFromLocalRotation(), and AlignableDet::addAlignmentPositionErrorFromRotation().

{

  Alignables comp = this->components();

  PositionType myPosition=this->globalPosition();

  for ( Alignables::const_iterator i=comp.begin(); i!=comp.end(); i++ )
    {

      // It is just similar to to the "movement" that results to the components
      // when the composite is rotated. 
      // Local Position given in coordinates of the GLOBAL Frame
      const GlobalVector localPositionVector = (**i).globalPosition()-myPosition;
      GlobalVector::BasicVectorType lpvgf = localPositionVector.basicVector();

      // rotate with GLOBAL rotation matrix  and subtract => moveVector in global coordinates
      // apparently... you have to use the inverse of the rotation here
      // (rotate the VECTOR rather than the frame) 
      GlobalVector moveVector( rotation.multiplyInverse(lpvgf) - lpvgf );    
      
      AlignmentPositionError ape( moveVector.x(), moveVector.y(), moveVector.z() );
      (*i)->addAlignmentPositionError( ape );
      (*i)->addAlignmentPositionErrorFromRotation( rotation );
          
    }

}

void AlignableComposite::addComponent

(

Alignable *

component

)

[virtual]

Add a component and set its mother to this alignable.

(Note: The component will be adopted, e.g. later deleted.) Also find average position of this composite from its modules' positions.

Implements Alignable.

Definition at line 33 of file AlignableComposite.cc.

References Alignable::deepComponents(), Alignable::globalPosition(), k, GloballyPositioned< T >::move(), Alignable::setMother(), theComponents, Alignable::theDeepComponents, and Alignable::theSurface.

Referenced by AlignableDet::AlignableDet(), AlignableDTChamber::AlignableDTChamber(), and AlignableTracker::buildTRK().

{
  const Alignables& newComps = ali->deepComponents();

  theDeepComponents.insert( theDeepComponents.end(), newComps.begin(), newComps.end() );

  Scalar k = static_cast<Scalar>( newComps.size() ) / theDeepComponents.size();

  theSurface.move( ( ali->globalPosition() - globalPosition() ) * k );

  ali->setMother(this);
  theComponents.push_back(ali);
}

virtual StructureType AlignableComposite::alignableObjectId

(

)

const [inline, virtual]

Return the alignable type identifier.

Implements Alignable.

Definition at line 75 of file AlignableComposite.h.

References theStructureType.

Referenced by dump().

{ return theStructureType; }

AlignmentErrors * AlignableComposite::alignmentErrors

(

void

)

const [virtual]

Return vector of alignment errors.

Implements Alignable.

Reimplemented in AlignableDet, AlignableCSCEndcap, AlignableDTBarrel, AlignableMuon, AlignableSiStripDet, and AlignableTracker.

Definition at line 275 of file AlignableComposite.cc.

References components(), edmNew::copy(), i, and AlignmentErrors::m_alignError.

{

  // Recursively call alignmentsErrors, until we get to an AlignableDetUnit
  Alignables comp = this->components();

  AlignmentErrors* m_alignmentErrors = new AlignmentErrors();

  // Add components recursively
  for ( Alignables::iterator i=comp.begin(); i!=comp.end(); i++ )
    {
      AlignmentErrors* tmpAlignmentErrors = (*i)->alignmentErrors();
      std::copy( tmpAlignmentErrors->m_alignError.begin(), tmpAlignmentErrors->m_alignError.end(), 
                 std::back_inserter(m_alignmentErrors->m_alignError) );
          delete tmpAlignmentErrors;
    }

  
  return m_alignmentErrors;

}

Alignments * AlignableComposite::alignments

(

void

)

const [virtual]

Return alignment data.

Implements Alignable.

Reimplemented in AlignableDet, AlignableCSCEndcap, AlignableDTBarrel, AlignableMuon, AlignableSiStripDet, and AlignableTracker.

Definition at line 251 of file AlignableComposite.cc.

References components(), edmNew::copy(), i, and Alignments::m_align.

{

  // Recursively call alignments, until we get to an AlignableDetUnit
  Alignables comp = this->components();

  Alignments* m_alignments = new Alignments();

  // Add components recursively
  for ( Alignables::iterator i=comp.begin(); i!=comp.end(); i++ )
    {
      Alignments* tmpAlignments = (*i)->alignments();
      std::copy( tmpAlignments->m_align.begin(), tmpAlignments->m_align.end(), 
                 std::back_inserter(m_alignments->m_align) );
          delete tmpAlignments;
    }

  
  return m_alignments;

}

virtual Alignables AlignableComposite::components

(

)

const [inline, virtual]

Return vector of direct components.

Implements Alignable.

Reimplemented in AlignableCSCEndcap, AlignableCSCRing, AlignableCSCStation, AlignableDTBarrel, AlignableDTStation, AlignableDTWheel, and AlignableMuon.

Definition at line 45 of file AlignableComposite.h.

References theComponents.

Referenced by addAlignmentPositionError(), addAlignmentPositionErrorFromRotation(), AlignmentParameterSelector::addAllAlignables(), AlignmentParameterSelector::addSelection(), AlignableTracker::AlignableTracker(), alignmentErrors(), AlignableDet::alignmentErrors(), AlignableTracker::alignmentErrors(), alignments(), AlignableTracker::alignments(), AlignableDet::alignments(), AlignableTracker::detsToAlignables(), dump(), KalmanAlignmentAlgorithm::initialize(), move(), moveComponentLocal(), operator<<(), recursiveComponents(), rotateInGlobalFrame(), and setAlignmentPositionError().

{ return theComponents; }

void AlignableComposite::dump

(

void

)

const [virtual]

Recursive printout of alignable structure.

Implements Alignable.

Definition at line 228 of file AlignableComposite.cc.

References alignableObjectId(), components(), lat::endl(), Alignable::globalPosition(), Alignable::globalRotation(), and i.

{

  // A simple printout method. Could be specialized in the implementation classes.

  Alignables comp = this->components();

  // Dump this
  edm::LogInfo("AlignableDump") 
    << " Alignable of type " << this->alignableObjectId() 
    << " has " << comp.size() << " components" << std::endl
    << " position = " << this->globalPosition() << ", orientation:" << std::endl
    << this->globalRotation();

  // Dump components
  for ( Alignables::iterator i=comp.begin(); i!=comp.end(); i++ )
    (*i)->dump();

}

void AlignableComposite::move

(

const GlobalVector &

displacement

)

[virtual]

Move with respect to the global reference frame.

Implements Alignable.

Definition at line 64 of file AlignableComposite.cc.

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

Referenced by moveComponentsLocal().

{
  
  // Move components
  Alignables comp = this->components();
  for ( Alignables::iterator i=comp.begin(); i!=comp.end(); i++ )
    (**i).move( displacement);

  // Move surface
  this->addDisplacement( displacement );
  theSurface.move( displacement );

}

void AlignableComposite::moveComponentLocal	(	const int	i,
		const LocalVector &	localDisplacement
	)			[virtual]

Move a single component with respect to the local reference frame.

Definition at line 88 of file AlignableComposite.cc.

References components(), Exception, and Alignable::size().

{

  if (i >= size() ) 
    throw cms::Exception("LogicError")
      << "AlignableComposite index (" << i << ") out of range";

  Alignables comp = this->components();
  comp[i]->move( this->surface().toGlobal( localDisplacement ) );

}

void AlignableComposite::moveComponentsLocal

(

const LocalVector &

localDisplacement

)

[virtual]

Move with respect to the local reference frame.

Definition at line 80 of file AlignableComposite.cc.

References move().

{

  this->move( this->surface().toGlobal(localDisplacement) );

}

void AlignableComposite::recursiveComponents

(

Alignables &

result

)

const [virtual]

Provide all components, subcomponents etc. (cf. description in base class).

Definition at line 48 of file AlignableComposite.cc.

References align::AlignableDet, components(), and iter.

{

  Alignables components = this->components();
  if (this->alignableObjectId() == align::AlignableDet 
      && components.size() <= 1) { // Non-glued AlignableDets (still) contain themselves
    return; // (would be better to implement AlignableDet::recursiveComponents!)
  }
  for (Alignables::const_iterator iter = components.begin();
       iter != components.end(); ++iter) {
    result.push_back(*iter); // could use std::copy(..), but here we build a real hierarchy
    (*iter)->recursiveComponents(result);
  }
}

void AlignableComposite::rotateInGlobalFrame

(

const RotationType &

rotation

)

[virtual]

Rotation interpreted in global reference frame.

Rotation intepreted such, that the orientation of the rotation axis is w.r.t.

to the global coordinate system. This, however, does NOT mean the center of the rotation. This is simply taken as the center of the Alignable-object

Implements Alignable.

Definition at line 106 of file AlignableComposite.cc.

References Alignable::addRotation(), PV3DBase< T, PVType, FrameType >::basicVector(), components(), Alignable::globalPosition(), i, TkRotation< T >::multiplyInverse(), GloballyPositioned< T >::rotate(), and Alignable::theSurface.

{
  
  Alignables comp = this->components();
  
  PositionType myPosition = this->globalPosition();
  
  for ( Alignables::iterator i=comp.begin(); i!=comp.end(); i++ )
    {
      
      // It is much simpler to calculate the local position given in coordinates 
      // of the GLOBAL frame and then just apply the rotation matrix given in the 
      // GLOBAL frame as well. ONLY this is somewhat tricky... as Teddy's frames 
      // don't like this kind of mixing...
      
      // Rotations are defined for "Basic3DVector" types, without any FrameTAG,
      // because Rotations usually switch between different frames. You get
      // this by using the method .basicVector()
    
      // localPosition = globalPosition (Component) - globalPosition(Composite)
      // moveVector = rotated localPosition  - original localposition
      // LocalVector localPositionVector = (**i).globalPosition()-myPosition;
    
    
      // Local Position given in coordinates of the GLOBAL Frame
      const GlobalVector localPositionVector = (**i).globalPosition() - myPosition;
      GlobalVector::BasicVectorType lpvgf = localPositionVector.basicVector();

      // rotate with GLOBAL rotation matrix  and subtract => moveVector in 
      // global Coordinates
      // apparently... you have to use the inverse of the rotation here
      // (rotate the VECTOR rather than the frame) 
      GlobalVector moveVector( rotation.multiplyInverse(lpvgf) - lpvgf );
    
    
      (**i).move( moveVector );
      (**i).rotateInGlobalFrame( rotation );

    }

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

}

void AlignableComposite::setAlignmentPositionError

(

const AlignmentPositionError &

ape

)

[virtual]

Set the AlignmentPositionError to all the components of the composite.

Set the alignment position error of all components to given error.

Implements Alignable.

Reimplemented in AlignableDet.

Definition at line 155 of file AlignableComposite.cc.

References components(), and i.

Referenced by AlignableDet::setAlignmentPositionError().

{

  // Since no geomDet is attached, alignable composites do not have an APE
  // The APE is, therefore, just propagated down
  Alignables comp = this->components();
  for ( Alignables::const_iterator i=comp.begin(); i!=comp.end(); i++) 
    {
      (*i)->setAlignmentPositionError(ape);
    }

}

void AlignableComposite::setSurface

(

const AlignableSurface &

s

)

[inline, protected]

Definition at line 90 of file AlignableComposite.h.

References Alignable::theSurface.

Referenced by AlignableCSCEndcap::AlignableCSCEndcap(), AlignableCSCRing::AlignableCSCRing(), AlignableCSCStation::AlignableCSCStation(), AlignableDTBarrel::AlignableDTBarrel(), AlignableDTStation::AlignableDTStation(), and AlignableDTWheel::AlignableDTWheel().

{ theSurface = s; }

---

Member Data Documentation

Alignables AlignableComposite::theComponents [private]

Definition at line 96 of file AlignableComposite.h.

Referenced by addComponent(), components(), and ~AlignableComposite().

StructureType AlignableComposite::theStructureType [protected]

Definition at line 92 of file AlignableComposite.h.

Referenced by AlignableCSCChamber::AlignableCSCChamber(), AlignableDTChamber::AlignableDTChamber(), AlignableDTSuperLayer::AlignableDTSuperLayer(), and alignableObjectId().

---

The documentation for this class was generated from the following files:

• Alignment/CommonAlignment/interface/AlignableComposite.h
• Alignment/CommonAlignment/src/AlignableComposite.cc

---