ComCam

class lsst.ts.observatory.control.maintel.ComCam(domain=None, log=None, intended_usage=None, tcs_ready_to_take_data=None)

Bases: BaseCamera

Commissioning Camera (ComCam).

ComCam encapsulates core functionality from the following CSCs CCCamera, CCHeaderService and CCOODS CSCs.

Parameters:

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

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

• log (Logger | None, default: None)

• intended_usage (int | None, default: None)

Attributes Summary

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

Methods Summary

get_available_filters()	Get the list of available filters.
get_available_instrument_setup()	Return available instrument setup.
get_current_filter()	Get the current filter.
get_image_types()	List of valid image types accepted by the take_imgtype method.
parse_sensors(sensors)	Parse input sensors.
setup_filter(filter)	Setup the filter for the camera.
setup_instrument(**kwargs)	Implements abstract method to setup instrument.
take_spot(exptime[, n, group_id, test_type, ...])	Take a series of spot test images.

Attributes Documentation

camera

Camera remote.

usages

valid_use_cases

Returns valid usages.

Returns:

usages

Return type:

enum

Methods Documentation

async get_available_filters()

Get the list of available filters.

Returns:

The set of filters available

Return type:

list of str

async get_available_instrument_setup()

Return available instrument setup. :rtype: List[str]

See also

setup_instrument

Set up instrument.

async get_current_filter()

Get the current filter.

Returns:

The filter in the light path.

Return type:

str

classmethod get_image_types()

List of valid image types accepted by the take_imgtype method.

Return type:

List[str]

parse_sensors(sensors)

Parse input sensors.

Parameters:

sensors (str) – A colon delimited list of sensor names to use for the image.

Returns:

sensors – A valid set of sensors.

Return type:

str

async setup_filter(filter)

Setup the filter for the camera.

Parameters:

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

Returns:

End set filter event data.

Return type:

self.rem.cccamera.evt_endSetFilter.DataType or None

async setup_instrument(**kwargs)

Implements abstract method to setup instrument.

This method will call setup_filter to set the camera filter.

Parameters:

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

Return type:

None

See also

setup_filter

Setup camera filter.

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_spot

Take series of spot images.

take_imgtype

Take series of images by image type.

expose

Low level expose method.

async take_spot(exptime, n=1, group_id=None, test_type=None, reason=None, program=None, sensors=None, note=None, checkpoint=None, **kwargs)

Take a series of spot test images.

Parameters:

• exptime (float) – Exposure time for flats.

• n (int) – Number of frames to take.

• group_id (str) – Optional group id for the data sequence. Will generate a common one for all the data if none is given.

• test_type (str) – Optional string to be added to the keyword testType image header.

• reason (str, optional) – Reason for the data being taken. This must be a short tag-like string that can be used to disambiguate a set of observations.

• program (str, optional) – Name of the program this data belongs to, e.g. WFD, DD, etc.

• sensors (str) – A colon delimited list of sensor names to use for the image.

• note (str) – A freeform string containing small notes about the image.

• checkpoint (coro) – A optional awaitable callback that accepts one string argument that is called before each bias is taken.

• kwargs (Union[int, float, str])

Return type:

List[int]