Surface Class Reference

#include <Surface.h>

Inheritance diagram for Surface:

Public Types
typedef GloballyPositioned< float >	Base
typedef SurfaceOrientation::Side	Side
Public Types inherited from GloballyPositioned< float >
typedef Point3DBase< float, GlobalTag >	GlobalPoint
typedef Vector3DBase< float, GlobalTag >	GlobalVector
typedef Point3DBase< float, LocalTag >	LocalPoint
typedef Vector3DBase< float, LocalTag >	LocalVector
typedef Point3DBase< float, GlobalTag >	PositionType
typedef TkRotation< float >	RotationType
typedef float	Scalar

Public Member Functions
const Bounds &	bounds () const
const MediumProperties &	mediumProperties () const
std::pair< float, float > const &	phiSpan () const
std::pair< float, float > const &	rSpan () const
void	setMediumProperties (const MediumProperties &mp)
virtual Side	side (const LocalPoint &p, Scalar tolerance=0) const =0
virtual Side	side (const GlobalPoint &p, Scalar tolerance=0) const
virtual ConstReferenceCountingPointer < TangentPlane >	tangentPlane (const GlobalPoint &) const =0
virtual ConstReferenceCountingPointer < TangentPlane >	tangentPlane (const LocalPoint &) const =0
GlobalPoint	toGlobal (const Point2DBase< Scalar, LocalTag > lp) const
std::pair< float, float > const &	zSpan () const
virtual	~Surface ()
Public Member Functions inherited from GloballyPositioned< float >
float	eta () const
	GloballyPositioned ()
	GloballyPositioned (const PositionType &pos, const RotationType &rot)
void	move (const GlobalVector &displacement)
float	phi () const
const PositionType &	position () const
void	rotate (const RotationType &rotation)
const RotationType &	rotation () const
GlobalPoint	toGlobal (const LocalPoint &lp) const
Point3DBase< U, GlobalTag >	toGlobal (const Point3DBase< U, LocalTag > &lp) const
GlobalVector	toGlobal (const LocalVector &lv) const
Vector3DBase< U, GlobalTag >	toGlobal (const Vector3DBase< U, LocalTag > &lv) const
LocalPoint	toLocal (const GlobalPoint &gp) const
Point3DBase< U, LocalTag >	toLocal (const Point3DBase< U, GlobalTag > &gp) const
LocalVector	toLocal (const GlobalVector &gv) const
Vector3DBase< U, LocalTag >	toLocal (const Vector3DBase< U, GlobalTag > &gv) const
virtual	~GloballyPositioned ()
Public Member Functions inherited from BasicReferenceCounted
void	addReference () const
	BasicReferenceCounted ()
	BasicReferenceCounted (const BasicReferenceCounted &)
const BasicReferenceCounted &	operator= (const BasicReferenceCounted &)
unsigned int	references () const
void	removeReference () const
virtual	~BasicReferenceCounted ()

Protected Member Functions
	Surface ()
	Surface (const PositionType &pos, const RotationType &rot)
	Surface (const PositionType &pos, const RotationType &rot, Bounds *bounds)
	Surface (const PositionType &pos, const RotationType &rot, MediumProperties mp)
	Surface (const PositionType &pos, const RotationType &rot, MediumProperties mp, Bounds *bounds)
	Surface (const Surface &iSurface)

Protected Attributes
Bounds *	theBounds
MediumProperties	theMediumProperties

Additional Inherited Members
Static Public Member Functions inherited from GloballyPositioned< float >
static float	iniEta ()
static float	iniPhi ()

Detailed Description

Base class for 2D surfaces in 3D space. May have MediumProperties. may have bounds The Bounds define a region AROUND the surface. Surfaces which differ only by the shape of their bounds are of the same "surface" type (e.g. Plane or Cylinder).

Definition at line 48 of file Surface.h.

Member Typedef Documentation

typedef GloballyPositioned<float> Surface::Base

Definition at line 54 of file Surface.h.

typedef SurfaceOrientation::Side Surface::Side

Definition at line 52 of file Surface.h.

Constructor & Destructor Documentation

virtual Surface::~Surface ( )

inlinevirtual

Definition at line 56 of file Surface.h.

{}

Surface::Surface ( )

inlineprotected

Definition at line 59 of file Surface.h.

{}

Surface::Surface ( const PositionType &  pos, const RotationType &  rot  )

inlineprotected

Definition at line 60 of file Surface.h.

                                                             :
    Base( pos, rot) {}

Surface::Surface ( const PositionType &  pos, const RotationType &  rot, Bounds *  bounds  )

inlineprotected

Definition at line 63 of file Surface.h.

                       :
    Base( pos, rot),
    theBounds(bounds)
  {}

Surface::Surface ( const PositionType &  pos, const RotationType &  rot, MediumProperties  mp  )

inlineprotected

Definition at line 70 of file Surface.h.

                                :
    Base( pos, rot),
    theMediumProperties(mp)
  {}

Surface::Surface ( const PositionType &  pos, const RotationType &  rot, MediumProperties  mp, Bounds *  bounds  )

inlineprotected

Definition at line 76 of file Surface.h.

                       :
    Base( pos, rot),
    theMediumProperties(mp),
    theBounds(bounds)
  {}

Surface::Surface ( const Surface &  iSurface )

inlineprotected

Definition at line 86 of file Surface.h.

                                     : 
  Base( iSurface), 
  theMediumProperties(iSurface.theMediumProperties),
  theBounds(iSurface.theBounds)
  {}

Member Function Documentation

const Bounds& Surface::bounds ( ) const

inline

Definition at line 128 of file Surface.h.

References theBounds.

Referenced by SiStripCalibLorentzAngle::algoBeginJob(), SiStripLAProfileBooker::analyze(), TkLayerLess::barrelForwardLess(), SiStripDetInfoFileWriter::beginRun(), BoundDiskSector::bounds(), Cylinder::build(), CSCGeometryBuilder::buildChamber(), MuonTrackLoader::buildTrackExtra(), ValidateGeometry::compareShape(), MuRodBarrelLayer::compatibleDets(), BoundSpan::compute(), TIBLayer::computeWindowSize(), FWTGeoRecoGeometryESProducer::createShape(), SiPixelLorentzAngleCalibration::derivatives(), SiStripBackplaneCalibration::derivatives(), SiPixelDigitizerAlgorithm::digitize(), shallow::drift(), SiPixelDigitizerAlgorithm::drift(), SiStripLorentzAngleCalibration::effectiveThickness(), InsideBoundsMeasurementEstimator::estimate(), Chi2MeasurementEstimatorBase::estimate(), RectangularEtaPhiTrackingRegion::estimator(), ApeEstimator::fillHitVariables(), StripCPE::fillParams(), ClusterShapeHitFilter::getCotangent(), MuonDetIdAssociator::getDetIdPoints(), HitPairGeneratorFromLayerPairForPhotonConversion::getLayerRadius(), HitPairGeneratorFromLayerPairForPhotonConversion::getLayerZ(), TrackDetectorAssociator::getTAMuonChamberMatches(), GlobalDetRodRangeZPhi::GlobalDetRodRangeZPhi(), PixelTripletNoTipGenerator::hitTriplets(), InnerDeltaPhi::initBarrelLayer(), InnerDeltaPhi::initForwardLayer(), ThirdHitRZPredictionBase::initLayer(), ThirdHitPrediction::initLayer(), Disk::innerRadius(), MuonDetIdAssociator::insideElement(), DeDxTools::IsFarFromBorder(), ShallowGainCalibration::IsFarFromBorder(), SiStripGainFromData::IsFarFromBorder(), SiStripGainFromCalibTree::IsFarFromBorder(), SimpleNavigationSchool::linkNextForwardLayer(), TrajectoryManager::makeSinglePSimHit(), SiStripGainCosmicCalculator::moduleThickness(), SiStripGainCosmicCalculator::moduleWidth(), MSLayer::MSLayer(), CylinderBuilderFromDet::operator()(), Disk::outerRadius(), TIBLayer::overlap(), PixelBlade::overlap(), Phase1PixelBlade::overlap(), phiSpan(), MuonNavigationPrinter::printLayer(), StandaloneTrackMonitor::processClusters(), StandaloneTrackMonitor::processHit(), HSCPDeDxInfoProducer::processHit(), DeDxHitInfoProducer::processHit(), SiHitDigitizer::processHit(), DeDxEstimatorProducer::processHit(), MuonSimHitProducer::produce(), SiStripTrackingRecHitsValid::rechitanalysis(), SiStripTrackingRecHitsValid::rechitanalysis_matched(), rSpan(), SETPatternRecognition::segmentCleaning(), StripSubClusterShapeFilterBase::testLastHit(), TrajectoryAtInvalidHit::TrajectoryAtInvalidHit(), ValidateGeometry::validateDTLayerGeometry(), SimpleNavigableLayer::wellInside(), and zSpan().

{ return *theBounds; }

const MediumProperties& Surface::mediumProperties ( ) const

inline

Definition at line 120 of file Surface.h.

References theMediumProperties.

Referenced by GsfMultipleScatteringUpdator::compute(), EnergyLossUpdator::compute(), MultipleScatteringUpdator::compute(), GsfBetheHeitlerUpdator::compute(), oldMUcompute(), MaterialEffects::radLengths(), GsfMaterialEffectsUpdator::updateState(), and MaterialEffectsUpdator::updateStateInPlace().

                                                    { 
    return theMediumProperties;
  }

std::pair<float,float> const& Surface::phiSpan ( ) const

inline

Definition at line 131 of file Surface.h.

References bounds(), and Bounds::phiSpan().

Referenced by barrelUtil::overlap(), and tkDetUtil::overlapInPhi().

{ return bounds().phiSpan(); }

std::pair<float,float> const& Surface::rSpan ( ) const

inline

Definition at line 133 of file Surface.h.

References bounds(), and Bounds::rSpan().

{ return bounds().rSpan(); }

void Surface::setMediumProperties ( const MediumProperties &  mp )

inline

Definition at line 124 of file Surface.h.

References theMediumProperties.

                                                          {
    theMediumProperties = mp;
  }

virtual Side Surface::side ( const LocalPoint &  p, Scalar  tolerance = 0  ) const

pure virtual

Returns the side of the surface on which the point is. Not defined for 1-sided surfaces (Moebius leaf etc.) For normal 2-sided surfaces the meaning of side is surface type dependent.

Implemented in Plane, Cylinder, and Cone.

Referenced by side().

virtual Side Surface::side ( const GlobalPoint &  p, Scalar  tolerance = 0  ) const

inlinevirtual

Reimplemented in Plane, and Cone.

Definition at line 107 of file Surface.h.

References side(), and GloballyPositioned< float >::toLocal().

                                                                     {
    return side( toLocal(p), tolerance);
  }

virtual ConstReferenceCountingPointer<TangentPlane> Surface::tangentPlane ( const GlobalPoint &  ) const

pure virtual

Tangent plane to surface from global point. Returns a plane, tangent to the Surface at a point. The point must be on the surface. The return type is a ReferenceCountingPointer, so the plane will be deleted automatically when no longer needed.

Implemented in Plane, Cylinder, and Cone.

Referenced by GlobalTrackerMuonAlignment::analyzeTrackTrack(), GlobalTrackerMuonAlignment::analyzeTrackTrajectory(), MuonSimHitProducer::applyMaterialEffects(), SteppingHelixStateInfo::getStateOnSurface(), ConvBremSeedProducer::makeTrajectoryState(), TrajectoryManager::makeTrajectoryState(), and GlobalMuonTrackMatcher::samePlane().

virtual ConstReferenceCountingPointer<TangentPlane> Surface::tangentPlane ( const LocalPoint &  ) const

pure virtual

Tangent plane to surface from local point.

Implemented in Plane, Cylinder, and Cone.

GlobalPoint Surface::toGlobal ( const Point2DBase< Scalar, LocalTag >  lp ) const

inline

Definition at line 114 of file Surface.h.

References PV2DBase< T, PointTag, FrameTag >::basicVector(), PV3DBase< T, PVType, FrameType >::basicVector(), GloballyPositioned< float >::position(), and GloballyPositioned< float >::rotation().

Referenced by SiPixelDigitizerAlgorithm::accumulateSimHits(), SiStripDigitizerAlgorithm::accumulateSimHits(), ElectronSeedAnalyzer::analyze(), SiPixelTrackResidualSource::analyze(), TestHits::analyze(), PixelLumiDQM::analyze(), TestSmoothHits::analyze(), TestTrackHits::analyze(), SiPixelErrorEstimation::analyze(), SiPixelTrackingRecHitsValid::analyze(), TrackerTreeGenerator::analyze(), analyzer::SiPixelLorentzAngle::analyze(), TrackerDpgAnalysis::analyze(), TrackingRecHitLessFromGlobalPosition::barrelForwardLess(), TrackerDpgAnalysis::beginRun(), SeedFromGenericPairOrTriplet::buildSeed(), barrelUtil::calculatePhiWindow(), tkDetUtil::calculatePhiWindow(), CSCLayer::centerOfStrip(), CSCLayer::centerOfWireGroup(), PixelHitMatcher::compatibleHits(), BoundSpan::compute(), SiPixelErrorEstimation::computeAnglesFromDetPosition(), RodPlaneBuilderFromDet::computeBounds(), TIBRing::computeHelicity(), Phase1PixelBlade::computeRadiusRanges(), PlaneBuilderForGluedDet::computeRectBounds(), RodPlaneBuilderFromDet::computeRotation(), SiLinearChargeDivider::DeconvolutionShape(), DTDigiSyncTOFCorr::digitizerOffset(), ForwardMeasurementEstimator::estimate(), BarrelMeasurementEstimator::estimate(), AlignmentMonitorMuonResiduals::event(), AlignmentMonitorTracksFromTrajectories::event(), fastProp(), Cylinder::fastTangent(), SiPixelClusterModule::fill(), SiPixelRecHitsValid::fillBarrel(), TrackerValidationVariables::fillHitQuantities(), TrackerOfflineValidationSummary::fillTree(), DTTrigGeom::getGeom(), CSCSectorReceiverLUT::getGlobalEtaValue(), TrackAssociatorByPositionImpl::getState(), CachedTrajectory::getWideTrajectory(), CSCDriftSim::getWireHit(), GlobalDetRodRangeZPhi::GlobalDetRodRangeZPhi(), TValidTrackingRecHit::globalPosition(), TRecHit5DParamConstraint::globalPosition(), TRecHit2DPosConstraint::globalPosition(), TrajectorySeedHitCandidate::globalPosition(), BaseTrackerRecHit::globalPosition(), RKPropagatorInS::gtpFromLocal(), HelixBarrelCylinderCrossing::HelixBarrelCylinderCrossing(), TrackingRecHitLessFromGlobalPosition::insideOutLess(), SiPixelGaussianSmearingRecHitConverterAlgorithm::isFlipped(), PixelCPEBase::isFlipped(), JacobianCurvilinearToLocal::JacobianCurvilinearToLocal(), JacobianLocalToCurvilinear::JacobianLocalToCurvilinear(), TrajectoryManager::makeSinglePSimHit(), CosmicParametersDefinerForTP::momentum(), MultiTrajectoryStateMode::momentumFromModeLocal(), GeneralNSurfaceDelimitedBounds::myInside(), RKPropagatorInR::myPropagate(), PropagationDirectionChooser::operator()(), CosmicTrackingParticleSelector::operator()(), SeedFromNuclearInteraction::outerHitPosition(), StraightLineBarrelCylinderCrossing::pathLength(), SiLinearChargeDivider::PeakShape(), MultiTrajectoryStateMode::positionFromModeLocal(), JetCoreClusterSplitter::produce(), PixelClusterSelectorTopBottom::produce(), FastTrackerRecHitMatcher::produce(), DTDigitizer::produce(), TestHits::projectHit(), TestSmoothHits::projectHit(), TestTrackHits::projectHit(), SiStripRecHitsValid::projectHit(), GlobalRecHitsAnalyzer::projectHit(), GlobalRecHitsProducer::projectHit(), SiStripTrackingRecHitsValid::projectHit(), FastTrackerRecHitMatcher::projectOnly(), StraightLinePropagator::propagateParametersOnCylinder(), DigiSimLinkAlgorithm::run(), TrackerOfflineValidation::setUpTreeMembers(), Cone::side(), TrackClusterSplitter::splitCluster(), Cylinder::tangentPlane(), GeomDet::toGlobal(), NavSurface::toGlobal(), DTTrigGeom::toGlobal(), Geant4ePropagator::transformToG4SurfaceTarget(), ValidateGeometry::validateCSChamberGeometry(), ValidateGeometry::validateCSCLayerGeometry(), ValidateGeometry::validateDTChamberGeometry(), ValidateGeometry::validateDTLayerGeometry(), ValidateGeometry::validateRPCGeometry(), and CosmicParametersDefinerForTP::vertex().

                                                                       {
    return GlobalPoint( rotation().multiplyInverse( lp.basicVector()) +
            position().basicVector());
  }

std::pair<float,float> const& Surface::zSpan ( ) const

inline

Definition at line 132 of file Surface.h.

References bounds(), and Bounds::zSpan().

{ return bounds().zSpan(); }

Member Data Documentation

Bounds* Surface::theBounds

protected

Definition at line 152 of file Surface.h.

Referenced by bounds(), and Plane::computeSpan().

MediumProperties Surface::theMediumProperties

protected

Definition at line 148 of file Surface.h.

Referenced by mediumProperties(), and setMediumProperties().