IntrinsicZernikes#

class lsst.ip.isr.IntrinsicZernikes(table=None, **kwargs)#

Bases: IsrCalib

Intrinsic Zernike coefficients.

Stores Zernike wavefront-error coefficients sampled at a set of focal-plane field angles. At query time the coefficients are interpolated to an arbitrary field position.

Field angles are expressed in the Camera Coordinate System (CCS), also known as the Engineering Diagram Coordinate System. See LSE-349 for the definition.

Parameters#

tableastropy.table.Table, optional

Source table. Must contain columns:

"x": Field x positions (in CCS) with angular units (e.g. u.deg).
"y": Field y positions (in CCS) with angular units (e.g. u.deg).
"Z{j}": One column per Noll index j, with length units (e.g. u.um).

Attributes#

field_xnumpy.ndarray: CCS x field positions in degrees for all sample points, shape (n_points,).
field_ynumpy.ndarray: CCS y field positions in degrees for all sample points, shape (n_points,).
noll_indicesnumpy.ndarray: Noll indices of the stored Zernike terms, shape (n_zernikes,).
valuesnumpy.ndarray: Zernike coefficients in microns, shape (n_points, n_zernikes).
interpolatorscipy.interpolate.LinearNDInterpolator or None: Interpolator built from field_x, field_y, and values. None until the calibration is populated.

Methods Summary

`fromDict`(dictionary)	Construct an IntrinsicZernikes from dictionary of properties.
`fromTable`(tableList)	Construct calibration from a list of tables.
`getIntrinsicZernikes`(field_x, field_y[, ...])	Get the intrinsic Zernike coefficients at a given field position.
`toDict`()	Return a dictionary containing the calibration properties.
`toTable`()	Construct a list of tables containing the information in this calibration.

Methods Documentation

classmethod fromDict(dictionary)#

Construct an IntrinsicZernikes from dictionary of properties.

Parameters#

dictionarydict: Dictionary of properties.

Returns#

caliblsst.ip.isr.IntrinsicZernikes: Constructed calibration.

Raises#

RuntimeError: Raised if the supplied dictionary is for a different calibration type.

classmethod fromTable(tableList)#

Construct calibration from a list of tables.

Parameters#

tableListlist [astropy.table.Table]: List of tables to use to construct the intrinsic zernikes calibration.

Returns#

caliblsst.ip.isr.IntrinsicZernikes: The calibration defined in the tables.

getIntrinsicZernikes(field_x, field_y, noll_indices=None)#

Get the intrinsic Zernike coefficients at a given field position.

Parameters#

field_xarray-like: CCS x-field positions in degrees.
field_yarray-like: CCS y-field positions in degrees.
noll_indiceslist [int], optional: List of Noll indices to return. If None, return all.

Returns#

zernikesarray-like: Array of Zernike coefficient values in microns corresponding to the requested Noll indices and field positions.

toDict()#

Return a dictionary containing the calibration properties.

The dictionary should be able to be round-tripped through fromDict.

Returns#

dictionarydict: Dictionary of properties.

toTable()#

Construct a list of tables containing the information in this calibration.

The list of tables should be able to be round-tripped through fromTable.

Returns#

tableListlist [astropy.table.Table]: List of tables containing the intrinsic zernikes calibration information.