BowedSurfaceDeformation Class Reference

#include <BowedSurfaceDeformation.h>

Inheritance diagram for BowedSurfaceDeformation:

Public Member Functions
virtual bool	add (const SurfaceDeformation &other)
	BowedSurfaceDeformation (double sagittaX, double sagittaXY, double sagittaY)
	constructor from sagittae, i.e. coefficients of Legendre polynomials More...
	BowedSurfaceDeformation (const std::vector< double > &parameters)
virtual BowedSurfaceDeformation *	clone () const
virtual std::vector< double >	parameters () const
	parameters, i.e. sagittae as given in the constructor More...
virtual Local2DVector	positionCorrection (const Local2DPoint &localPos, const LocalTrackAngles &localAngles, double length, double width) const
virtual int	type () const
	specific type, i.e. SurfaceDeformationFactory::kBowedSurface More...
Public Member Functions inherited from SurfaceDeformation
virtual	~SurfaceDeformation ()

Static Public Member Functions
static unsigned int	maxParameterSize ()
	maximum size of vector that is accepted by constructor from vector More...
static unsigned int	minParameterSize ()
	minimum size of vector that is accepted by constructor from vector More...

Private Attributes
double	theSagittaX
double	theSagittaXY
double	theSagittaY

Additional Inherited Members
Public Types inherited from SurfaceDeformation
typedef Topology::Local2DPoint	Local2DPoint
typedef Vector2DBase< double, LocalTag >	Local2DVector
typedef Topology::LocalTrackAngles	LocalTrackAngles
typedef Topology::MathVector2D	MathVector2D
typedef Topology::Vector2D	Vector2D

Detailed Description

BowedSurfaceAlignmentParameters

Class to apply corrections to local positions resulting from a non-planar surface. The bows are parametrised using Legendre polynomials up to second order, excluding 0th and 1st order that are already treated by local w shift and rotations around local u and v axes.

Author

: Gero Flucke date : October 2010

Definition at line 20 of file BowedSurfaceDeformation.h.

Constructor & Destructor Documentation

BowedSurfaceDeformation::BowedSurfaceDeformation ( double  sagittaX, double  sagittaXY, double  sagittaY  )

inline

constructor from sagittae, i.e. coefficients of Legendre polynomials

Definition at line 24 of file BowedSurfaceDeformation.h.

References add(), clone(), trackingPlots::other, parameters(), positionCorrection(), type(), and ApeEstimator_cff::width.

Referenced by clone().

                                                                              :
    theSagittaX(sagittaX),theSagittaY(sagittaY),  theSagittaXY(sagittaXY)  {  }

BowedSurfaceDeformation::BowedSurfaceDeformation

(

const std::vector< double > &

pars

)

constructor from vector of sagittae, parameters.size() must be between minParameterSize() and maxParameterSize()

Author

: Gero Flucke date : October 2010

Definition at line 13 of file BowedSurfaceDeformation.cc.

References minParameterSize().

  : theSagittaX (pars.size() > 0 ? pars[0] : 0.),
    theSagittaY (pars.size() > 2 ? pars[2] : 0.),
    theSagittaXY(pars.size() > 1 ? pars[1] : 0.)
{
  if (pars.size() != minParameterSize()) {
    edm::LogError("BadSetup") << "@SUB=BowedSurfaceDeformation"
                              << "Input vector of wrong size " << pars.size()
                              << " instead of " << minParameterSize() << ", filled up with zeros!";
  }
}

Member Function Documentation

bool BowedSurfaceDeformation::add ( const SurfaceDeformation &  other )

virtual

update information with parameters of 'other', false in case the type or some parameters do not match and thus the information cannot be used (then no changes are done), true if merge was successful

Implements SurfaceDeformation.

Definition at line 72 of file BowedSurfaceDeformation.cc.

References SurfaceDeformation::parameters(), theSagittaX, theSagittaXY, theSagittaY, SurfaceDeformation::type(), and type().

Referenced by BowedSurfaceDeformation(), and counter.Counter::register().

{
  if (other.type() == this->type()) {
    const std::vector<double> otherParams(other.parameters());
    if (otherParams.size() == 3) { // double check!
      theSagittaX  += otherParams[0]; // bows can simply be added up
      theSagittaXY += otherParams[1];
      theSagittaY  += otherParams[2];

      return true;
    }
  }

  return false;
}

BowedSurfaceDeformation * BowedSurfaceDeformation::clone ( void  ) const

virtual

Implements SurfaceDeformation.

Definition at line 26 of file BowedSurfaceDeformation.cc.

References BowedSurfaceDeformation(), theSagittaX, theSagittaXY, and theSagittaY.

Referenced by BowedSurfaceDeformation().

{
  return new BowedSurfaceDeformation(theSagittaX, theSagittaXY, theSagittaY);
}

static unsigned int BowedSurfaceDeformation::maxParameterSize ( )

inlinestatic

maximum size of vector that is accepted by constructor from vector

Definition at line 57 of file BowedSurfaceDeformation.h.

Referenced by SurfaceDeformationFactory::create().

{ return 3;}

static unsigned int BowedSurfaceDeformation::minParameterSize ( )

inlinestatic

minimum size of vector that is accepted by constructor from vector

Definition at line 55 of file BowedSurfaceDeformation.h.

Referenced by BowedSurfaceDeformation(), and SurfaceDeformationFactory::create().

{ return 3;}

std::vector< double > BowedSurfaceDeformation::parameters ( void  ) const

virtual

parameters, i.e. sagittae as given in the constructor

Implements SurfaceDeformation.

Definition at line 89 of file BowedSurfaceDeformation.cc.

References mps_fire::result, theSagittaX, theSagittaXY, and theSagittaY.

Referenced by BowedSurfaceDeformation().

{
  std::vector<double> result(3);
  result[0] = theSagittaX;
  result[1] = theSagittaXY;
  result[2] = theSagittaY;

  return result;
}

SurfaceDeformation::Local2DVector BowedSurfaceDeformation::positionCorrection ( const Local2DPoint &  localPos, const LocalTrackAngles &  localAngles, double  length, double  width  ) const

virtual

correction to add to local position depending on

• track parameters in local frame (from LocalTrajectoryParameters):
  • track position as Local2DPoint(x,y)
  • track angles as LocalTrackAngles(dxdz, dydz)
• length of surface (local y-coordinate)
• width of surface (local x-coordinate)

Implements SurfaceDeformation.

Definition at line 39 of file BowedSurfaceDeformation.cc.

References theSagittaX, theSagittaXY, theSagittaY, PV2DBase< T, PVType, FrameType >::x(), and PV2DBase< T, PVType, FrameType >::y().

Referenced by BowedSurfaceDeformation().

{

// different widthes at high/low y could somehow be treated by theRelWidthLowY
//   if (widthLowY > 0. && widthHighY != widthLowY) {
//     // TEC would always create a warning...
//     edm::LogWarning("UnusableData") << "@SUB=BowedSurfaceDeformation::positionCorrection"
//                  << "Cannot yet deal with different widthes, take "
//                  << widthHighY << " not " << widthLowY;
//   }
//   const double width = widthHighY;
  
  double uRel = (width  ? 2. * localPos.x() / width  : 0.);  // relative u (-1 .. +1)
  double vRel = (length ? 2. * localPos.y() / length : 0.);  // relative v (-1 .. +1)
  // 'range check':
  const double cutOff = 1.5;
  if (uRel < -cutOff) { uRel = -cutOff; } else if (uRel > cutOff) { uRel = cutOff; }
  if (vRel < -cutOff) { vRel = -cutOff; } else if (vRel > cutOff) { vRel = cutOff; }
  
  // apply coefficients to Legendre polynomials
  // to get local height relative to 'average'
  const double dw 
    = (uRel * uRel - 1./3.) * theSagittaX
    +  uRel * vRel          * theSagittaXY
    + (vRel * vRel - 1./3.) * theSagittaY;

  // positive dxdz/dydz and positive dw mean negative shift in x/y: 
  return Local2DVector(-dw * localAngles);
}

int BowedSurfaceDeformation::type ( ) const

virtual

specific type, i.e. SurfaceDeformationFactory::kBowedSurface

Implements SurfaceDeformation.

Definition at line 32 of file BowedSurfaceDeformation.cc.

References SurfaceDeformationFactory::kBowedSurface.

Referenced by add(), and BowedSurfaceDeformation().

{
  return SurfaceDeformationFactory::kBowedSurface;
}

Member Data Documentation

double BowedSurfaceDeformation::theSagittaX

private

Definition at line 60 of file BowedSurfaceDeformation.h.

Referenced by add(), clone(), parameters(), and positionCorrection().

double BowedSurfaceDeformation::theSagittaXY

private

Definition at line 62 of file BowedSurfaceDeformation.h.

Referenced by add(), clone(), parameters(), and positionCorrection().

double BowedSurfaceDeformation::theSagittaY

private

Definition at line 61 of file BowedSurfaceDeformation.h.

Referenced by add(), clone(), parameters(), and positionCorrection().