lsst.afw.cameraGeom.testUtils.DetectorWrapper Class Reference

A Detector and the data used to construct it. More...

Inheritance diagram for lsst.afw.cameraGeom.testUtils.DetectorWrapper:

Public Member Functions
def	__init__
	Construct a DetectorWrapper. More...

Public Attributes
	name
	id
	type
	serial
	bbox
	pixelSize
	ampExtent
	plateScale
	radialDistortion
	ampInfo
	orientation
	transMap
	detector

Detailed Description

A Detector and the data used to construct it.

Intended for use with unit tests, thus saves a copy of all input parameters. Does not support setting details of amplifiers.

Definition at line 17 of file testUtils.py.

Constructor & Destructor Documentation

def lsst.afw.cameraGeom.testUtils.DetectorWrapper.__init__	(		self,
			name = "detector 1",
			id = 1,
			detType = SCIENCE,
			serial = "xkcd722",
			bbox = None,
			numAmps = 3,
			pixelSize = (0.02, 0.02,
			ampExtent = (5, 6,
			orientation = Orientation(),
			plateScale = 20.0,
			radialDistortion = 0.925,
			modFunc = None
	)

Construct a DetectorWrapper.

Parameters

[in]	name	detector name
[in]	id	detector ID (int)
[in]	detType	detector type (an lsst.afw.cameraGeom.DetectorType)
[in]	serial	serial "number" (a string)
[in]	bbox	bounding box; defaults to (0, 0), (1024x1024) (an lsst.afw.geom.Box2I)
[in]	numAmps	number of amplifiers (int)
[in]	pixelSize	pixel size (mm) (an lsst.afw.geom.Point2D)
[in]	ampExtent	dimensions of amplifier image bbox (an lsst.afw.geom.Extent2I)
[in]	orientation	orientation of CCC in focal plane (lsst.afw.cameraGeom.Orientation)
[in]	plateScale	plate scale in arcsec/mm; 20.0 is for LSST
[in]	radialDistortion	radial distortion, in mm/rad^2 (the r^3 coefficient of the radial distortion polynomial that converts PUPIL in radians to FOCAL_PLANE in mm); 0.925 is the value Dave Monet measured for lsstSim data
[in]	modFunc	a function that can modify attributes just before constructing the detector; modFunc receives one argument: a DetectorWrapper with all attributes except detector set.

Definition at line 36 of file testUtils.py.

    ):
        """!Construct a DetectorWrapper

        @param[in] name  detector name
        @param[in] id  detector ID (int)
        @param[in] detType  detector type (an lsst.afw.cameraGeom.DetectorType)
        @param[in] serial  serial "number" (a string)
        @param[in] bbox  bounding box; defaults to (0, 0), (1024x1024) (an lsst.afw.geom.Box2I)
        @param[in] numAmps  number of amplifiers (int)
        @param[in] pixelSize  pixel size (mm) (an lsst.afw.geom.Point2D)
        @param[in] ampExtent  dimensions of amplifier image bbox (an lsst.afw.geom.Extent2I)
        @param[in] orientation  orientation of CCC in focal plane (lsst.afw.cameraGeom.Orientation)
        @param[in] plateScale  plate scale in arcsec/mm; 20.0 is for LSST
        @param[in] radialDistortion  radial distortion, in mm/rad^2
            (the r^3 coefficient of the radial distortion polynomial
            that converts PUPIL in radians to FOCAL_PLANE in mm);
            0.925 is the value Dave Monet measured for lsstSim data
        @param[in] modFunc  a function that can modify attributes just before constructing the detector;
            modFunc receives one argument: a DetectorWrapper with all attributes except detector set.
        """
        # note that (0., 0.) for the reference position is the center of the first pixel
        self.name = name
        self.id = int(id)
        self.type = detType
        self.serial = serial
        if bbox is None:
            bbox = afwGeom.Box2I(afwGeom.Point2I(0, 0), afwGeom.Extent2I(1024, 1048))
        self.bbox = bbox
        self.pixelSize = afwGeom.Extent2D(*pixelSize)
        self.ampExtent = afwGeom.Extent2I(*ampExtent)
        self.plateScale = float(plateScale)
        self.radialDistortion = float(radialDistortion)
        schema = afwTable.AmpInfoTable.makeMinimalSchema()
        self.ampInfo = afwTable.AmpInfoCatalog(schema)
        for i in range(numAmps):
            record = self.ampInfo.addNew()
            ampName = "amp %d" % (i + 1,)
            record.setName(ampName)
            record.setBBox(afwGeom.Box2I(afwGeom.Point2I(-1, 1), self.ampExtent))
            record.setGain(1.71234e3)
            record.setReadNoise(0.521237e2)
            record.setReadoutCorner(afwTable.LL)
            record.setHasRawInfo(False)
        self.orientation = orientation

        # compute TAN_PIXELS transform
        pScaleRad = afwGeom.arcsecToRad(self.plateScale)
        radialDistortCoeffs = [0.0, 1.0/pScaleRad, 0.0, self.radialDistortion/pScaleRad]
        focalPlaneToPupil = afwGeom.RadialXYTransform(radialDistortCoeffs)
        pixelToTanPixel = makePixelToTanPixel(
            bbox = self.bbox,
            orientation = self.orientation,
            focalPlaneToPupil = focalPlaneToPupil,
            pixelSizeMm = self.pixelSize,
            plateScale = self.plateScale,
        )

        self.transMap = {
            FOCAL_PLANE: self.orientation.makePixelFpTransform(self.pixelSize),
            CameraSys(TAN_PIXELS, self.name): pixelToTanPixel,
            CameraSys(ACTUAL_PIXELS, self.name): afwGeom.RadialXYTransform([0, 0.95, 0.01]),
        }
        if modFunc:
            modFunc(self)
        self.detector = Detector(
            self.name,
            self.id,
            self.type,
            self.serial,
            self.bbox,
            self.ampInfo,
            self.orientation,
            self.pixelSize,
            self.transMap,
        )