Class Orientation

Class Documentation

class Orientation

Describe a detector’s orientation in the focal plane

All rotations are about the reference point on the detector. Rotations are intrinsic, meaning each rotation is applied in the coordinates system produced by the previous rotation. Rotations are applied in this order: yaw (Z), pitch (Y’), and roll (X’’).

Warning

: default refPoint is -0.5, -0.5 (the lower left corner of a detector). This means that the default-constructed Orientation is not a unity transform, but instead includes a 1/2 pixel shift.

Public Functions

Orientation(lsst::geom::Point2D const fpPosition = lsst::geom::Point2D(0, ), lsst::geom::Point2D const refPoint = lsst::geom::Point2D(-0.5, ), lsst::geom::Angle const yaw = lsst::geom::Angle(0), lsst::geom::Angle const pitch = lsst::geom::Angle(0), lsst::geom::Angle const roll = lsst::geom::Angle(0))

Parameters
  • fpPosition: Focal plane position of detector reference point (mm)

  • refPoint: Reference point on detector (pixels). Offset is measured to this point and all all rotations are about this point. The default value (-0.5, -0.5) is the lower left corner of the detector.

  • yaw: yaw: rotation about Z (X to Y), 1st rotation

  • pitch: pitch: rotation about Y’ (Z’=Z to X’), 2nd rotation

  • roll: roll: rotation about X’’ (Y’’=Y’ to Z’’), 3rd rotation

~Orientation()
Orientation(Orientation const&)
Orientation(Orientation&&)
Orientation &operator=(Orientation const&)
Orientation &operator=(Orientation&&)
lsst::geom::Point2D getFpPosition() const

Return focal plane position of detector reference point (mm)

lsst::geom::Point2D getReferencePoint() const

Return detector reference point (pixels)

lsst::geom::Angle getYaw() const

Return the yaw angle.

lsst::geom::Angle getPitch() const

Return the pitch angle.

lsst::geom::Angle getRoll() const

Return the roll angle.

int getNQuarter() const

Return the number of quarter turns (rounded to the closest quarter)

std::shared_ptr<geom::TransformPoint2ToPoint2> makePixelFpTransform(lsst::geom::Extent2D const pixelSizeMm) const

Parameters
  • pixelSizeMm: Size of the pixel in mm in X and Y

Generate a Transform from pixel to focal plane coordinates

Return

lsst::afw::geom::Transform from pixel to focal plane coordinates

std::shared_ptr<geom::TransformPoint2ToPoint2> makeFpPixelTransform(lsst::geom::Extent2D const pixelSizeMm) const

Parameters
  • pixelSizeMm: Size of the pixel in mm in X and Y

Generate a Transform from focal plane to pixel coordinates

Return

lsst::afw::geom::Transform from focal plane to pixel coordinates