- Dropped support for Python 3.9.
- #50 Added
last_exposure_no
to the output of thestatus
command.
- Lint and format using
ruff
. - Updated Numpy to 2.0.
- #49 Improve the
abort
command. When an integration or readout is ongoing, the current task is stored in the delegate and cancelled if an abort happens. This should immediately cancel the command and any controller action. To perform a full abort, one should also run thereset
command, which will reset the controller, including a reset timings, or callabort --reset
.
- Do not raise warnings when trying to set some inexistent Archon parameters.
- yao #17: Deal with case when the returned buffer does not match the expected size. The
ArchonController.fetch
method will retry fetching buffer once. If that fails again it pads the buffer with zeros to match the expected size.
- Removed print statement that was left for debugging.
- Remove original extension in recovery file.
- The parameter used to set the exposure time can be defined using the configuration parameter
archon.int_param
. Valid values areIntMS
(integration time must be set in milliseconds) andIntCS
(centiseconds).
- As part of #46
ExposureDelegate.post_process()
is now called once for each controller CCD with aFetchDataDict
as the only argument. The function must modify the input dictionary in place and returnNone
.
- #47 Added a framework for recovering images when they fail to be written to disk. A lockfile is created when the buffer is read which can be used to recover the original image and header. Recovery happens automatically when the actor starts or via the
recover
command.
- #46 Significant clean-up of the
ExposureDelegate
code.
- Support for Python 3.8 has been deprecated.
- #45 Added a new option
files.write_engine
that can be set toastropy
orfitsio
. In the latter case it will use fitsio to write images to disk. This requires installingsdss-archon
with thefitsio
extra (e.g.,pip install sdss-archon[fitsio]
).
- Fix broken tests in 3.12.
- If
write_async=False
do not use an executor to write images to disk.
- Buffer is written to temporary file (usually in
/tmp
) before it's moved to the final permanent location.
- Reduce length of long header comment.
- Added a configuration option
files.write_async
(defaults totrue
) that determines whether all the camera files for a controller are written to disk concurrently or sequentially.
wait-until-idle
won't return until the exposure has been saved to disk.
- Ensure that the exposure delegate is always unlocked when
abort
orreset
are called.
- Extra header values do not overwrite the existing header comments.
- Lint using
ruff
.
#44 Allow exposure times longer than 1,000 seconds. This requires a change in how the ACF timing scripts are written to support setting the exposure time in centiseconds. See the PR description for details. Do not update to this version without updating the ACF file as well!
- Added
expose --async-readout
flag that finishes the expose command as soon as readout begins. - Added
wait-until-idle
command that returns once the spectrographs are idle.
- Do not set the
ERROR
status in the controller ifArchonController.get_device_status()
orArchonController.get_system()
time out. ExposureDelegate.readout()
will fail is any controller is still exposing.
- Prevent controller state to briefly go to
IDLE
before changing to a non-idle status.
- DT-4 Allow to create checksum files for each newly written images. To enable, add a
checksum
section to the configuration file withchecksum.write: true
. The mode of the checksum can be set withchecksum.mode
tomd5
(default) orsha1
. The file to which the checksum is appended can be defined withchecksum.file
, which default to the SJD with extension.sha1sum
or.md5sum
depending on the checksum mode.
- Upgrade
CLU
to2.0.0b2
and add theget-command-model
command.
- Allow to run
LOADTIMING
withoutAPPLYALL
after an init. - Output filenames as a single keyword.
- Add
ArchonController.send_and_wait()
. - Allow choosing what
APPLYXXX
commands to send on init.
- Fix overwriting of images when readout done independently. The
nextExposureFile
was not being increased in that case.
- Support Python 3.11.
- Update test and docker workflows. The docker image now uses
python:3.11-slim-bullseye
.
RESETTIMING
is no longer user, which should prevent race conditions in some circumstances.- Add a
pre_exposure
hook to the delegate. - Added
--no-write
flag toexpose
.
- HDUs are now written to a temporary file first which is then renamed to the final file name.
- It is now possible to defined the controller class in the actor and to pass the configuration to use to the controller.
- Add backplane ID and version to header.
- Allow to exclude some cameras from writing.
- Allow to use SJD for path.
- Add status
--debug
flag to change message level.
- Deal with controller without Lines or Pixels params.
- #40
ArchonController.write_config()
now acccepts anoverrides
dictionary with keywords to be replaced in the ACF file. The format is similar toArchonController.write_line()
. If a sectionarchon.acf_overrides
is present in the configuration file, those overrides will be applied when theinit
command is called. This allows to define a single ACF file but tweak some parameters depending on the controller to which it is sent.archon.acf_overrides
must be a dictionary with either aglobal
section (overrides sent to all controllers) or sections for each controller name. - Add
ExposureDelegate.expose_cotasks()
for tasks that should be run during integration. This is useful to grab sensor data that could change as readout begins, for example lamp status, but there is no promise that theexpose_cotasks()
will be waited or that will complete before readout begins.
ExposureDelegate.expose()
always blocks, even ifreadout=False
, and closes the shutter at the end of the exposure time.- The Archon buffer read is saved to the header of the images.
expose start|finish|abort
are notexpose --no-readout
,readout
, andabort
respectively.expose
without--no-readout
will expose and readout all in the same command.- Removed
lvm
submodule. Uselvmscp
instead.
- #38
ArchonController.write_line()
allows to set and apply a line in the configuration file without reloading it completely. - #39 Support windowing.
- Archon power status is now reported as part of the status and overall better handled.
- Some refactoring to support
yao
and more generally to implement external packages that use the library and the actor. - Added
power on|off
anddisconnect
commands. - Support
enabled_controllers
config keyword
expose finish --header
now accepts a JSON-like dictionary in which a keyword can be the name of a detector. In that case the contents of that keyword are only added to the detector with that name.- The
init
command does a better job at understanding relative paths. acf_file
in the configuration can be a dictionary of controller to file.
- #32 Expand the default header with information about gain, readout noise, bias section, etc.
- #24 Added
ExposureDelegate.readout_cotasks()
that can be overridden to execute tasks concurrently during readout. The LVM delegate now reads temperatures and IEB data at this point. - #34 The path to the last ACF file written to the controller is stored in the user configuration file (usually at
~/.config/sdss/archon.yaml
) from where it's read when the controller starts. This prevents having to initialise the controller every timearchon
is restarted (with the corresponding power cycling of the CCDs) just to update the ACF path, but it introduces a certain risk that the ACF stored in the configuration file and the one loaded are actually different. In general it's still recommended to do anarchon init
when the daemon is restarted. - Added script for ~800MHz readout.
- Use
framemode=split
and rearrange taplines to allow proper display in the GUI.
- #29 Support binning.
- #30 HDR (32-bit sampling) mode can be enabled when loading the script by running
archon init --hdr [<script>]
.
archon init
accepts an optional parameter to define the ACF script to load.- #31 Tests for the actor.
- Fixed error when moving shutter or hartmann doors manually.
- Added
--count
flag tolvm expose
to support multiple consecutive exposures. - Support for the three LVM CCDs.
- Always close connections to remote TCP services to prevent leaving unclosed file descriptors.
- Read pressure sensors concurrently.
- Update LVM lamps.
- Improve how auto-flushing is implemented. In its previous mode,
FlushOne
would often be called once between exposing and reading out, introducing an offset in the lines that manifested as a lines overscan of ~90 lines. The new implementation allows to disable auto-flushing before an exposure begins.
- #21 Implemented profiles for LVM and BOSS (placeholder).
- #22 Implement custom LVM expose delegate along with a group of
lvm
commands to control the shutter, hartmann doors, and to expose using the shutter. - #23 Refactor expose actor code into an
ExposeDelegate
that allows for more flexible customisation. - #26 Use the furo theme for the documentation.
- Add option to define additional header keywords in the configuration file that read values from the actor keyword datamodel.
- Add
lvm-lab
script for laboratory testing. POWERON
andPOWERBAD
controller status bits.- Code to log LVM exposures in Google Sheets.
- Require
sdss-clu>=0.7.8
to allowarchon expose finish --header
to work with strings that have spaces. It should now be possible to pass commands likearchon expose finish --header '{"KEYWORD1": [1, "A comment"]}'
. For header keyword values that are a list of value and comment, the list is converted into a tuple internally so thatastropy
can parse it correctly.
- #17 Handle actor shutdown more gently when it is started from the CLI either in debug mode or as a daemon.
- Fix Docker creation for tags.
- #10 Add actor command
reconnect
that allows to recreate the TCP/IP connection to one or multiple controllers. If the controller cannot be connected when the actor starts, a warning is issued but the actor will be created. - #11 Read the Govee H5179 temperature and humidity and write a basic FITS header.
- #12 Add
ArchonController
methods toabort
,read out
, andflush
an exposure. Actorexpose
command now acceptsexpose start
andexpose finish
to allow for non-blocking integration. Better handling of status flags.
- Basic documentation.
- Use GitHub Container Registry instead of Docker Hub.
- Initial version of the library and actor. Supports communication with the Archon controller, Archon command tracking and reply parsing, and basic actor functionality, including exposing.
- Build and push docker image to lvmi/archon.