Surface Class Reference

#include <Surface.h>

Inheritance diagram for Surface:

Public Types
using	Base = GloballyPositioned< float >
using	Side = SurfaceOrientation::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 &)
	BasicReferenceCounted (BasicReferenceCounted &&)=default
BasicReferenceCounted &	operator= (BasicReferenceCounted &&)=default
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)
	Surface (Surface &&iSurface)

Protected Attributes
extstd::clone_ptr< 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 42 of file Surface.h.

Member Typedef Documentation

using Surface::Base = GloballyPositioned<float>

Definition at line 48 of file Surface.h.

using Surface::Side = SurfaceOrientation::Side

Definition at line 46 of file Surface.h.

Constructor & Destructor Documentation

virtual Surface::~Surface ( )

inlinevirtual

Definition at line 50 of file Surface.h.

{}

Surface::Surface ( )

inlineprotected

Definition at line 53 of file Surface.h.

{}

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

inlineprotected

Definition at line 54 of file Surface.h.

                                                             :
    Base( pos, rot) {}

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

inlineprotected

Definition at line 57 of file Surface.h.

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

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

inlineprotected

Definition at line 64 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 70 of file Surface.h.

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

Surface::Surface ( const Surface &  iSurface )

inlineprotected

Definition at line 80 of file Surface.h.

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

Surface::Surface ( Surface &&  iSurface )

inlineprotected

Definition at line 86 of file Surface.h.

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

Member Function Documentation

const Bounds& Surface::bounds ( ) const

inline

Definition at line 120 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(), ThirdHitCorrection::init(), InnerDeltaPhi::initBarrelLayer(), InnerDeltaPhi::initBarrelMS(), InnerDeltaPhi::initForwardLayer(), ThirdHitRZPredictionBase::initLayer(), ThirdHitPrediction::initLayer(), Disk::innerRadius(), MuonDetIdAssociator::insideElement(), DeDxTools::IsFarFromBorder(), ShallowGainCalibration::IsFarFromBorder(), SiStripGainFromData::IsFarFromBorder(), SimpleNavigationSchool::linkNextForwardLayer(), TrajectoryManager::makeSinglePSimHit(), SiStripGainCosmicCalculator::moduleThickness(), SiStripGainCosmicCalculator::moduleWidth(), MSLayer::MSLayer(), MuonResidualsFromTrack::MuonResidualsFromTrack(), CylinderBuilderFromDet::operator()(), Disk::outerRadius(), TIBLayer::overlap(), PixelBlade::overlap(), Phase1PixelBlade::overlap(), phiSpan(), MuonNavigationPrinter::printLayer(), StandaloneTrackMonitor::processClusters(), StandaloneTrackMonitor::processHit(), DeDxHitInfoProducer::processHit(), HSCPDeDxInfoProducer::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 112 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 123 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 125 of file Surface.h.

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

{ return bounds().rSpan(); }

void Surface::setMediumProperties ( const MediumProperties &  mp )

inline

Definition at line 116 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 Cylinder, Plane, 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 99 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 106 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(), 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(), GEMRecHitMatcher::recHitPosition(), 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 124 of file Surface.h.

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

{ return bounds().zSpan(); }

Member Data Documentation

extstd::clone_ptr<Bounds> Surface::theBounds

protected

Definition at line 141 of file Surface.h.

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

MediumProperties Surface::theMediumProperties

protected

Definition at line 140 of file Surface.h.

Referenced by mediumProperties(), and setMediumProperties().