LSSTApplications  18.0.0+106,18.0.0+50,19.0.0,19.0.0+1,19.0.0+10,19.0.0+11,19.0.0+13,19.0.0+17,19.0.0+2,19.0.0-1-g20d9b18+6,19.0.0-1-g425ff20,19.0.0-1-g5549ca4,19.0.0-1-g580fafe+6,19.0.0-1-g6fe20d0+1,19.0.0-1-g7011481+9,19.0.0-1-g8c57eb9+6,19.0.0-1-gb5175dc+11,19.0.0-1-gdc0e4a7+9,19.0.0-1-ge272bc4+6,19.0.0-1-ge3aa853,19.0.0-10-g448f008b,19.0.0-12-g6990b2c,19.0.0-2-g0d9f9cd+11,19.0.0-2-g3d9e4fb2+11,19.0.0-2-g5037de4,19.0.0-2-gb96a1c4+3,19.0.0-2-gd955cfd+15,19.0.0-3-g2d13df8,19.0.0-3-g6f3c7dc,19.0.0-4-g725f80e+11,19.0.0-4-ga671dab3b+1,19.0.0-4-gad373c5+3,19.0.0-5-ga2acb9c+2,19.0.0-5-gfe96e6c+2,w.2020.01
LSSTDataManagementBasePackage
Functions
lsst.afw.cameraGeom.makePixelToTanPixel Namespace Reference

Functions

def makePixelToTanPixel (bbox, orientation, focalPlaneToField, pixelSizeMm)
 

Function Documentation

◆ makePixelToTanPixel()

def lsst.afw.cameraGeom.makePixelToTanPixel.makePixelToTanPixel (   bbox,
  orientation,
  focalPlaneToField,
  pixelSizeMm 
) 
Make a Transform whose forward direction converts PIXELS to TAN_PIXELS
for one detector.

Parameters
----------
bbox : `lsst.geom.Box2I`
    Detector bounding box.
orientation : `lsst.afw.cameraGeom.Orientation`
    Orientation of detector in focal plane.
focalPlaneToField : `lsst.afw.geom.TransformPoint2ToPoint2`
    A transform that converts from focal plane (mm) to field angle
    coordinates (radians) in the forward direction.
pixelSizeMm : `lsst.geom.Extent2D`
    Size of the pixel in mm in X and Y.

Returns
-------
transform : `lsst.afw.geom.TransformPoint2ToPoint2`
    A transform whose forward direction converts PIXELS to TAN_PIXELS.

Notes
-----
PIXELS and TAN_PIXELS are described in the CameraGeom documentation under
:ref:`camera coordinate systems<section_Camera_Coordinate_Systems>`.

Definition at line 28 of file makePixelToTanPixel.py.

28 def makePixelToTanPixel(bbox, orientation, focalPlaneToField, pixelSizeMm):
29  """Make a Transform whose forward direction converts PIXELS to TAN_PIXELS
30  for one detector.
31 
32  Parameters
33  ----------
34  bbox : `lsst.geom.Box2I`
35  Detector bounding box.
36  orientation : `lsst.afw.cameraGeom.Orientation`
37  Orientation of detector in focal plane.
38  focalPlaneToField : `lsst.afw.geom.TransformPoint2ToPoint2`
39  A transform that converts from focal plane (mm) to field angle
40  coordinates (radians) in the forward direction.
41  pixelSizeMm : `lsst.geom.Extent2D`
42  Size of the pixel in mm in X and Y.
43 
44  Returns
45  -------
46  transform : `lsst.afw.geom.TransformPoint2ToPoint2`
47  A transform whose forward direction converts PIXELS to TAN_PIXELS.
48 
49  Notes
50  -----
51  PIXELS and TAN_PIXELS are described in the CameraGeom documentation under
52  :ref:`camera coordinate systems<section_Camera_Coordinate_Systems>`.
53  """
54  pixelToFocalPlane = orientation.makePixelFpTransform(pixelSizeMm)
55  pixelToField = pixelToFocalPlane.then(focalPlaneToField)
56  # fieldToTanPix is affine and matches fieldToPix at field center
57  # Note: focal plane to field angle is typically a radial transform,
58  # and linearizing the inverse transform of that may fail,
59  # so linearize the forward direction instead. (pixelToField is pixelToFocalPlane,
60  # an affine transform, followed by focalPlaneToField,
61  # so the same consideration applies to pixelToField)
62  pixAtFieldCtr = pixelToField.applyInverse(lsst.geom.Point2D(0, 0))
63  tanPixToFieldAffine = lsst.afw.geom.linearizeTransform(pixelToField, pixAtFieldCtr)
64  fieldToTanPix = lsst.afw.geom.makeTransform(tanPixToFieldAffine.inverted())
65 
66  return pixelToField.then(fieldToTanPix)
67 
lsst::afw::geom::linearizeTransform
lsst::geom::AffineTransform linearizeTransform(TransformPoint2ToPoint2 const &original, lsst::geom::Point2D const &inPoint)
Approximate a Transform by its local linearization.
Definition: transformFactory.cc:132
lsst::afw::cameraGeom.makePixelToTanPixel.makePixelToTanPixel
def makePixelToTanPixel(bbox, orientation, focalPlaneToField, pixelSizeMm)
Definition: makePixelToTanPixel.py:28
lsst::afw::geom::makeTransform
std::shared_ptr< TransformPoint2ToPoint2 > makeTransform(lsst::geom::AffineTransform const &affine)
Wrap an lsst::geom::AffineTransform as a Transform.
Definition: transformFactory.cc:154
Generated on Wed Jan 8 2020 09:11:32 for LSSTApplications by   doxygen 1.8.13