Developer Guide

https://img.shields.io/badge/GitHub-ts_standardscripts-green.svg https://img.shields.io/badge/Jenkins-ts_standardscripts-green.svg https://img.shields.io/badge/Jira-ts_standardscripts-green.svg

Contributing

lsst.ts.standardscripts is developed at https://github.com/lsst-ts/ts_standardscripts. You can find Jira issues for this package using project=DM and labels=ts_standardscripts.

Python API reference

lsst.ts.standardscripts Package

Functions

format_as_list(value, recurrences)

Reformat single instance of the attribute value as a list with a specified number of recurrences .

format_grid(axis1, axis2)

Format two input values into lists with the same lengths.

get_s3_bucket()

Generate an s3 bucket object.

get_scripts_dir()

Get the absolute path to the scripts directory.

get_topic_time_utc(topic)

Reformat a topic command time from TAI unix to UTC.

Classes

BaseBlockScript(index, descr[, help])

Extend BaseScript to add support for executing blocks.

BasePointAzEl(index, descr)

A base Script that implements pointing the telescope to a fixed Az/El/Rot position.

BaseScriptTestCase()

Base class for Script tests.

MuteAlarms(index)

Mute Watcher alarm(s) for a given amount of time.

PauseQueue(index)

A script to pause the script queue.

RunCommand(index)

Run a command from a CSC and, optionally, wait for an event once the command finishes.

SetSummaryState(index)

Set the summary state for one or more CSCs.

Sleep(index)

Sleep for a given amount of time.

SystemWideShutdown(index)

Discover all running CSCs and send them all to OFFLINE state.

Class Inheritance Diagram

Inheritance diagram of lsst.ts.standardscripts.base_block_script.BaseBlockScript, lsst.ts.standardscripts.base_point_azel.BasePointAzEl, lsst.ts.standardscripts.base_script_test_case.BaseScriptTestCase, lsst.ts.standardscripts.mute_alarms.MuteAlarms, lsst.ts.standardscripts.pause_queue.PauseQueue, lsst.ts.standardscripts.run_command.RunCommand, lsst.ts.standardscripts.set_summary_state.SetSummaryState, lsst.ts.standardscripts.sleep.Sleep, lsst.ts.standardscripts.system_wide_shutdown.SystemWideShutdown

lsst.ts.standardscripts.auxtel Package

Classes

CalSysTakeData(index)

DisableATAOSCorrections(index)

Disable ATAOS corrections as a stand alone operation.

EnableATAOSCorrections(index)

Enable ATAOS corrections as a stand alone operation.

EnableATTCS(index)

Enable all ATCS components.

EnableLATISS(index)

Enable all LATISS components.

FocusSweepLatiss(index[, descr])

Perform a focus sweep by taking images at different focus positions with LATISS.

LatissTakeSequence(index[, add_remotes])

Perform a sequence of exposures for a given set of instrument configurations.

OfflineATCS(index)

Put ATCS components in offline.

OfflineLATISS(index)

Put LATISS components in offline.

OffsetATAOS(index[, add_remotes])

Perform an ATAOS offset.

OffsetATCS(index[, add_remotes])

Perform an ATCS offset.

PointAzEl(index)

Auxiliary Telescope point_azel script.

PrepareForFlat(index)

Run prepare for flat on ATCS.

PrepareForOnSky(index)

Run ATTCS startup.

Shutdown(index)

Run ATTCS shutdown.

StandbyATCS(index)

Put ATCS components in standby.

StandbyLATISS(index)

Put LATISS components in standby.

Stop(index)

Stop telescope and dome.

StopTracking(index)

Stop telescope and dome tracking.

TakeImageLatiss(index)

Take a series of images with the ATCamera with set exposure times.

TakeStutteredLatiss(index)

Take a series of stuttered images with LATISS.

TrackTarget(index)

Execute a Slew/Track operation with the Auxiliary Telescope.

TrackTargetAndTakeImage(index[, add_remotes])

Track target and take image script.

Class Inheritance Diagram

Inheritance diagram of lsst.ts.standardscripts.auxtel.calsys_takedata.CalSysTakeData, lsst.ts.standardscripts.auxtel.disable_ataos_corrections.DisableATAOSCorrections, lsst.ts.standardscripts.auxtel.enable_ataos_corrections.EnableATAOSCorrections, lsst.ts.standardscripts.auxtel.enable_atcs.EnableATTCS, lsst.ts.standardscripts.auxtel.enable_latiss.EnableLATISS, lsst.ts.standardscripts.auxtel.focus_sweep_latiss.FocusSweepLatiss, lsst.ts.standardscripts.auxtel.latiss_take_sequence.LatissTakeSequence, lsst.ts.standardscripts.auxtel.offline_atcs.OfflineATCS, lsst.ts.standardscripts.auxtel.offline_latiss.OfflineLATISS, lsst.ts.standardscripts.auxtel.offset_ataos.OffsetATAOS, lsst.ts.standardscripts.auxtel.offset_atcs.OffsetATCS, lsst.ts.standardscripts.auxtel.point_azel.PointAzEl, lsst.ts.standardscripts.auxtel.prepare_for.flats.PrepareForFlat, lsst.ts.standardscripts.auxtel.prepare_for.onsky.PrepareForOnSky, lsst.ts.standardscripts.auxtel.shutdown.Shutdown, lsst.ts.standardscripts.auxtel.standby_atcs.StandbyATCS, lsst.ts.standardscripts.auxtel.standby_latiss.StandbyLATISS, lsst.ts.standardscripts.auxtel.stop.Stop, lsst.ts.standardscripts.auxtel.stop_tracking.StopTracking, lsst.ts.standardscripts.auxtel.take_image_latiss.TakeImageLatiss, lsst.ts.standardscripts.auxtel.take_stuttered_latiss.TakeStutteredLatiss, lsst.ts.standardscripts.auxtel.track_target.TrackTarget, lsst.ts.standardscripts.auxtel.track_target_and_take_image.TrackTargetAndTakeImage

lsst.ts.standardscripts.maintel Package

Classes

ApplyDOF(index)

Apply a DOF to the main telescope, either bending mode or hexapod offset.

BaseBlockScript(index, descr[, help])

Extend BaseScript to add support for executing blocks.

BaseCloseLoop([index, descr])

Closed loop script.

CameraSetup(camera, config, identifier[, ...])

Encapsulates camera object, its configuration, and a unique identifier.

CloseLoopComCam(index[, descr])

Run Closed Loop with ComCam.

CloseLoopLSSTCam(index[, descr])

Run closed loop with LSSTCam.

CloseMirrorCovers(index)

Run open mirror covers on MTCS.

DisableHexapodCompensationMode(index)

Disable compensation mode for M2 and/or Camera Hexapods.

EnableComCam(index)

Enable all ComCam components.

EnableHexapodCompensationMode(index)

Enable compensation mode for M2 and/or Camera Hexapods.

EnableMTCS(index)

Enable all MTCS components.

FocusSweepComCam(index[, descr])

Perform a focus sweep by taking images at different focus positions with ComCam.

FocusSweepLSSTCam(index[, descr])

Perform a focus sweep by taking images at different focus positions with LSSTCam.

HomeBothAxes(index[, add_remotes])

Home azimuth and elevation axes of the MTMount.

MTCS([domain, log, intended_usage])

High level library for the Main Telescope Control System

Mode(value[, names, module, qualname, type, ...])

MoveP2P(index)

Move Telescope using point to point trajectory instead of traditional slew/tracking.

OfflineComCam(index)

Put ComCam components in offline.

OfflineMTCS(index)

Put MTCS components in offline.

OffsetCameraHexapod(index[, add_remotes])

Perform a camera hexapod offset or reset operation.

OffsetM2Hexapod(index[, add_remotes])

Perform a m2 hexapod offset or reset operation..

OffsetMTCS(index[, add_remotes])

Perform an MTCS offset.

OpenMirrorCovers(index)

Run open mirror covers on MTCS.

PointAzEl(index)

Main Telescope point_azel script.

ScriptState(value[, names, module, ...])

ScriptState constants.

SetDOF(index)

Set absolute positions DOF to the main telescope, either bending mode or hexapod position.

SetupMTCS([index, remotes])

Setup MTCS components so they are ready for operation.

StandbyComCam(index)

Put ComCam components in standby.

StandbyMTCS(index)

Put MTCS components in standby.

Stop(index)

Stop telescope and dome.

StopRotator(index)

A script that executes stop_rotator method for MTCS

TakeAOSSequenceComCam(index[, descr])

Take aos sequence, either triplet (intra-focal, extra-focal and in-focus images), intra doublets (intra and in-focus) or extra doublets (extra and in-focus) sequences with ComCam.

TakeImageAnyCam(index)

A script for taking images concurrently with ComCam, LSSTCam, and/or one or more Generic Cameras.

TakeImageComCam(index)

Take images with ComCam.

TakeImageLSSTCam(index)

Take images with LSSTCam.

TakeStutteredComCam(index)

Take a series of stuttered images with ComCam.

TakeStutteredLSSTCam(index)

Take a series of stuttered images with LSSTCam.

TrackTarget(index)

Execute a Slew/Track operation with the Main Telescope.

TrackTargetAndTakeImageComCam(index[, ...])

Track target and take image script.

TrackTargetAndTakeImageGenCam(index[, ...])

Track target and take image script with one more Generic Cameras.

Class Inheritance Diagram

Inheritance diagram of lsst.ts.standardscripts.maintel.apply_dof.ApplyDOF, lsst.ts.standardscripts.maintel.base_close_loop.BaseCloseLoop, lsst.ts.standardscripts.maintel.take_image_anycam.CameraSetup, lsst.ts.standardscripts.maintel.close_loop_comcam.CloseLoopComCam, lsst.ts.standardscripts.maintel.close_loop_lsstcam.CloseLoopLSSTCam, lsst.ts.standardscripts.maintel.close_mirror_covers.CloseMirrorCovers, lsst.ts.standardscripts.maintel.disable_hexapod_compensation_mode.DisableHexapodCompensationMode, lsst.ts.standardscripts.maintel.enable_comcam.EnableComCam, lsst.ts.standardscripts.maintel.enable_hexapod_compensation_mode.EnableHexapodCompensationMode, lsst.ts.standardscripts.maintel.enable_mtcs.EnableMTCS, lsst.ts.standardscripts.maintel.focus_sweep_comcam.FocusSweepComCam, lsst.ts.standardscripts.maintel.focus_sweep_lsstcam.FocusSweepLSSTCam, lsst.ts.standardscripts.maintel.home_both_axes.HomeBothAxes, lsst.ts.standardscripts.maintel.take_aos_sequence_comcam.Mode, lsst.ts.standardscripts.maintel.move_p2p.MoveP2P, lsst.ts.standardscripts.maintel.offline_comcam.OfflineComCam, lsst.ts.standardscripts.maintel.offline_mtcs.OfflineMTCS, lsst.ts.standardscripts.maintel.offset_camera_hexapod.OffsetCameraHexapod, lsst.ts.standardscripts.maintel.offset_m2_hexapod.OffsetM2Hexapod, lsst.ts.standardscripts.maintel.offset_mtcs.OffsetMTCS, lsst.ts.standardscripts.maintel.open_mirror_covers.OpenMirrorCovers, lsst.ts.standardscripts.maintel.point_azel.PointAzEl, lsst.ts.standardscripts.maintel.set_dof.SetDOF, lsst.ts.standardscripts.maintel.setup_mtcs.SetupMTCS, lsst.ts.standardscripts.maintel.standby_comcam.StandbyComCam, lsst.ts.standardscripts.maintel.standby_mtcs.StandbyMTCS, lsst.ts.standardscripts.maintel.stop.Stop, lsst.ts.standardscripts.maintel.stop_rotator.StopRotator, lsst.ts.standardscripts.maintel.take_aos_sequence_comcam.TakeAOSSequenceComCam, lsst.ts.standardscripts.maintel.take_image_anycam.TakeImageAnyCam, lsst.ts.standardscripts.maintel.take_image_comcam.TakeImageComCam, lsst.ts.standardscripts.maintel.take_image_lsstcam.TakeImageLSSTCam, lsst.ts.standardscripts.maintel.take_stuttered_comcam.TakeStutteredComCam, lsst.ts.standardscripts.maintel.take_stuttered_lsstcam.TakeStutteredLSSTCam, lsst.ts.standardscripts.maintel.track_target.TrackTarget, lsst.ts.standardscripts.maintel.track_target_and_take_image_comcam.TrackTargetAndTakeImageComCam, lsst.ts.standardscripts.maintel.track_target_and_take_image_gencam.TrackTargetAndTakeImageGenCam