ObsTests

class lsst.obs.base.tests.ObsTests

Bases: lsst.obs.base.butler_tests.ButlerGetTests, lsst.obs.base.camera_tests.CameraTests

Aggregator class for all of the obs_* test classes.

Inherit from this class, then lsst.utils.tests.TestCase, in that order.

Example subclass:

class TestObs(lsst.obs.base.tests.ObsTests, lsst.utils.tests.TestCase):
    def setUp(self):
        self.setUp_tests(...)
        self.setUp_butler_get(...)
        self.setUp_camera(...)

Notes

The intention is for each obs package to have a single test class that inherits from this collector class, thus “automatically” getting all new tests. If those tests require setup that isn’t defined in a given obs package, that obs package will be broken until updated. This is intentional, as a way to prevent obs packages from falling behind out of neglect.

Methods Summary

setUp_butler_get([ccdExposureId_bits, …]) Set up the necessary variables for butlerGet tests.
setUp_camera([camera_name, n_detectors, …]) Set up the necessary variables for camera tests.
setUp_tests(butler, dataIds) Set up the necessary shared variables used by multiple tests.
tearDown()
test_bias()
test_camera_butler() Check that the butler returns the right type of camera.
test_dark()
test_flat()
test_get_linearizer() Test that we can get a linearizer for good detectorIds.
test_get_linearizer_bad_detectorIds() Do bad detectorIds raise?
test_iterable() Simplest camera test: can we get a Camera instance, and does iterating return Detectors?
test_plate_scale() Check the plate scale at center of focal plane
test_raw()
test_raw_header_wcs() Test that raw_header_wcs returns the unmodified header of the raw image.
test_subset_raw()

Methods Documentation

setUp_butler_get(ccdExposureId_bits=None, exposureIds=None, filters=None, exptimes=None, detectorIds=None, detector_names=None, detector_serials=None, dimensions=None, sky_origin=None, raw_subsets=None, good_detectorIds=None, bad_detectorIds=None, linearizer_type=None, raw_header_wcs=None)

Set up the necessary variables for butlerGet tests.

All “exposure name” entries below should correspond to an entry in self.dataIds.

Parameters:
ccdExposureId_bits : int

expected value of ccdExposureId_bits

exposureIds : dict

dict of exposure name : ccdExposureId (the number as returned by the butler)

filters : dict

dict of exposure name : filter name

exptimes : dict

dict of exposure name : exposure time

detector_names : dict

dict of exposure name : detector name

detectorIds : dict

dict of exposure name : detectorId

detector_serials : dict

dict of exposure name : detector serial

dimensions : dict

dict of exposure name : dimensions (as a geom.Extent2I)

sky_origin : tuple of float

Longitude, Latitude of ‘raw’ exposure

raw_subsets : tuple of (kwargs, int)

keyword args and expected number of subsets for butler.subset('raw', **kwargs)

good_detectorIds : list of int

list of valid ccd numbers

bad_detectorIds : list of int

list of invalid ccd numbers

linearizer_type : dict

dict of detectorId (usually int): LinearizerType (e.g. lsst.ip.isr.LinearizeLookupTable.LinearityType), or unittest.SkipTest to skip all linearizer tests.

raw_header_wcs : lsst.afw.geom.SkyWcs

The SkyWcs object that should be returned by butler.get("raw_header_wcs", dataId=self.dataIds["raw"])

setUp_camera(camera_name=None, n_detectors=None, first_detector_name=None, plate_scale=None)

Set up the necessary variables for camera tests.

Parameters:
camera_name : str

name of this camera

n_detectors : int

number of detectors in this camera

first_detector_name : str

name of the first detector in this camera

plate_scale : lsst.geom.Angle

plate scale at center of focal plane, as angle-on-sky/mm

setUp_tests(butler, dataIds)

Set up the necessary shared variables used by multiple tests.

Parameters:
butler: `lsst.daf.butler.Butler`

A butler object, instantiated on the testdata repository for the obs package being tested.

dataIds: `dict`

dictionary of (exposure name): (dataId of that exposure in the testdata repository), with unittest.SkipTest as the value for any exposures you do not have/do not want to test. It must contain a valid ‘raw’ dataId, in addition to ‘bias’,’flat’,’dark’, which may be set to SkipTest. For example:

self.dataIds = {'raw': {'visit': 1, 'filter': 'g'},
                'bias': {'visit': 1},
                'flat': {'visit': 1},
                'dark': unittest.SkipTest
               }
tearDown()
test_bias()
test_camera_butler()

Check that the butler returns the right type of camera.

test_dark()
test_flat()
test_get_linearizer()

Test that we can get a linearizer for good detectorIds.

test_get_linearizer_bad_detectorIds()

Do bad detectorIds raise?

test_iterable()

Simplest camera test: can we get a Camera instance, and does iterating return Detectors?

test_plate_scale()

Check the plate scale at center of focal plane

Check plate_scale using the FOCAL_PLANE to FIELD_ANGLE transform from the camera.

test_raw()
test_raw_header_wcs()

Test that raw_header_wcs returns the unmodified header of the raw image.

test_subset_raw()