lsst.ts.ATDomeTrajectory¶

Overview¶

ATDomeTrajectory moves the Vera C. Rubin Auxiliary Telescope dome to follow the telescope. It does this by reading telescope position from the ATMCS CSC (or ATMCSSimulator CSC if simulating the ATMCS) and issuing commands to the ATDome CSC.

Unlike most observatory enclosures, we plan to slowly rotate the dome during exposures, in order to minimize the time required to move to the next target. ATDomeTrajectory supports multiple algorithms for determining how to move the dome, though at present only one simple algorithm is available.

User Guide¶

Start the ATDomeTrajectory CSC as follows:


span.prompt1:before {
content: "\$ ";
}
run_atdometrajectory.py


Stop the CSC by sending it to the OFFLINE state.

To make dome track the telescope send the ATDomeTrajectory CSC to the ENABLED state.

To stop the dome from tracking the telescope (e.g. if you want to send the dome to some specific position) send the ATDomeTrajectory CSC to the DISABLED state (or any state other than ENABLED).

ATDomeTrajectory supports multiple algorithms for moving the dome. The algorithm is specified in the configuration.

ATDomeTrajectory can be fully exercised without hardware by running the ATMCSSimulator CSC and running ATDome CSC in simulation mode. Thus ATDomeTrajectory does not need or have a simulation mode of its own.

Configuration¶

Configuration is defined by this schema. Configuration primarily consists of specifying the control algorithm and its associated parameters.

Available algorithms:

Configuration files live in ts_config_attcs/ATDomeTrajectory.

Here is a sample configuration file that specifies all fields:

# We strongly suggest that you specify the algorithm name
# if you override any of the algorithm's default configuration.
# That way your configuration file will continue to work
# even if the default algorithm changes.
algorithm_name: "simple"
algorithm_config:
# This value is abitrary and merely for illustration.
# It can be omitted, and the default is reasonable.
max_delta_azimuth: 3.5