ATCS¶

class lsst.ts.observatory.control.auxtel.ATCS(domain: Domain | None = None, log: Logger | None = None, intended_usage: int | None = None)¶

Bases: BaseTCS

High level library for the Auxiliary Telescope Control System

This is the high level interface for interacting with the CSCs that control the Auxiliary Telescope. Essentially this will allow the user to slew and track the telescope.

Parameters:

domain: `salobj.Domain`: Domain to use of the Remotes. If None, create a new domain.
loglogging.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.

Attributes:

atmcs: salobj.Remote
ataos: salobj.Remote
atpneumatics: salobj.Remote
athexapod: salobj.Remote
atdome: salobj.Remote
atdometrajectory: salobj.Remote
check: SimpleNamespace
log: logging.Logger

Attributes Summary

`CoordFrame`	Return CoordFrame enumeration.
`RotFrame`	Return RotFrame enumeration.
`RotMode`	Return RotMode enumeration.
`WrapStrategy`	Return WrapStrategy enumeration
`components`	List of components names.
`components_attr`	List of remotes names.
`dome_trajectory_name`	Return name of the DomeTrajectory component.
`instrument_focus`
`plate_scale`	Plate scale in mm/arcsec.
`ptg_name`	Return name of the pointing component.
`telescope_position`
`telescope_target`
`usages`	Define class usages.
`valid_use_cases`	Returns valid usages.

Methods Summary

`add_point_data`()	Add current position to a point file.
`assert_all_enabled`([message])	Check if all components are in the enabled state.
`assert_ataos_corrections_enabled`()	Assert that m1, hexapod and atspectrograph corrections are enabled.
`assert_liveliness`()	Assert liveliness of components belonging to the group.
`assert_m1_correction_disabled`([message])	Assert that m1 corrections is disabled.
`ataos_corrections_completed`()	Check that all ATAOS corrections completed.
`atmcs_in_position`()	Check if atmcs is in position.
`atmcs_target_callback`(data)	Callback function to update the telescope target event topic.
`azel_from_radec`(ra, dec[, time])	Calculate Az/El coordinates from RA/Dec in ICRS.
`cancel_not_done`(tasks)	Cancel all coroutines in `coro_list`.
`check_comp_heartbeat`(component)	Monitor heartbeats from the specified component and raises and exception if not.
`check_component_state`(component[, desired_state])	Monitor the summary state of a component and raises an exception if it is or goes to a state different than the desired state.
`check_dome_following`()	Check if dome following is enabled.
`check_target_status`()	Check the targeting status of the atmcs.
`check_tracking`([track_duration])	Check tracking state.
`clear_catalog`()	Clear internal catalog.
`close`()
`close_dome`([force])	Task to close ATDome.
`close_dropout_door`()	Close ATDome dropout door
`close_m1_cover`()	Task to close m1 cover.
`close_m1_vent`()	Task to open m1 vents.
`components_to_check`()	Return components for which check is enabled.
`disable_ataos_corrections`([ignore_fail])	Disable ATAOS corrections.
`disable_checks_for_components`(components)	Disables checks for a list of components.
`disable_dome_following`([check])	Disable dome following mode.
`enable`([overrides])	Enable all components.
`enable_ataos_corrections`()	Enable ATAOS corrections.
`enable_dome_following`([check])	Enabled dome following mode.
`enable_monitor`()	Enable monitor.
`expand_overrides`([overrides])	Expand an overrides dict with entries for every component.
`find_target`(az, el, mag_limit[, mag_range, ...])	Make a cone search and return a target close to the specified position.
`find_target_dm_butler`(az, el, mag_limit[, ...])	Make a cone search in the butler source catalog and return a target in the magnitude range, close to the specified position.
`find_target_local_catalog`(az, el, mag_limit)	Make a cone search in the internal catalog and return a target in the magnitude range, close to the specified position.
`find_target_simbad`(az, el, mag_limit[, ...])	Make a cone search in the HD catalog using Simbad and return a target with magnitude inside the magnitude range, close to the specified position.
`flush_offset_events`()	Implement abstract method to flush events before an offset is performed.
`focus_offset`(offset)	Apply focus offset.
`get_bore_sight_angle`()	Get the instrument bore sight angle with respect to the telescope axis.
`get_heartbeat`(component)	Get last heartbeat for component.
`get_identity`()	Get user identity.
`get_required_resources`(component, intended_usage)	Return the required resources based on the intended usage of the class.
`get_rot_angle_alternatives`(rot_angle)	Generate rotator angle alternatives based on the input rotator angle.
`get_selected_nasmyth_angle`()	Get selected nasmyth angle.
`get_simulation_mode`([components])	Return a list with the simulation mode for components in the group.
`get_software_versions`([components])	Return a list with the software versions for components in the group.
`get_state`(component[, ignore_timeout])	Get summary state for component.
`get_sun_azel`([time_tai])	Get the sun azimuth and elevation.
`get_telescope_and_dome_vent_azimuth`()	Get the telescope and dome vent azimuth.
`get_work_components`([components])	Parse input into a list of valid components from the group.
`home_dome`([force])	Task to execute dome home command and wait for it to complete.
`in_pneumatics_operational_range`()	Check if ATMCS is in operational range for pneumatics operation.
`is_catalog_loaded`()	Check if catalog is loaded.
`is_dome_homed`()	Verify if the dome is homed.
`is_monitor_enabled`()	Is monitor position flag enabled?
`list_available_catalogs`()	List of available catalogs to load.
`load_catalog`(catalog_name)	Load a catalog from the available set.
`monitor_position`([check])	Monitor and log the position of the telescope and the dome.
`mount_AzEl_Encoders_callback`(data)	Callback function to update the telescope position telemetry topic.
`next_heartbeat`(component)	Get next heartbeat for component.
`next_state`(component)	Get summary state for component.
`next_telescope_position`([timeout])	Wait for next telescope position to become available and return data.
`next_telescope_target`([timeout])	Wait for next telescope position to become available and return data.
`object_list_add`(name, radec)	Add object to object list.
`object_list_clear`()	Remove all objects stored in the internal object list.
`object_list_get`(name)	Get an object from the list or query Simbad and return it.
`object_list_get_all`()	Return list of objects in the object list.
`object_list_remove`(name)	Remove object from object list.
`offline`()	Put all CSCs in offline.
`offset_aos_lut`([z, x, y, u, v, m1, ...])	Apply offsets to hexapod and optionally re-center telescope after hexapod offset.
`offset_azel`(az, el[, relative, persistent, ...])	Offset telescope in azimuth and elevation.
`offset_done`()	Wait for events specifying that an offset completed.
`offset_pa`(angle, radius)	Offset the telescope based on a position angle and radius.
`offset_radec`(ra, dec)	Offset telescope in RA and Dec.
`offset_rot`(rot)	Apply a rotation offset.
`offset_xy`(x, y[, relative, persistent, absorb])	Offsets in the detector X/Y plane.
`open_dome_shutter`()	Task to open dome shutter and return when it is done.
`open_dropout_door`()	Open ATdome dropout door.
`open_m1_cover`()	Task to open m1 cover.
`open_m1_vent`()	Task to open m1 vents.
`open_valve_instrument`()	Open ATPneumatics instrument valve.
`open_valve_main`()	Open ATPneumatics main valve.
`open_valves`()	Open the air valve system on ATPneumatics.
`parallactic_angle`(ra, dec[, time])	Return parallactic angle for the given Ra/Dec coordinates.
`point_azel`(az, el[, rot_tel, target_name, ...])	Slew the telescope to a fixed alt/az position.
`prepare_for_flatfield`([check])	A high level method to position the telescope and dome for flat field operations.
`prepare_for_onsky`([overrides])	Prepare Auxiliary Telescope for on-sky operations.
`prepare_for_vent`([partially_open_dome])	Prepare Auxiliary Telescope for venting.
`process_as_completed`(tasks)	Process tasks are they complete.
`radec_from_azel`(az, el[, time])	Calculate Ra/Dec in ICRS coordinates from Az/El.
`ready_to_offset`()	A context manager to handle preparing the telescope for offset.
`ready_to_take_data`()	Wait for the telescope control system to be ready to take data.
`reset_checks`()	Reset all checks, enabling check for all components.
`reset_offsets`([absorbed, non_absorbed])	Reset pointing offsets.
`rotation_matrix`(angle)	Rotation matrix.
`set_azel_slew_checks`(wait_dome)	Handle azEl slew to wait or not for the dome.
`set_rem_loglevel`(level)	Set remotes log level.
`set_rot_angle_alternatives`(...)	Set the rotator angle alternatives.
`set_state`(state[, overrides, components])	Set summary state for all components.
`shutdown`()	Shutdown ATTCS components.
`slew`(ra, dec[, rotPA, target_name, frame, ...])	Slew the telescope and start tracking an Ra/Dec target.
`slew_dome_to`(az[, check])	Utility method to slew dome to a specified position.
`slew_ephem_target`(ephem_file, target_name[, ...])	Slew the telescope to a target defined by ephemeris data defined in a file.
`slew_icrs`(ra, dec[, rot, rot_type, ...])	Slew the telescope and start tracking an Ra/Dec target in ICRS coordinate frame.
`slew_object`(name[, rot, rot_type, dra, ...])	Slew to an object name.
`slew_to_planet`(planet[, rot_sky, slew_timeout])	Slew and track a solar system body.
`slew_to_pneumatics_operational_range`()	Slew the telescope to safe range for pneumatics operation.
`standby`()	Put all CSCs in standby.
`start_tracking`([slew_timeout])	Start tracking the current position of the telescope.
`stop_all`()	Stop telescope and dome.
`stop_dome`()	Stop all dome motion.
`stop_monitor`()	Stop any monitor position.
`stop_tracking`()	Task to stop telescope tracking.
`wait_for_atdome_inposition`(timeout)	Wait until the telescope is cleared by the dome.
`wait_for_atdome_shutter_inposition`()	Wait for the atdome shutter to be in position.
`wait_for_atmcs_inposition`(timeout)	Wait for inPosition of atmcs to be ready.
`wait_for_inposition`(timeout, wait_settle[, ...])	Wait for both the ATMCS and ATDome to be in position.
`wait_tracking_stopped`()	Task to wait until tracking has stopped.

Attributes Documentation

CoordFrame¶: Return CoordFrame enumeration.

RotFrame¶: Return RotFrame enumeration.

RotMode¶: Return RotMode enumeration.

WrapStrategy¶: Return WrapStrategy enumeration

components¶

List of components names.

The name of the CSC follow the format used in the class constructor, e.g. CSCName or CSCName:index (for indexed components), e.g. “Hexapod:1” (for Hexapod with index=1) or “ATHexapod”.

Returns:

componentslist of str: List of CSCs names.

components_attr¶

List of remotes names.

The remotes names are reformatted to fit the requirements for object attributes. It will be the name of the CSC (as in components) in lowercase, replacing the colon by an underscore, e.g. “Hexapod:1” -> “hexapod_1” or “ATHexapod” -> “athexapod”.

Returns:

components_attrlist of str: List of remotes attribute names.

dome_trajectory_name¶: Return name of the DomeTrajectory component.

instrument_focus¶

plate_scale¶: Plate scale in mm/arcsec.

ptg_name¶: Return name of the pointing component.

telescope_position¶

telescope_target¶

usages¶

valid_use_cases¶

Returns valid usages.

When subclassing, overwrite this method to return the proper enum.

Returns:

usages: enum

Methods Documentation

async add_point_data() → None¶: Add current position to a point file. If a file is open it will append to that file. If no file is opened it will open a new one.

async assert_all_enabled(message: str = '') → None¶

Check if all components are in the enabled state.

Parameters:

message: `str`: Additional message to append to error.

async assert_ataos_corrections_enabled() → None¶

Assert that m1, hexapod and atspectrograph corrections are enabled.

Raises:

AssertionError: If ATAOS m1, hexapod, or atspectrograph corrections are disabled.

async assert_liveliness() → None¶

Assert liveliness of components belonging to the group.

The assertion is done by waiting for a new heartbeat from the component. The check feature will apply to the assertion so components marked with check=False will be skipped.

Raises:

AssertionError: If cannot get heartbeat for one or more components.

async assert_m1_correction_disabled(message: str = '') → None¶

Assert that m1 corrections is disabled.

Parameters:

messagestr: Additional message to append to error.

Raises:

AssertionError: If ATAOS m1 corrections are enabled.

async ataos_corrections_completed() → bool¶

Check that all ATAOS corrections completed.

Returns:

corrections_completed: bool: Returns True when corrections are completed.

async atmcs_in_position() → bool¶

Check if atmcs is in position.

This method will try to get the next event published after the call. If it fails, it will return the last event seen. If no event was ever seen, it will fail with a TimeoutError.

Returns:

in_position: bool: In position flag value.

async atmcs_target_callback(data: BaseMsgType) → None¶: Callback function to update the telescope target event topic.

Calculate Az/El coordinates from RA/Dec in ICRS.

Parameters:

rafloat, str or astropy.coordinates.Angle: Target RA, either as a float (hour), a sexagesimal string (HH:MM:SS.S or HH MM SS.S) coordinates or astropy.coordinates.Angle.
decfloat, str or astropy.coordinates.Angle: Target Dec, either as a float (deg), a sexagesimal string (DD:MM:SS.S or DD MM SS.S) coordinates or astropy.coordinates.Angle.
timeastropy.time.core.Time or None, optional: The time which the coordinate trasformation is intended for. If None (default) use current time.

Returns:

azelastropy.coordinates.AltAz: Astropy coordinates with azimuth and elevation.

async static cancel_not_done(tasks: List[Task]) → None¶

Cancel all coroutines in coro_list.

Remove futures from input tasks list and cancel them.

Parameters:

taskslist [futures]: A list of coroutines to cancel.

async check_comp_heartbeat(component: str) → None¶

Monitor heartbeats from the specified component and raises and exception if not.

This method will run forever as long as the component continues to send heartbeats. The intention is that this can run alongside an operation, to make sure the component remains responsive.

Parameters:

componentstr: Name of the component to follow. The name of the CSC follow the format CSCName or CSCName:index (for indexed components), e.g. “Hexapod:1” (for Hexapod with index=1) or “ATHexapod”.

Raises:

RuntimeError: If the component does not send heartbeats in self.fast_timeout seconds.

async check_component_state(component: str, desired_state: State = State.ENABLED) → None¶

Monitor the summary state of a component and raises an exception if it is or goes to a state different than the desired state.

This method will run forever as long as the summary state remains unchanged. The intention is that this can run alongside an operation that require the component to be in a certain state, when the operation is completed, the task can be canceled.

Parameters:

componentstr: Name of the component to follow. Must be one of: atmcs, atptg, ataos, atpneumatics, athexapod, atdome, atdometrajectory
desired_statesalobj.State: Desired state of the CSC.

Raises:

RuntimeError: If state is not desired_state.
KeyError: If component is not found.

async check_dome_following() → bool¶

Check if dome following is enabled.

Returns:

dome_followingbool: True is enabled False otherwise.

async check_target_status() → None¶: Check the targeting status of the atmcs.

async check_tracking(track_duration: float | None = None) → None¶

Check tracking state.

This method monitors all the required parameters for tracking a target; from telescope and pointing component to the dome.

If any of those conditions fails, raise an exception.

This method is useful in case an operation required tracking to be active and be interrupted in case tracking stops. One can start this method concurrently and monitor it for any exception. If an exception is raise, the concurrent task can be interrupted or marked as failed as appropriately.

If a track_duration is specified, the method will return after the time has passed. Otherwise it will just check forever.

Parameters:

track_durationfloat or None: How long should tracking be checked for (second)? Must be a positive float or None (default).

clear_catalog() → None¶: Clear internal catalog.

async close() → None¶

async close_dome(force: bool = True) → None¶

Task to close ATDome.

Parameters:

forcebool: Close the dome shutter even if the method is unable to determine the state of m1 cover and/or the mirror is open.

async close_dropout_door() → None¶: Close ATDome dropout door

async close_m1_cover() → None¶: Task to close m1 cover.

Warning

The Mirror cover can only be closed if the telescope is pointing above self.tel_el_operate_pneumatics (=70 degrees). The method will check if the telescope is in an operational range and, if not, will move the telescope to an operational elevation, maintaining the same azimuth before closing the mirror cover. The telescope will be left in that same position in the end.

async close_m1_vent() → None¶: Task to open m1 vents.

components_to_check() → List[str]¶

Return components for which check is enabled.

Returns:

list of str: Components to check.

async disable_ataos_corrections(ignore_fail: bool = True) → None¶: Disable ATAOS corrections.

disable_checks_for_components(components: List[str]) → None¶

Disables checks for a list of components.

The elements of components that are not part of the CSC group will be ignored.

Parameters:

components: `list` of `str`: A list of strings that indentifies the components to disable the check. The names can be eather in attribute format (e.g. “mtmount” or “hexapod_1”) or in salobj remote name format (e.g. “MTMount” or “Hexapod:1”).

async disable_dome_following(check: Any = None) → None¶: Disable dome following mode.

async enable(overrides: Dict[str, str] | None = None) → None¶

Enable all components.

This method will enable all group components. Users can provide overrides for the start command (in a dictionary).

Parameters:

overrides: `dict`: Dictionary with overrides to apply. If None use recommended overrides.

async enable_ataos_corrections() → None¶: Enable ATAOS corrections.

async enable_dome_following(check: Any = None) → None¶: Enabled dome following mode.

enable_monitor() → None¶: Enable monitor.

async expand_overrides(overrides: Dict[str, str] | None = None) → Dict[str, str]¶

Expand an overrides dict with entries for every component.

Any components that have no specified override are set to “”.

Parameters:

overridesdict or None: A dictionary with (component name, overrides) pair or None. The component name is as it appears in the components_attr attribute, which is the name of the CSC in lowercase, replacing “:” by “_” for indexed components, e.g. “Hexapod:1” -> “hexapod_1” or “ATHexapod” -> “athexapod”.

Returns:

complete_overridesdict: Dictionary with overrides for every component in the group. Unspecifies components have override “”.

Raises:

RuntimeError: If an item in the parameter overrides dictionary is not a CSC in the group.

async find_target(az: float, el: float, mag_limit: float, mag_range: float = 2.0, radius: float = 0.5) → Table¶

Make a cone search and return a target close to the specified position.

Parameters:

az: `float`: Azimuth (in degrees).
el: `float`: Elevation (in degrees).
mag_limit: `float`: Minimum (brightest) V-magnitude limit.
mag_range: `float`, optional: Magnitude range. The maximum/faintest limit is defined as mag_limit+mag_range (default=2).
radius: `float`, optional: Radius of the cone search (default=2 degrees).

Returns:

targetastropy.Table: Target information.

async find_target_dm_butler(az: float, el: float, mag_limit: float, mag_range: float = 2.0, radius: float = 0.5) → str¶

Make a cone search in the butler source catalog and return a target in the magnitude range, close to the specified position.

Parameters:

az: `float`: Azimuth (in degrees).
el: `float`: Elevation (in degrees).
mag_limit: `float`: Minimum (brightest) V-magnitude limit.
mag_range: `float`, optional: Magnitude range. The maximum/faintest limit is defined as mag_limit+mag_range (default=2).
radius: `float`, optional: Radius of the cone search (default=2 degrees).

Returns:

str: Name of the target.

Raises:

RuntimeError:: If DM stack is not available.

async find_target_local_catalog(az: float, el: float, mag_limit: float, mag_range: float = 2.0, radius: float = 0.5) → str¶

Make a cone search in the internal catalog and return a target in the magnitude range, close to the specified position.

Parameters:

az: `float`: Azimuth (in degrees).
el: `float`: Elevation (in degrees).
mag_limit: `float`: Minimum (brightest) V-magnitude limit.
mag_range: `float`, optional: Magnitude range. The maximum/faintest limit is defined as mag_limit+mag_range (default=2).
radius: `float`, optional: Radius of the cone search (default=2 degrees).

Returns:

str: Name of the target.

Raises:

RuntimeError:: If catalog is not loaded. If no object is found.

async find_target_simbad(az: float, el: float, mag_limit: float, mag_range: float = 2.0, radius: float = 0.5) → str¶

Make a cone search in the HD catalog using Simbad and return a target with magnitude inside the magnitude range, close to the specified position.

Parameters:

az: `float`: Azimuth (in degrees).
el: `float`: Elevation (in degrees).
mag_limit: `float`: Minimum (brightest) V-magnitude limit.
mag_range: `float`, optional: Magnitude range. The maximum/faintest limit is defined as mag_limit+mag_range (default=2).
radius: `float`, optional: Radius of the cone search (default=2 degrees).

Returns:

str: Name of the target.

Raises:

RuntimeError:: If no object is found.

flush_offset_events() → None¶

Implement abstract method to flush events before an offset is performed.

See also

offset_done: Wait for events that mark an offset as completed.
offset_azel: Offset in local AzEl coordinates.
offset_xy: Offset in terms of boresight.
offset_radec: Offset in sky coordinates.

async focus_offset(offset: float) → None¶

Apply focus offset.

Returns after offset is aplied.

Parameters:

offsetfloat: Offset in mm.

async get_bore_sight_angle() → float¶

Get the instrument bore sight angle with respect to the telescope axis.

This method also determines the parity of the x-axis based on the currently selected focus.

Returns:

anglefloat: Bore sight angle.

async get_heartbeat(component: str) → BaseMsgType¶

Get last heartbeat for component.

Parameters:

componentstr: Name of the component.

Returns:

heartbeat: Last component heartbeat.

get_identity() → str¶

Get user identity.

Returns:

str: Identity.

get_required_resources(component: str, intended_usage: None | int) → Any¶

Return the required resources based on the intended usage of the class.

When subclassing, overwrite this method to add the child class use cases.

Parameters:

component: `str`: Name of the component, with index as it appears in components_attr attribute (e.g. test_1 for the Test component with index 1).
intended_usage: `int` or `None`: An integer constructed from the self.valid_use_cases. Usages can be combined to enable combined operations (see base class documentation). If None, returns appropriate values to load all resources.

Returns:

resources: types.SimpleNamespace

A simple namespaces with the following attributes:

add_this: bool: Should this remote be added to the collection?
readonly: bool: Create the remote for this component in readonly mode? Some operations does not require commanding.
include: list [str]: What topics should be included?

Raises:

KeyError: If component is not in the list of components.

get_rot_angle_alternatives(rot_angle: float) → Generator[float, None, None]¶

Generate rotator angle alternatives based on the input rotator angle.

Parameters:

rot_anglefloat: Desired rotator angle (in deg).

Yields:

float: Rotator angle alternatives (in deg).

async get_selected_nasmyth_angle() → float¶

Get selected nasmyth angle.

Check which nasmyth port is selected and return its current position. If it cannot determine the current nasmyth, issue a warning and uses port 2, if self.parity_x == -1, or port 1, otherwise.

Returns:

nasmyth_anglefloat: Calculated angle of the current selected nasmyth port.

Raises:

RuntimeError:: If cannot get mount_Nasmyth_Encoders.

async get_simulation_mode(components: List[str] | None = None) → Dict[str, BaseMsgType]¶

Return a list with the simulation mode for components in the group.

Parameters:

componentslist of str, optional: List with the name of components to get the simulation mode. If None (default) return the values for all components.

Returns:

simulation_mode: dict: Dictionary with the name of the component and the value of simulation mode.

async get_software_versions(components: List[str] | None = None) → Dict[str, BaseMsgType]¶

Return a list with the software versions for components in the group.

Parameters:

componentslist of str, optional: List with the name of components to get the software versions. If None (default) return the values for all components.

Returns:

software_versions: dict: Dictionary with the name of the component and the value of software versions.

async get_state(component: str, ignore_timeout: bool = False) → State¶

Get summary state for component.

Parameters:

componentstr: Name of the component.
ignore_timeoutbool: If True will return None in case it times out getting the state. Default is False, which means raise TimeoutError.

Returns:

statesalobj.State or None: Current state of component.

Raises:

asyncio.TimeoutError: If can not get state in self.fast_timeout seconds.

get_sun_azel(time_tai: float | None = None) → tuple[float, float]¶

Get the sun azimuth and elevation.

Parameters:

time_taifloat or None, optional: TAI timestamp to get sun position. If None compute current tai.

Returns:

tuple`[`float, float]: Sun elevation and azimuth in degrees.

get_telescope_and_dome_vent_azimuth() → tuple[float, float]¶

Get the telescope and dome vent azimuth.

Returns:

tel_vent_azimuthfloat: Azimuth to vent the telescope (in deg).
dome_vent_azimuthfloat: Azimuth to vent the dome (in deg).

get_work_components(components: List[str] | None = None) → List[str]¶

Parse input into a list of valid components from the group.

Parameters:

componentslist of str or None: Input list of components to process or None. If None return a list with all components.

Returns:

work_componentslist of str: List of valid components.

Raises:

RuntimeError: If a component in the components input list is not part of the group.

async home_dome(force: bool = False) → None¶

Task to execute dome home command and wait for it to complete.

Parameters:

forcebool, optional: Force dome to be homed even if it is already homed (default=False).

async in_pneumatics_operational_range() → bool¶

Check if ATMCS is in operational range for pneumatics operation.

Returns:

elevation_in_range: bool: Returns True when telecsope elevation is in safe range for pneumatics operation.

is_catalog_loaded() → bool¶

Check if catalog is loaded.

Returns:

bool: True if catalog was loaded, False otherwise.

async is_dome_homed() → bool¶

Verify if the dome is homed.

Returns:

dome_homedbool: True if dome is homed, False otherwise.

is_monitor_enabled() → bool¶: Is monitor position flag enabled?

list_available_catalogs() → Set[str]¶

List of available catalogs to load.

Returns:

catalog_namesset: Set with the names of the available catalogs.

See also

load_catalog: Load a catalog from the available set.

load_catalog(catalog_name: str) → None¶

Load a catalog from the available set.

Parameters:

catalog_namestr: Name of the catalog to load. Must be a valid entry in the list of available catalogs.

Raises:

RuntimeError: If input catalog_name is not a valid entry in the list of available catalogs. If catalog was already loaded or not cleared before loading a new one.

See also

list_available_catalogs: List available catalogs to load.

async monitor_position(check: Any | None = None) → None¶

Monitor and log the position of the telescope and the dome.

Parameters:

checktypes.SimpleNamespace or None: Override self.check for defining which resources are used.

async mount_AzEl_Encoders_callback(data: BaseMsgType) → None¶: Callback function to update the telescope position telemetry topic.

async next_heartbeat(component: str) → BaseMsgType¶

Get next heartbeat for component.

Parameters:

componentstr: Name of the component.

Returns:

heartbeat: Last component heartbeat.

async next_state(component: str) → State¶

Get summary state for component.

Parameters:

componentstr: Name of the component.

Returns:

statesalobj.State: Current state of component.

async next_telescope_position(timeout: float | None = None) → BaseMsgType¶

Wait for next telescope position to become available and return data.

Parameters:

timeout: `float`: How long to wait for target to arrive (in seconds). Default is None, which means, wait for ever.

Returns:

data: ATMCS_tel_mount_AzEl_Encoders

Raises:

asyncio.TimeoutError: If no new data is seen in less then timeout seconds.

async next_telescope_target(timeout: float | None = None) → BaseMsgType¶

Wait for next telescope position to become available and return data.

Parameters:

timeout: `float`: How long to wait for target to arrive (in seconds). Default is None, which means, wait for ever.

Returns:

data: ATMCS_tel_mount_AzEl_Encoders

Raises:

asyncio.TimeoutError: If no new data is seen in less then timeout seconds.

object_list_add(name: str, radec: ICRS) → None¶

Add object to object list.

Parameters:

name: `str`: Name of the object.
object_table: `astropy.table.row.Row`: Table row with object information.

object_list_clear() → None¶: Remove all objects stored in the internal object list.

object_list_get(name: str) → ICRS¶

Get an object from the list or query Simbad and return it.

Parameters:

name: `str`: Name of the object.

Returns:

radec: ICRS: Table row with object information.

object_list_get_all() → Set[str]¶

Return list of objects in the object list.

Returns:

object_list_namesset: Set with the names of all targets in the object list.

object_list_remove(name: str) → None¶

Remove object from object list.

Parameters:

name: `str`: Object name.

Raises:

RuntimeError: If input object name not in the object list.

async offline() → None¶: Put all CSCs in offline.

async offset_aos_lut(z: float = 0.0, x: float = 0.0, y: float = 0.0, u: float = 0.0, v: float = 0.0, m1: float = 0.0, offset_telescope: bool = True) → None¶

Apply offsets to hexapod and optionally re-center telescope after hexapod offset.

Parameters:

zfloat, optional: Hexapod offset in z axis (mm)
xfloat, optional: Hexapod offset in x axis (mm)
yfloat, optional: Hexapod offset in y axis (mm)
ufloat, optional: Hexapod Rx offset (deg)
vfloat, optional: Hexapod Ry offset (deg)
m1float, optional: M1 pressure offset (Pa). Must be less than 0.
offset_telescopebool, optional: Offset the telescope after the hexpod offset to compensate for chage in pointing.

async offset_azel(az: float, el: float, relative: bool = True, persistent: bool | None = None, absorb: bool = False) → None¶

Offset telescope in azimuth and elevation.

For more information see the Notes section below or the package documentation in https://ts-observatory-control.lsst.io/.

Parameters:

azfloat: Offset in azimuth (arcsec).
elfloat: Offset in elevation (arcsec).
relativebool, optional: If True (default) offset is applied relative to the current position, if False offset replaces any existing offsets.
persistentbool or None, optional (deprecated): (Deprecated) Should the offset be absorbed and persisted between slews? Use of this parameter is deprecated. Use absorb instead.
absorbbool, optional: Should the offset be absorbed and persisted between slews? (default: False)

See also

offset_xy: Offsets in the detector X/Y plane.
offset_radec: Offset in sky coordinates.
reset_offsets: Reset offsets.

Notes

The persistent flag is deprecated. Use absorb instead.

There are a couple different ways users can modify how offsets are treated via the input flags relative and absorb.

These flags allows users to control the following behavior;

1 - If the offset is relative to the current position
(relative=True) or relative to the pointing origin (e.g. the initial slew position).

2 - If the offset will only apply only to the current target
(absorb=False) or if they will be absorbed by the pointing and persist after a new targets (absorb=True).

By default relative=True and absorb=False, which means offsets will be relative to the current position and will reset after a slew.

The default relative offsets will accumulate. For instance,

>>> await tcs.offset_azel(az=10, el=0)
>>> await tcs.offset_azel(az=0, el=10)

Will result in a 10 arcsec offset in both azimuth and elevation.

Non-relative offsets will overrides any previous non-relative offset. For instance, the pair of commands below:

>>> await tcs.offset_azel(az=10, el=0)
>>> await tcs.offset_azel(az=0, el=10)

Results in only 10 arcsec offset in elevation, e.g., is equivalent to just doing the second command;

>>> await tcs.offset_azel(az=0, el=10, relative=True)

This is because the non-relative offset requested by the second command will reset the offset done on the previous command.

It is important to keep in mind that these offsets can also be combined with one another. For instance, if you do;

>>> await tcs.offset_azel(az=10, el=0)
>>> await tcs.offset_azel(az=0, el=10)
>>> await tcs.offset_azel(az=0, el=10, relative=False)

You will get 10 arcsec offset in azimuth and 20 arcsec in elevation.

Nevertheless, if after doing the above you do;

>>> await tcs.offset_azel(az=0, el=0, relative=False)

It will result in a 10 arcsec offset in both azimuth and elevation, from the relative offsets done previously.

In all cases above, the offset will be overwritten if a new target is sent, e.g.;

>>> await tcs.offset_azel(az=10, el=0, relative=True)
>>> await tcs.offset_azel(az=0, el=10, relative=True)
>>> await tcs.offset_azel(az=0, el=10)
>>> await tcs.slew_object("HD 164461")  # reset all offsets above

Will result in a slew with no offsets.

If you want offsets to persist between slews use absorb=True.

The relative flag applies the same way to absored offsets.

The following sequence of commands;

>>> await tcs.offset_azel(az=10, el=0, relative=True, absorb=True)
>>> await tcs.offset_azel(az=0, el=10, relative=True, absorb=True)
>>> await tcs.offset_azel(az=0, el=10, relative=False, absorb=True)
>>> await tcs.slew_object("HD 164461")

Will result in a slew offset by 10 arcsec in azimuth and 20 arcsec in elevation.

async offset_done() → None¶

Wait for events specifying that an offset completed.

See also

flush_offset_events: Flush events before an offset.
offset_azel: Offset in local AzEl coordinates.
offset_xy: Offset in terms of boresight.
offset_radec: Offset in sky coordinates.

Notes

For ATMCS we expect the component to send allAxesInPosition.inPosition=False at the start of an offset and then allAxesInPosition.inPosition=True when it is done.

If the ATMCS fails to send these events in more than self.tel_settle_time seconds, waiting for the event will timeout and raise an asyncio.Timeout exception.

async offset_pa(angle: float, radius: float) → None¶

Offset the telescope based on a position angle and radius.

Parameters:

anglefloat: Offset position angle, clockwise from North (degrees).
radiusfloat: Radial offset relative to target position (arcsec).

async offset_radec(ra: float, dec: float) → None¶

Offset telescope in RA and Dec.

Perform arc-length offset in sky coordinates. The magnitude of the offset is sqrt(ra^2 + dec^2) and the angle is the usual atan2(dec, ra).

Parameters:

rafloat: Offset in ra (arcsec).
decfloat or str: Offset in dec (arcsec).

See also

offset_azel: Offset in local AzEl coordinates.
offset_xy: Offsets in the detector X/Y plane.

async offset_rot(rot: float) → None¶

Apply a rotation offset.

Parameters:

rotfloat: Rotator offset (deg).

async offset_xy(x: float, y: float, relative: bool = True, persistent: bool | None = None, absorb: bool = False) → None¶

Offsets in the detector X/Y plane.

Offset the telescope field-of-view in the x and y direction.

Parameters:

xfloat: Offset in camera x-axis (arcsec).
yfloat: Offset in camera y-axis (arcsec).
relativebool, optional: If True (default) offset is applied relative to the current position, if False offset replaces any existing offsets.
persistentbool or None, optional (deprecated): (Deprecated) Should the offset be absorbed and persisted between slews? Use of this parameter is deprecated. Use absorb instead.
absorbbool, optional: Should the offset be absorbed and persisted between slews? (default: False)

See also

offset_azel: Offset in local AzEl coordinates.
offset_radec: Offset in sky coordinates.
reset_offsets: Reset offsets.

Notes

The persistent flag is deprecated. Use absorb instead.

If the image is displayed with the x-axis in horizontal position, increasing from left to right, a positive x-offset will result in the field-of-view moving to the right, and therefore, the stellar positions will move to the left.

If the image is displayed with y-axis in vertical position, increasing from bottom to top, a positive y-offset will result in field-of-view moving up, and therefore, the stellar positions will move down.

See the Notes section in offset_azel help page for more information about the relative and persistent flags.

async open_dome_shutter() → None¶: Task to open dome shutter and return when it is done.

async open_dropout_door() → None¶: Open ATdome dropout door.

async open_m1_cover() → None¶: Task to open m1 cover.

Warning

The Mirror cover can only be opened if the telescope is pointing above self.tel_el_operate_pneumatics (=70 degrees). The method will check if the telescope is in an operational range and, if not, will move the telescope to an operational elevation, maintaining the same azimuth before opening the mirror cover. The telescope will be left in that same position in the end.

async open_m1_vent() → None¶: Task to open m1 vents.

async open_valve_instrument() → None¶: Open ATPneumatics instrument valve.

async open_valve_main() → None¶: Open ATPneumatics main valve.

async open_valves() → None¶: Open the air valve system on ATPneumatics.

Return parallactic angle for the given Ra/Dec coordinates.

Parameters:

rafloat, str or astropy.coordinates.Angle: Target RA, either as a float (hour), a sexagesimal string (HH:MM:SS.S or HH MM SS.S) coordinates or astropy.coordinates.Angle.
decfloat, str or astropy.coordinates.Angle: Target Dec, either as a float (deg), a sexagesimal string (DD:MM:SS.S or DD MM SS.S) coordinates or astropy.coordinates.Angle.
timeastropy.time.core.Time or None, optional: The time which the coordinate trasformation is intended for. If None (default) use current time.

Returns:

pa_angleastropy.coordinates.Angle: Parallactic angle.

async point_azel(az: float, el: float, rot_tel: float = 0.0, target_name: str = 'azel_target', wait_dome: bool = False, slew_timeout: float = 1200.0) → None¶

Slew the telescope to a fixed alt/az position.

Telescope will not track once it arrives in position.

Parameters:

azfloat, str or astropy.coordinates.Angle: Target Azimuth (degree). Accepts float (deg), sexagesimal string (DD:MM:SS.S or DD MM SS.S) coordinates or astropy.coordinates.Angle
elfloat or str: Target Elevation (degree). Accepts float (deg), sexagesimal string (DD:MM:SS.S or DD MM SS.S) coordinates or astropy.coordinates.Angle
rot_telfloat or str: Specify rotator angle in mount physical coordinates. Accepts float (deg), sexagesimal string (DD:MM:SS.S or DD MM SS.S) coordinates or astropy.coordinates.Angle
target_namestr: Name of the position.
wait_domebool: Wait for dome to be in sync with the telescope? If preparing to take a flat, for instance, the dome will never be in sync.
slew_timeoutfloat: Timeout for the slew command (second).

async prepare_for_flatfield(check: Any = None) → None¶

A high level method to position the telescope and dome for flat field operations.

The method will,

1 - disable ATDomeTrajectory 2 - close the dome shutter (if open) 3 - send telescope to flat field position 4 - send dome to flat field position 5 - re-enable ATDomeTrajectory

Parameters:

checktypes.SimpleNamespace or None: Override self.check for defining which resources are used.

async prepare_for_onsky(overrides: Dict[str, str] | None = None) → None¶

Prepare Auxiliary Telescope for on-sky operations.

This method will perform the start of the night procedure for the ATCS component. It will enable all components, open the dome slit, open the telescope covers and activate AOS open loop corrections.

Parameters:

overrides: `dict`: Dictionary with overrides to apply. If None use the recommended overrides.

async prepare_for_vent(partially_open_dome: bool = False) → None¶

Prepare Auxiliary Telescope for venting.

Parameters:

partially_open_dome: `bool`: Partially open the dome after positioning the telescope and dome?

async process_as_completed(tasks: List[Task]) → Any¶

Process tasks are they complete.

If the first task that finishes completes successfully, it will cancel all other tasks in the list, empty the input list and return the value of the task. If the task results in an exception, it will cancel all other tasks, empty the list and raise the exception.

Parameters:

taskslist`[`asyncio.Tasks]: List of asyncio tasks to process.

Returns:

ret_valobject: Return value from the first completed task.

Calculate Ra/Dec in ICRS coordinates from Az/El.

Parameters:

azfloat, str or astropy.coordinates.Angle: Target Azimuth (degree). Accepts float (deg), sexagesimal string (DD:MM:SS.S or DD MM SS.S) coordinates or astropy.coordinates.Angle
elfloat or str: Target Elevation (degree). Accepts float (deg), sexagesimal string (DD:MM:SS.S or DD MM SS.S) coordinates or astropy.coordinates.Angle
timeastropy.time.core.Time or None, optional: The time which the coordinate trasformation is intended for. If None (default) use current time.

Returns:

radec_icrsastropy.coordinates.ICRS: Astropy coordinates with azimuth and elevation.

ready_to_offset() → AsyncIterator[None]¶

A context manager to handle preparing the telescope for offset.

By default it does nothing.

async ready_to_take_data() → None¶: Wait for the telescope control system to be ready to take data.

reset_checks() → None¶: Reset all checks, enabling check for all components.

async reset_offsets(absorbed: bool = True, non_absorbed: bool = True) → None¶

Reset pointing offsets.

By default reset all pointing offsets. User can specify if they want to reset only the absorbed and non-absorbed offsets as well.

Parameters:

absorbedbool: Reset absorbed offset? Default True.
non_absorbedbool: Reset non-absorbed offset? Default True.

Raises:

RuntimeError:: If both absorbed and non_absorbed are False.

static rotation_matrix(angle: float) → Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | bool | int | float | complex | str | bytes | _NestedSequence[bool | int | float | complex | str | bytes]¶: Rotation matrix.

set_azel_slew_checks(wait_dome: bool) → Any¶

Handle azEl slew to wait or not for the dome.

Parameters:

wait_domebool: Should the slew wait for the dome?

Returns:

checktypes.SimpleNamespace: Reformated check namespace.

set_rem_loglevel(level: int) → None¶

Set remotes log level.

Useful to prevent the internal salobj warnings when read queues are filling up.

Parameters:

levelint: Log level.

set_rot_angle_alternatives(rot_angle_alternatives: List[float]) → None¶

Set the rotator angle alternatives.

It is not necessary to pass the 0. alternative, as it is added by default.

Duplicated entries are also removed.

Parameters:

rot_angle_alternativestyping.List[float]: List of rotator angle alternatives (in deg).

async set_state(state: State, overrides: Dict[str, str] | None = None, components: List[str] | None = None) → None¶

Set summary state for all components.

Parameters:

statesalobj.State: Desired state.
overridesdict or None: Settings to apply for each component.
componentslist[`str]`: List of components to set state, as they appear in self.components_attr.

Raises:

RuntimeError

If a component in components is not part of the group.
If it fails to transition one or more components.

async shutdown() → None¶

Shutdown ATTCS components.

This method will perform the end of the night procedure for the ATTCS component. It will close the telescope cover, close the dome, move the telescope and dome to the park position and disable all components.

async slew(ra: float, dec: float, rotPA: float = 0.0, target_name: str = 'slew_icrs', frame: IntEnum | None = None, epoch: float = 2000.0, equinox: float = 2000.0, parallax: float = 0.0, pmRA: float = 0.0, pmDec: float = 0.0, rv: float = 0.0, dRA: float = 0.0, dDec: float = 0.0, rot_frame: IntEnum | None = None, rot_track_frame: IntEnum | None = None, rot_mode: IntEnum | None = None, az_wrap_strategy: IntEnum | None = None, time_on_target: float = 0.0, slew_timeout: float = 1200.0, stop_before_slew: bool = False, wait_settle: bool = True, offset_x: float = 0.0, offset_y: float = 0.0) → None¶

Slew the telescope and start tracking an Ra/Dec target.

Parameters:

rafloat: Target Right Ascension (hour)
decfloat: Target Declination (degree)
rotPAfloat: Desired rotator position angle for slew (degree).
target_namestr: Name of the target
frameint: Target co-ordinate reference frame.
epochfloat: Target epoch in years e.g. 2000.0. Julian (J) epoch is assumed.
equinoxfloat: Target equinox in years e.g. 2000.0
parallaxfloat: Parallax (arcseconds).
pmRAfloat: Proper Motion (RA) in RA Seconds/year.
pmDecfloat: Proper motion (Dec) in Arcseconds/year.
rvfloat: Radial velocity (km/sec).
dRAfloat: Differential Track Rate in RA.
rot_frameenum: Rotator coordinate frame (self.RotFrame). Specify how to select the position of the rotator. If self.RotFrame.TARGET uses sky position angle. If self.RotFrame.FIXED uses rotator physical position.
rot_track_frameenum: Rotator track frame (self.RotFrame). Specify the rotator tracking mode. If self.RotFrame.TARGET, follow sky. If self.RotFrame.FIXED keep rotator at fixed position.
rot_modeenum: Rotator position mode (self.RotMode). If self.RotMode.FIELD optimize for sky tracking, if self.RotMode.SLIT optimize for slit spectroscopy.
slew_timeoutfloat: Timeout for the slew command (second).
stop_before_slewbool: Stop tracking before starting the slew? This option is a workaround to some issues with the mount components not sending events reliably.
wait_settlebool: Wait telescope to settle before returning?

async slew_dome_to(az: float, check: Any = None) → None¶

Utility method to slew dome to a specified position.

This method works at cross purposes to ATDomeTrajectory, so this method disables ATDomeTrajectory and leaves it disabled. If ATDomeTrajectory is enabled while the dome is slewing to the requested position this method raises an exception.

The method will return once the dome arrives in position, at which point all checks will be canceled before returning.

Parameters:

azfloat or str: Azimuth angle for the dome (in deg).
checktypes.SimpleNamespace or None: Override self.check for defining which resources are used.

Raises:

RuntimeError:: If ATDome is ENABLED while slewing the dome.

async slew_ephem_target(ephem_file: str, target_name: str, rot_sky: float = 0.0, validate_only: bool = False, slew_timeout: float = 240.0) → None¶

Slew the telescope to a target defined by ephemeris data defined in a file.

Parameters:

ephem_filestr: Name of the file containing ephemeris data.
target_namestr: Target name.
rot_skyfloat: Desired instrument position angle (degree), Eastwards from North. Default is 0.0.
validate_onlybool, optional: If True, validate the target without changing the current demand. Default is False.
slew_timeoutfloat, optional: Timeout for the slew command in seconds, default is 1200 seconds (20 minutes).

async slew_icrs(ra: float, dec: float, rot: float = 0.0, rot_type: RotType = RotType.SkyAuto, target_name: str = 'slew_icrs', dra: float = 0.0, ddec: float = 0.0, offset_x: float = 0.0, offset_y: float = 0.0, az_wrap_strategy: IntEnum | None = None, time_on_target: float = 0.0, slew_timeout: float = 240.0, stop_before_slew: bool = False, wait_settle: bool = True) → Tuple[ICRS, Angle]¶

Slew the telescope and start tracking an Ra/Dec target in ICRS coordinate frame.

Parameters:

rafloat, str or astropy.coordinates.Angle: Target RA, either as a float (hour), a sexagesimal string (HH:MM:SS.S or HH MM SS.S) coordinates or astropy.coordinates.Angle.
decfloat, str or astropy.coordinates.Angle: Target Dec, either as a float (deg), a sexagesimal string (DD:MM:SS.S or DD MM SS.S) coordinates or astropy.coordinates.Angle.
rotfloat, str or astropy.coordinates.Angle: Specify desired rotation angle. The value will have different meaning depending on the choince of rot_type parameter. Accepts float (deg), sexagesimal string (DD:MM:SS.S or DD MM SS.S) coordinates or astropy.coordinates.Angle
rot_typelsst.ts.observatory.control.utils.RotType: Rotation type. This parameter defines how rot_value is threated. Default is SkyAuto, the rotator is positioned with respect to the North axis and is automatically wrapped if outside the limit. See RotType for more options.
target_namestr: Target name.
slew_timeoutfloat: Timeout for the slew command (second). Default is 240s.

Returns:

radec_icrsastropy.coordinates.ICRS: Coordinates used in slew command.
rot_angleastropy.coordinates.Angle: Angle used in command for rotator.

Other Parameters:

drafloat, optional: Differential Track Rate in RA (second/second). Default is 0.
ddecfloat, optional: Differential Track Rate in Dec (arcsec/second). Default is 0.
offset_xfloat, optional: Apply offset to original slew position (in arcsec).
offset_yfloat, optional: Apply offset to original slew position (in arcsec).
az_wrap_strategyazWrapStrategy or None, optional: Azimuth wrap strategy. By default use maxTimeOnTarget=3, which attempts to maximize the time on target. Other options are; 1-noUnWrap, 2-optimize.
time_on_targetfloat, optional: Estimated time on target, in seconds. This is used by the optimize azimuth wrap algorithm to determine whether it needs to unwrap or not.
stop_before_slewbool: Stop tracking before starting the slew? This option is a workaround to some issues with the ATMCS not sending events reliably.
wait_settlebool: Wait telescope to settle before returning? It True add an additional sleep of self.tel_settle_time to the telescope positioning algorithm. Otherwise the algorithm will return as soon as it receives allAxesInPosition event from the ATMCS.

See also

slew_object: Slew to an object name.

async slew_object(name: str, rot: float = 0.0, rot_type: RotType = RotType.SkyAuto, dra: float = 0.0, ddec: float = 0.0, offset_x: float = 0.0, offset_y: float = 0.0, az_wrap_strategy: IntEnum | None = None, time_on_target: float = 0.0, slew_timeout: float = 240.0) → Tuple[ICRS, Angle]¶

Slew to an object name.

Use simbad to resolve the name and get coordinates.

Parameters:

namestr: Target name.
rotfloat, str or astropy.coordinates.Angle, optional: Specify desired rotation angle. Strategy depends on rot_type parameter. Accepts float (deg), sexagesimal string (DD:MM:SS.S or DD MM SS.S) coordinates or astropy.coordinates.Angle
rot_typelsst.ts.observatory.control.utils.RotType, optional: Rotation type. This parameter defines how rot_value is threated. Default is SkyAuto, the rotator is positioned with respect to the North axis and is automacally wrapped if outside the limit. See RotType for more options.
slew_timeoutfloat, optional: Timeout for the slew command (second). Default is 240 seconds.

Other Parameters:

drafloat, optional: Differential Track Rate in RA (second/second). Default is 0.
ddecfloat, optional: Differential Track Rate in Dec (arcsec/second). Default is 0.
offset_xfloat, optional: Apply offset to original slew position (in arcsec).
offset_yfloat, optional: Apply offset to original slew position (in arcsec).
az_wrap_strategyazWrapStrategy or None, optional: Azimuth wrap strategy. By default use maxTimeOnTarget=3, which attempts to maximize the time on target. Other options are; 1-noUnWrap, 2-optimize.
time_on_targetfloat, optional: Estimated time on target, in seconds. This is used by the optimize azimuth wrap algorithm to determine whether it needs to unwrap or not.

See also

slew_icrs: Slew to an ICRS coordinates.

async slew_to_planet(planet: IntEnum, rot_sky: float = 0.0, slew_timeout: float = 1200.0) → None¶

Slew and track a solar system body.

Parameters:

planetenum.IntEnum: Enumeration with planet name.
rot_skyfloat: Desired instrument position angle (degree), Eastwards from North.
slew_timeoutfloat, optional: Timeout for the slew command (second).

async slew_to_pneumatics_operational_range() → None¶

Slew the telescope to safe range for pneumatics operation.

This method will slew the telescope to a safe elevation to perform atpneumatics operations. It should be used in combination with the in_pneumatics_operational_range method. Telescope will be left in pneumatics position with tracking disabled.

async standby() → None¶: Put all CSCs in standby.

async start_tracking(slew_timeout: float = 1200.0) → None¶

Start tracking the current position of the telescope.

Method returns once telescope and dome are in sync.

async stop_all() → None¶: Stop telescope and dome.

async stop_dome() → None¶: Stop all dome motion.

stop_monitor() → None¶: Stop any monitor position.

async stop_tracking() → None¶: Task to stop telescope tracking.

async wait_for_atdome_inposition(timeout: float) → str¶

Wait until the telescope is cleared by the dome.

Instead of waiting until the dome finishes moving. This method will wait until the telescope is not vigneted by the dome. This is monitored in monitor_position and broadcasted as an asyncio.Event.

Parameters:

timeout: `float`: How long should it wait before timing out.

Returns:

status: str: String with final status.

Raises:

asyncio.TimeoutError: If does not get a status update in less then timeout seconds.

async wait_for_atdome_shutter_inposition() → str¶

Wait for the atdome shutter to be in position.

Returns:

status: str: String with final status.

Raises:

asyncio.TimeoutError: If does not get in position before self.open_dome_shutter_time

async wait_for_atmcs_inposition(timeout: float) → str¶

Wait for inPosition of atmcs to be ready.

Parameters:

timeout: `float`: How long should it wait before timing out.

Returns:

status: str: String with final status.

Raises:

asyncio.TimeoutError: If does not get a status update in less then timeout seconds.

async wait_for_inposition(timeout: float, wait_settle: bool, check: Any | None = None) → List[str]¶

Wait for both the ATMCS and ATDome to be in position.

Parameters:

timeout: `float`: How long should it wait before timing out.
cmd_ack: `CmdAck` or `None`: CmdAck from the command that started the slew process. This is an experimental feature to discard events that where sent before the slew starts.
wait_settle: `bool`: After slew completes, add an addional settle wait before returning.
checktypes.SimpleNamespace or None: Override self.check for defining which resources are used.

Returns:

status: list of str: String with final status.

Raises:

RuntimeError:: If tasks times out.

async wait_tracking_stopped() → None¶

Task to wait until tracking has stopped.

Notes

Concrete implementations should override this method. By default it is a no-op.

Navigation

ATCS¶