LATISS

class lsst.ts.observatory.control.auxtel.LATISS(domain=None, log=None, intended_usage=None, tcs_ready_to_take_data=None)

Bases: BaseCamera

LSST Auxiliary Telescope Image and Slit less Spectrograph (LATISS).

LATISS encapsulates core functionality from the following CSCs ATCamera, ATSpectrograph, ATHeaderService and ATOODS CSCs.

Parameters:

• domain (lsst.ts.salobj.Domain) – Domain for remotes. If None create a domain.

• log (logging.Logger) – Optional logging class to be used for logging operations. If None, creates a new logger. Useful to use in salobj.BaseScript and allow logging in the class use the script logging.

• intended_usage (int) – Optional integer that maps to a list of intended operations. This is used to limit the resources allocated by the class by gathering some knowledge about the usage intention. By default allocates all resources.

• tcs_ready_to_take_data (coroutine) – A coroutine that waits for the telescope control system to be ready to take data.

Attributes Summary

camera	Camera remote.
usages	Define class usages.
valid_use_cases	Returns valid usages.

Methods Summary

get_available_instrument_setup()	Return available instrument setup.
get_setup()	Get the current filter, grating and stage position
parse_sensors(sensors)	Parse input sensors.
setup_atspec([filter, grating, linear_stage])	Encapsulates commands to setup spectrograph.
setup_instrument(**kwargs)	Implements abstract method to setup instrument.

Attributes Documentation

camera

Camera remote.

usages

valid_use_cases

Returns valid usages.

Returns:

usages

Return type:

enum

Methods Documentation

async get_available_instrument_setup()

Return available instrument setup.

Return type:

Tuple[List[str], List[str], List[str]]

Returns:

• available_filters (list) – List of available filters.

• available_gratings (list) – List of available gratings.

• linear_state_limits (list) – Min/Max values for linear state.

See also

setup_instrument

Set up instrument.

async get_setup()

Get the current filter, grating and stage position

Return type:

Tuple[str, str, float]

Returns:

• str – Name of filter currently in the beam

• str – Name of disperser currently in the beam

• float – Position of linear stage holding the dispersers

parse_sensors(sensors)

Parse input sensors.

For ATCamera this should always be an empty string.

Parameters:

sensors (str) – This field is ignored by LATISS.

Returns:

sensors – A valid set of sensors.

Return type:

str

async setup_atspec(filter=None, grating=None, linear_stage=None)

Encapsulates commands to setup spectrograph.

Parameters:

• filter (None or int or str) – Filter id or name. If None, do not change the filter.

• grating (None or int or str) – Grating id or name. If None, do not change the grating.

• linear_stage (None or float) – Linear stage position. If None, do not change the linear stage.

Return type:

None

async setup_instrument(**kwargs)

Implements abstract method to setup instrument.

This method will call setup_atspec to set filter, grating and linear_stage.

Parameters:

**kwargs (Union[int, float, str, None]) – Arbitrary keyword arguments.

Return type:

None

See also

setup_atspec

Setup spectrograph.

take_bias

Take series of bias.

take_darks

Take series of darks.

take_flats

Take series of flat-field images.

take_object

Take series of object observations.

take_engtest

Take series of engineering test observations.

take_focus

Take series of focus images.

take_cwfs

Take series of curvature wavefront sensing images.

take_acq

Take series of acquisition images.

take_stuttered

Take series of stuttered images.

take_indome

Take series of in-dome testing images.

take_cbp

Take series of collimated beam projector images.

take_sflat

Take series of sky/twilight-flat images.

take_dflat

Take series of dark-flat images.

take_imgtype

Take series of images by image type.

expose

Low level expose method.