Calibration frames
One run shoots a rig's calibration set - flats, bias and darks - with the observatory closed. It never opens the roof or the cover and never moves the mount, the focuser or the rotator: the camera, its cooler and the flat panel's light are all it drives. Use it on a cloudy night, before or after an imaging session, or from a plan or blockscript when the weather closes the roof.
It has its own Calibration page in the left nav (settings, Run / Cancel, a live progress log), a calibration action for plans and blockscripts, and an HTTP endpoint (POST /api/console/calibration).
What a run does
- Checks that the telescope is dark. A motorized cover must read closed; the run refuses to start otherwise and never moves the cover itself. A rig without one (no flat device, or a panel with no motor) must tick The telescope is capped.
- Cools the camera to the sensor target (default 5 °C) and waits for it with the
[cooling]settling rules (deviation_max_c,settle_dwell_s,timeout_settling_min). If the camera cannot get there - a warm night - the run shoots at the temperature it holds and says so in the log (proceed_if_not_settled; turn it off to stop instead). Every frame records the sensor temperature in its header and its file name.
- Some drivers report the cooler on from an earlier session while it draws no power. When the cooler shows 0 % and the sensor does not fall for a minute, the run switches it off and on again; if it still draws nothing it says so (check the camera's 12 V supply). - Once the camera has settled, the run checks the sensor before every frame. If it has wandered more than 1 °C off the target (a reconnect can put a camera back to its own default set-point), the frames are held, the cooler is set again and the run waits for it to settle - or stops, reporting what each set saved.
- Flats with the panel lit, per filter when a filter wheel is set up (none ticked = the filter in place; a colour camera files them under
osc/). The exposure is found the Auto Flat way: meter a frame, scale towards the flat target ADU, dim the panel when it is too bright. - Switches the panel off and checks that no light reaches the sensor: a 1 s frame against a bias. A panel that stays lit or a cover that leaks stops the run before any dark or bias is saved.
- Bias at the camera's shortest exposure.
- Darks, one set per exposure in Dark exposures (default 60 s and 120 s, ten each).
- Warms the camera up and switches the cooler off (
warm_up_at_end). The panel is always switched off at the end, whatever happened.
A cancelled run warms the camera up too (v23). When you cancel a run that cooled the camera, and warm_up_at_end is on, the warm-up still runs before the cooler is switched off. Before v23 a cancelled run left the cooler running at the set-point with nobody watching. The warm-up after a cancel cannot itself be cancelled; it ends after [cooling] warm_up_timeout_min at the latest.
Saturation follows the camera (v23). A flat counts as saturated at about 92 % of the camera's own maximum value (MaxADU) when the driver reports it, and the flat target is scaled to the same fraction of the well. For a 16-bit camera nothing changes: saturated is 60000 ADU. A camera that hands over unscaled 12-bit or 14-bit data (a maximum of 4095 or 16383) was never seen as saturated before, and could not reach a 25000 ADU target.
Gain
Bias and darks are shot at your lights' gain - the camera's current gain unless you type one. A capture sets the camera's gain and leaves it there, so the run names the gain on every frame and puts the camera back to the lights' gain at the end, even when it is cancelled.
A panel too bright for the camera
Most dimmable panels are PWM-dimmed: the light arrives in pulses, and a flat only a few pulses long is quantised in level and banded by a rolling shutter. When the panel at its dimmest still wants less than [flat] min_exposure_s (1 s) at the lights' gain, the run lowers the gain for the flats (lower_gain_for_flats): the highest gain its estimate allows, the camera's minimum if needed. A second bias set at the flats' gain is shot so the flats can be calibrated; it goes to a gain<N> subfolder next to the normal bias. At the camera's minimum gain the flats may go down to flat_floor_exposure_s (0.1 s) and the set is flagged "short flats"; anything shorter is not saved. The real cure for a panel that bright is a sheet of paper or ND film over it.
Stacking software groups calibration frames by the GAIN header when told to: with flats at a lower gain, give the flats their own bias (the gain<N> folder) and the lights theirs.
Where the frames go
The frames are written with IMAGETYP = FLAT, BIAS or DARK and named flat-gain<N>-..., bias-gain<N>_<T>C-... and dark-gain<N>_<T>C-<exposure>s-.... In the By target, filter and night layout (see the FITS topic) they land in calibration/flats/<night>/<filter|osc>/, calibration/bias/<night>/ (the flats' bias in .../gain<N>/) and calibration/darks/<night>/.
Settings - [calibration]
The page starts from these; Save as defaults writes the form back. The flat metering knobs (min / max exposure, initial exposure, panel brightness, tolerance) are the Auto Flat ones in [flat].
| Key | Default | Meaning | |---|---|---| | cool | true | cool the camera first | | target_temp_c | 5.0 | sensor target | | proceed_if_not_settled | true | cannot reach it: shoot at the temperature it holds | | flats_count | 10 | flats per filter (0 = none) | | flat_target_adu | 25000 | mean level for flats | | flat_filters | [] | filters for flats; empty = the filter in place | | lower_gain_for_flats | true | lower the gain when the panel is too bright at its dimmest | | flat_floor_exposure_s | 0.1 | shortest flat ever saved (at the camera's minimum gain) | | bias_count | 20 | bias frames (0 = none) | | darks_count | 10 | darks per exposure (0 = none) | | dark_exposures_s | [60.0, 120.0] | dark exposures in seconds | | warm_up_at_end | true | warm up + cooler off when the run finishes |
In a plan or a blockscript
The Calibration frames phase action (plan editor, any phase) and the calibration blockscript action take the same parameters - flats_count, bias_count, darks_count, dark_exposures_s (a list or "60,120"), target_temp_c, cool, flat_target_adu, warm_up_at_end - and fall back to [calibration] for the rest. In a plan the camera stays cold unless warm_up_at_end is set (a plan's own on_end has Warm camera). Stop cancels the run.
The blockscript action waits for the run and refuses while a sequence is running, since both would use the camera: put it where the body has ended. The dashboard's Run button refuses during a sequence too.
Caveats
- The flats share Auto Flat's metering, which was tuned on one panel (rig 1's Wanderer); the gain-lowering path is new in v22.2.13.
- Bias uses the camera's
ExposureMin(1 ms when the driver does not say). - Dark flats are not shot: the flats are calibrated with bias (at the flats' gain when it differs).