LATISS Daily Calibrations BIAS, DARK and FLAT: all filters + empty#
Overview#
This procedure will enable and turn on the ATWhiteLight that illuminates the dome flat screen. It will position the telescope and dome in the FLAT position, and will take BIAS, DARK, and FLATS calibrations images in all installed filters including the empty filter. Finally will turn off the white light and send the ATWhiteLight to STANDBY
. After the entire script completion, the telescope and dome will remain in ENABLED
state and in the FLAT field position. The observer can decide whether to vent, proceed to on-sky or shutdown.
This page assumes the reader is familiar with the content explained in the Observatory section: Introduction to the combined calibrations generation procedure
Warning
This procedure involves telescope motion with AuxTel. Be sure to confirm the dome is clear of personnel and announce that you are going to run the calibrations with telescope movement on the #summit-announce and #summit-auxtel channels before you run the following steps. The whole process takes about 1.5 hours.
Post-Condition#
Individual calibration images will be taken and verified using the cp_verify framework.
If
generate_calibrations
isTrue
, a (daily) combined calibration image per detector will be certified in a butlerCALIBRATION
collection.
Procedure Steps#
Enable ATCS and LATISS using the standard scripts
enable_atcs.py
andenable_latiss.py
with no configuration.Enable
Scheduler:2
with a valid scheduler configuration. Use the standard scriptauxtel/scheduler/enable.py
with the configuration specified in the AuxTel Scheduler-Driven Survey Test Case (BLOCK-T19).Setup LATISS calibrations BLOCK will setup ATCS and white light for calibrations. It enables and turns on the ATWhiteLight, enables OCPS:1 and commands AuxTel mount and dome to the FLAT position. Run the script
add_block.py
to the ATQueue with the following configuration:id: BLOCK-309
The BLOCK with
setup_latiss_calibrations
configuration will queue the scripts aimed to setup the system. It will start with theset_summary_state.py
script to enable ATWhiteLight CSC with the following configuration:data: - - ATWhiteLight - ENABLED
The
set_summary_state.py
script will enableOCPS:1
CSC.data: - - OCPS:1 - ENABLED
The SAL script
auxtel/calibrations/power_on_atcalsys.py
with no configuration inserted into the BLOCKsetup_latiss_calibrations
structure will start the chiller, turn on the white light and open the shutter. This script takes 15 minutes to complete, the time it takes to warm up the white light. On Chronograf using the querylsst.sal.ATWhiteLight.logevent_logMessage.message
, the lamp reports its retry loop status explicitly.The
auxtel/prepare_for/flat.py
script (empty configuration) will position the telescope and dome in FLAT position. The telescope will point towards the dome flat screen (mount Az = 188.7 deg, mount El = 39.0 deg, dome Az= 2.59 deg). Confirm in the cameras “aux-cam01” or “aux-cam02” that the white light is on, and telescope is pointing to the dome flat screen.The LATISS daily calibrations BLOCK will queue the scripts focused on the calibration image acquisition. Run the script
add_block.py
to the ATQueue with the following configuration:id: BLOCK-295
Depending on which filters are currently installed in LATISS, the
auxtel/make_latiss_calibrations.py
script may take different calibration sets. The calibration images displayed in RubinTV are post-ISR images and should have BIAS and DARK corrections applied. This means that BIAS and DARK images should display with maximum count rates of about 10 ADUs. In the case of FLAT images, counts must be below the \(\approx\) 30000 ADUs. In the process of building the daily PTC (see below), the FLAT saturation is intended, and achieved at around the 123000 ADUs (with exposure time of about 25 seconds). In case daily FLATS are taken, they reach values of \(\approx\) 68000 ADUs. If you see large deviations from these values, which can be related with a problem in the instrument signature removal in RubinTV, then RAW count rates are being displayed, please report it. Check the calibration sets and their configurations for each filter installed and the grating.: Set configuration for SDSSr_65mm.
n_flat: 20 exp_times_flat: 6 script_mode: BIAS_DARK_FLAT filter: SDSSr_65mm grating: empty_1
: Set configuration for SDSSg_65mm.
n_bias: 3 n_dark: 3 exp_times_dark: 6 n_flat: 20 exp_times_flat: 6 script_mode: BIAS_DARK_FLAT filter: SDSSg_65mm grating: empty_1
: Set configuration for SDSSz_65mm.
n_bias: 3 n_dark: 3 exp_times_dark: 6 n_flat: 20 exp_times_flat: 3 script_mode: BIAS_DARK_FLAT filter: SDSSz_65mm grating: empty_1
: Set configuration for SDSSy_65mm.
n_bias: 3 n_dark: 3 exp_times_dark: 6 n_flat: 20 exp_times_flat: 30 script_mode: BIAS_DARK_FLAT filter: empty_1 grating: SDSSy_65mm
: Set configuration for empty_1.
n_bias: 3 n_dark: 3 exp_times_dark: 1 n_flat: 20 exp_times_flat: 1 script_mode: BIAS_DARK_FLAT filter: empty_1 grating: empty_1
: Set sequence for the daily Photon Transfer Curve (PTC). Skip it if the previous sets were queued manually.
image_type: FLAT filter: SDSSr_65mm grating: empty_1 reason: daily_PTC exp_times: 0.25, 0.25, 1.42, 1.42, 6.53, 6.53, 4.23, 4.23, 30.04, 30.04, 12.56, 12.56, 57.75, 57.75, 8.13, 8.13, 2.73, 2.73, 3.40, 3.40, 1.77, 1.77, 111.03, 111.03, 37.35, 37.35, 0.48, 0.48, 0.59, 0.59, 10.10, 10.10, 1.14, 1.14, 0.20, 0.20, 89.29, 89.29, 71.81, 71.81, 0.38, 0.38, 0.31, 0.31, 19.43, 19.43, 2.20, 2.20, 15.62, 15.62, 0.92, 0.92, 0.74, 0.74, 24.16, 24.16, 5.25, 5.25, 46.44, 46.44
: Set sequence for daily_flats.
image_type: FLAT filter: SDSSr_65mm grating: empty_1 reason: daily_sflat, exp_times: 0.5, 0.5, 0.5, 0.5, 0.5, 12.8, 12.8, 12.8, 12.8, 12.8
The Shutdown LATISS calibrations BLOCK will turn off the calibration lamp and leave it on standby state. Run the script
add_block.py
to the ATQueue with the following configuration:id: BLOCK-310
The BLOCK with
shutdown_latiss_calibrations
configuration finishes with theauxtel/calibrations/power_off_atcalsys.py
SAL script with no configuration. It will turn off the lamp, close the shutter and shutdown the chiller. At this stage, the script completion time is 15 minutes.Finally, the
set_summary_state.py
script sends ATWhiteLight back toSTANDBY
.data: - - ATWhiteLight - STANDBY
Once the last script is done, check the camera to make sure the white light is off. At this point, ATCS and LATISS are in ENABLED
state and the dome and telescope are in FLAT position.
Note
The location of the BLOCK source code can be checked and if the filters or exposures times have changed, create a ticket for yourself and edit this document accordingly.
Contingency#
In cases such as telescope and dome movement not allowed or not cleared, or not enough time available for calibrations, skip this procedure.
This procedure was last modified Nov 05, 2024.