Changelog

1.4.1 - February 21, 2025

✨ Improved

  • Ensure that the APOGEE cold shutter cannot be commanded at LCO.

  • Turn APOGEE LEDs on/off during morning calibrations.

🔧 Fixed

  • Consider a field RM if it begins with dark_monit or dark_rm (as opposed to requiring an exact match).

1.4.0 - January 22, 2025

✨ Improved

  • Add enabled_instruments option to the expose macro to allow for enabling/disabling instruments.

⚙️ Engineering

  • Use uv for project management and workflows.

1.3.5 - June 15, 2024

🔧 Fixed

  • #24 Allow the expose macro to run if goto-field is running but has already reached the acquire or guide stages.

1.3.4 - June 5, 2024

✨ Improved

  • Added a second, dithered FPI exposure in morning and evening APOGEE cals, both APO and LCO.

1.3.3 - June 1, 2024

✨ Improved

  • #23 When the auto-pilot is started an a goto-field is running, it will wait for it to finish.

  • Close the APOGEE shutter when an exposure is aborted.

1.3.2 - May 30th, 2024

🔧 Fixed

  • hal auto-pilot --add-hartmann was adding a stage hartmann to the goto-field instead of boss_hartmann.

1.3.1 - May 30th, 2024

✨ Improved

  • #3 Added --add-hartmann and --remove-hartmann flags to auto-pilot.

1.3.0 - May 29th, 2024

🚀 New

  • #20 New abort-exposures command will stop the expose macro, if running, and smoothly (hopfully) stop any ongoing APOGEE and BOSS exposures.

1.2.2 - May 28th, 2024

🔧 Fixed

  • Remove leftover break that would cause the auto-pilot to exist after one iteration.

1.2.1 - May 28th, 2024

🔧 Fixed

  • Fix an issue with the new auto-pilot loading a new design during an exposure when a fully loaded one was available.

  • Correctly set the observed configuration if the a new one has been loaded.

1.2.0 - May 26th, 2024

🚀 New

  • #19 Fully rewritten version of the auto-pilot. The behaviour is generally unchanged but this rewrite fixes several bugs and should allow the auto-pilot to be started and stopped at any point. The command has been changed to hal auto-pilot although hal auto is still being aliased.

✨ Improved

  • Fail expose and goto-field macros if another macro is running.

1.1.9 - April 26th, 2024

🔧 Fixed

  • goto-field acquire was setting the exposure time to 5 seconds for APO but not using the dynamic exposure time flag.

1.1.8 - April 18th, 2024

✨ Improved

  • #18 Implement dynamic exposure times during acquisition. cherno acquire (and potentially cherno guide) can be called with the --dynamic-exposure-time and --max-exposure-time flags. Initial exposure time during acquisition defaults to 5 seconds.

🏷️ Changed

  • Changed the number of max_iterations during acquisition to 5 (from 4) at APO and 7 (from 5) at LCO.

1.1.7 - April 17th, 2024

🔧 Fixed

  • Fix hal goto-field --guider-time flag which was previously ignored.

  • Potentially fixed and issue in which if the auto pilot mode is turned on while a configuration is being observed and the next configuration is a repeat field, it was treated as a new field and the additional goto-field stages were executed. The old logic required the configuration to be complete (i.e., at least one exposure done). The new logic just requires the goto-field to have been executed in the previous configuration.

1.1.6 - April 16th, 2024

🔧 Fixed

  • When using the auto macro, set the exposure time correctly based on the design mode.

1.1.5 - April 6th, 2024

🔧 Fixed

  • Prevent the list of stages in goto-field with --auto to be modified in place when adding the --with-hartmann option.

1.1.4 - April 5th, 2024

✨ Improved

  • Added --preload-ahead option to override how long ahead of time the next design is preloaded in auto mode.

1.1.3 - April 4th, 2024

🔧 Fixed

  • We don’t want 12-minute exposures for bright time designs at LCO yet. Fixed the code to accept different exposure times for bright designs depending on the observatory.

1.1.2 - April 4th, 2024

✨ Improved

  • Update auto_mode stages for LCO: removed boss_flat for new fields and only do reconfiguration and guide for repeat fields.

1.1.1 - April 3rd, 2024

✨ Improved

  • Pass --extra-epoch-delay when preloading a design.

1.1.0 - April 1st, 2024

🚀 New

  • #17 Use 730 second exposure times for bright designs.

1.0.3 - March 5, 2024

🏷️ Changed

  • Increase slew timeout to 300 seconds.

1.0.2 - February 27, 2024

✨ Improved

  • Retry lamps at LCO to deal with cases when TCS_FF fails.

  • Use /screen flag for LCO slews.

1.0.1 - January 15, 2024

✨ Improved

  • Reset cherno offsets when goto-field is called.

🏷️ Changed

  • LCO: added a 25 second delay before acquisition / guiding to give observers time to remove the FFS.

1.0.0 - December 22, 2023

✨ Improved

  • Added the option to define goto-field calibration slew offsets.

0.7.3 / 1.0.0b3 - December 20, 2023

🔧 Fixed

  • Update macro_id when Macro.reset() is called.

1.0.0b2 - December 17, 2023

🔧 Fixed

  • Add 3 second delay before running goto-field cleanup at LCO to prevent lamps being switched on/off too fast.

1.0.0b1 - December 15, 2023

🚀 New

  • [#16] Implement goto-field macro for LCO.

0.7.2 - December 11, 2023

✨ Improved

  • The overheads are now recorded with a macro_id that increases for each new macro run.

  • Added a test macro and command that just waits but is useful for simple testing.

0.7.1 - December 10, 2023

🔧 Fixed

  • Correctly mark whether a set of concurrent stages succeeded in the database overhead table.

0.7.0 - December 6, 2023

🔥 Breaking changes

  • Deprecated Python 3.9.

🚀 New

  • #14 Record overheads for each stage and macro in the database and output stage_duration keyword.

0.6.0 - December 4, 2023

🏷️ Changed

  • Set maximum number of iterations for acquisition in goto-field to 4.

  • If acquisition fails to reach the target RMS after acquisition_max_iterations but the RMS is lower than acquisition_min_rms, the macro emits a warning but does not fail.

🔧 Fixed

  • Fixed circular import preventing the import of the goto-field macro.

  • Fix getting target_rms in auto mode.

⚙️ Engineering

  • Lint using ruff.

  • Update workflows.

0.6.0b4 - January 15, 2023

✨ Improved

  • Emit running_scripts keyword when a command is running. Needed for Boson 0.3.1.

0.6.0b3 - January 15, 2023

🔧 Fixed

  • Only register MCP callback for gang connection when at APO.

0.6.0b2 - January 15, 2023

🚀 New

  • Added the ability to pause/resume the expose macro. Users can issue hal expose --pause that will finish the current exposure and then wait until hal expose --resume is issued. If the count is changed while paused, the adjusted ETR is output on resuming. The same behaviour can be achieved with hal auto --pause and hal auto --resume (note that this will NOT pause the goto-field macro).

🔧 Fixed

  • hal auto --modify --count X was not refreshing the ExposureHelper after updating the parameters.

  • Several issues deciding how to handle command modifiers when the macro is already running.

0.6.0b1 - January 10, 2023

🚀 New

  • COS-89 (#12 Added an auto-mode macro. When active, the auto macro will run the goto-field and expose macros continuously. A few minutes before the end of the expose macro completes, a new design is preloaded from the queue. The goto-field logic for selecting stages is similar to goto-field --auto. The auto macro can be cancelled with hal auto --stop which will complete the current stage and then quit, or hal auto --stop --now that immediately aborts (ongoing exposures are never aborted). The auto mode should be able to take over from any current state; for example if the auto mode is enabled during an expose macro, it will skip the goto-field stage, wait until expose is done, and then start the loop (note tha this case a new design will not be preloaded during the ongoing expose). The count of exposures to take can me modified with hal auto --modify --count X which behaves similarly to the hal expose --modify command. Requires cherno 0.5.0 or above.

  • COS-66 (#13 The parameters for an ongoing expose macro can be modified by issuing a new hal expose command with the --modify flag. Exposure information is handled by a new ExposureHelper class that calculates the exposures for each instrument and ensures readout time matching. The behaviour for the user should be mostly unchanged.

0.5.2 - January 5, 2023

  • Fix several typos in the lists of stages for goto-field --auto.

0.5.1 - January 4, 2023

🔧 Fixed

  • Do not stop the guide look in goto-field if we are not taking BOSS calibrations or halting the axes.

0.5.0 - January 2, 2023

🚀 New

  • Added a new goto-field stage, lamps, that runs concurrently with reslew and turn on BOSS calibrations lamps (if needed) at that point. This saves a few seconds if we are taking a single BOSS arc. The stage is not required, and the lamps will be turned on at the calibration stage if lamps is omitted.

✨ Improved

  • Several performance improvements to goto-field. FFS are only closed if we are taking BOSS calibrations; when turning off lamps, we don’t wait until they are really off, just send the command; the APOGEE shutter is closed at the beginning of the goto-field, but we don’t wait for it to fully close before moving to the reconfiguration.

  • After the BOSS FF stage, only the FF lamp is turned off.

🔧 Fixed

  • Fixed a case in which lamp status reporting could fail if the lamps were caught at an intermediate state in which only some of the lamps were on.

⚙️ Engineering

  • Macro exceptions are logged to the file log with full traceback.

0.4.0 - December 21, 2022

🚀 Added

  • COS-88 (#11): hal goto-field now accepts an --auto flag that selects the stages depending on the design loaded.

🏷️ Changed

  • If expose is called with --without-fpi, the FPI shutter is left where it is.

0.3.0 - September 11, 2022

🚀 Added

  • #9 Some changes for LCO. Splits the script into APO and LCO version.

🏷️ Changed

  • #8 Go to field turns on HgCd during prepare if arcs or Hartmanns are going to be taken, even if the fvc stage is selected. If fvc is not selected both HgCd and Ne are turned on. The telescope now slews to the field rotator angle.

0.2.0 - June 1, 2022

🚀 New

  • #2 HAL expose macro and actor command. Multiple subsequent commits fine-tuning its behaviour.

✨ Improved

  • COS-68 Better handling of lamps during go to field macro. Reduce warm up time for HgCd lamp to 108 seconds to account for BOSS flushing.

  • COS-71 Update evening/morning calibration scripts with dithered version.

  • #6 Update the goto-field macro to execute the FVC loop at a fixed rotator angle.

  • #7 Check FBI LED levels before exposing.

  • Improved FPI shutter handling.

  • Mote goto-field improvements:

    • Go to field: add a cherno stop during the prepare stage.

    • Do not reset cherno offset.

    • Re-slew and open FFS at the same time.

    • Slew timeout 160 -> 180s.

    • Run 5 iterations with full corrections in the acquire stage before moving to guiding using the PID coefficients.

🔧 Fixed

  • If a stage has been finished, do not cancel it.

0.1.0 - January 7, 2022

🚀 New

  • Basic infrastructure for scripts and macros.

  • #1 Command to run scripts.

  • Goto commands and TCC status.

  • goto-field macro.