AbstractLinearInstrument#

class ctis.instruments.AbstractLinearInstrument[source]#

Bases: AbstractInstrument

An instrument where the forward model can be represented using matrix multiplication.

Attributes

`axis_channel`	The logical axis or axes of this instrument corresponding to the different CTIS channels.
`axis_scene_xy`	The logical axes of `coordinates_scene` corresponding to changing position coordinate.
`axis_sensor_xy`	The logical axes of `coordinates_sensor` corresponding to changing position coordinate.
`axis_wavelength`	The logical axis of `coordinates_scene` and `coordinates_sensor` that corresponds to changing wavelength coordinate.
`channel`	Human-readable name of each independent CTIS channel.
`coordinates_scene`	A grid of wavelength and position coordinates on the skyplane which will be used to construct the inverted scene.
`coordinates_sensor`	A grid of wavelength and position coordinates on the detector plane.
`num_channel`	The total number of dispersion magnitudes/angles observed by this instrument.
`uncertainty`	A function that returns the standard deviation of the uncertainty for a given number of photons.
`weights`	The contribution of each voxel on the skyplane to each pixel on the detector.
`weights_transpose`	The contribution of each pixel on the detector to each voxel on the skyplane.

Methods

`__init__`()
`backproject`(image[, integrate])	The backward model of this CTIS instrument, which maps photons measured by the sensor to spectral radiance on the skyplane.
`image`(scene[, integrate, noise])	The forward model of this CTIS instrument, which maps spectral radiance on the skyplane to photons measured by the instrument's sensor.

Inheritance Diagram

backproject(image, integrate=True)[source]#

The backward model of this CTIS instrument, which maps photons measured by the sensor to spectral radiance on the skyplane.

This is the complementary operation to image(), but it is not an inverse of image(), this method will spread out the photons from each pixel evenly across the voxels in the scene that could have contributed to the measured signal.

Parameters:

image (AbstractScalar | AbstractFunctionArray) – A series of images captured by a CTIS instrument, evaluated on coordinates_sensor, in units of photons.
integrate (bool) – Complement of the integrate keyword of image().

Return type:

FunctionArray[SpectralPositionalVectorArray, AbstractScalar]

image(scene, integrate=True, noise=True)[source]#

The forward model of this CTIS instrument, which maps spectral radiance on the skyplane to photons measured by the instrument’s sensor.

Parameters:

scene (AbstractScalar | AbstractFunctionArray) – The spectral radiance of an observed scene, evaluated on coordinates_scene, in units equivalent to \(\text{erg} \, \text{cm}^{-2} \, \text{sr}^{-1} \, \AA^{-1} \, \text{s}^{-1}\).
integrate (bool) – Whether to integrate along the wavelength axis. A real CTIS instrument integrates along wavelength, but sometimes it’s useful to keep the wavelengths separate for demonstration purposes.
noise (bool) – Whether to include the effect of noise in the final image.

Return type:

FunctionArray[SpectralPositionalVectorArray, AbstractScalar]

abstract property axis_channel: str | tuple[str, ...]#: The logical axis or axes of this instrument corresponding to the different CTIS channels.

abstract property axis_scene_xy: tuple[str, str]#: The logical axes of coordinates_scene corresponding to changing position coordinate.

abstract property axis_sensor_xy: tuple[str, str]#: The logical axes of coordinates_sensor corresponding to changing position coordinate.

abstract property axis_wavelength: str#: The logical axis of coordinates_scene and coordinates_sensor that corresponds to changing wavelength coordinate.

abstract property channel#: Human-readable name of each independent CTIS channel.

abstract property coordinates_scene: AbstractSpectralPositionalVectorArray#

A grid of wavelength and position coordinates on the skyplane which will be used to construct the inverted scene.

Normally the pitch of this grid is chosen to be the average plate scale of the instrument.

abstract property coordinates_sensor: AbstractSpectralPositionalVectorArray#: A grid of wavelength and position coordinates on the detector plane.

property num_channel: int#: The total number of dispersion magnitudes/angles observed by this instrument.

abstract property uncertainty: Callable[[ScalarArray], ScalarArray]#: A function that returns the standard deviation of the uncertainty for a given number of photons.

abstract property weights: tuple[AbstractScalar, dict[str, int], dict[str, int]]#: The contribution of each voxel on the skyplane to each pixel on the detector.

abstract property weights_transpose: tuple[AbstractScalar, dict[str, int], dict[str, int]]#: The contribution of each pixel on the detector to each voxel on the skyplane.