Apstools

******

Bugfix released 2024-10-25.

Fixes
-----

- Allow imports to succeed when developing or testing with databroker v2.0+.
- In SpecWriterCallback2, set spec_filename in constructor.

Maintenance
-----------

- Use 'NeXus_release' file attribute in 'nxwriter' callback.

Deprecations
------------

- 'EpicsMotorLimitsMixin' features are now part of 'ophyd.EpicsMotor'.

******

released 2024-09-21

New Features
------------

* Add ad_creator() and ad_class_factory() -- Easy to create area detector objects.
* Add SpecWriterCallback2 (writes point-by-point to file).
* Support for most APS-U undulators. (All but for 29-ID.)

Fixes
-----

* Area detector image shape of (0, 0, 0) caused listdevice() to fail.
* PVPositionerSoftDone should set done=False at start of move.
* RuntimeError from listdevice() with area detector object.
* PV name typo in synApps SaveData() class. And capitalization.
* CI workflow artifact cache errors.

Maintenance
-----------

* Add ramp temperature and output enable to PTC-10.
* Remove Anaconda defaults channel from environment per TOS.
* Replace unit tests marked by 'local' decorator.
* Unit tests now support Python version 3.9, 3.10, & 3.11.
* Update common PVs for APS-U era.

******

released 2024-07-10

New Features
------------

* Add new APS PlanarUndulator device.
* Add new APS Revolver_Undulator device.
* Add new APS STI_Undulator device.
* Add new APS Undulator2M device.
* Add new APS Undulator4M device.

Maintenance
-----------

* Describe ``.component_names`` in *What are the objects to control?*
* Pin numpy<2 because upstream dask package needs a fix.
* Removed ApsUndulator and ApsUndulatorDual devices.
* Removed top-level requirements files. They were not used.
* Update APS cycle begin & end dates.
* Update device support for APS machine parameters (current, lifetime, ...).

******

released 2024-04-23

New Features
------------

* Add new plan for edge alignment called edge_align.
* Added a mesh grid scan plan that will collect until number of collection points is met.

Fixes
-----

* lineup2() should work with low intensity peaks.
* lineup2() would raise ZeroDivideError in some cases.
* Increase minimum aps-dm-api version to 8.
* PVPositionerSoftDone should set 'done' to False at start of a move.
* Race condition with SR570 pre-amp.

Maintenance
-----------

* Code format conforms to 'ruff'.
* Add additional support for APS Data Management API.
* Make the home page more concise.
* Refactor packaging from setup.py to pyproject.toml.

******

released 2024-01-23

New Features
------------

* Add (ophyd) device support for:
* DG-645 digital delay/pulse generator.
* Measurement Computing USB CTR08 High-Speed Counter/Timer
* Simulated process controller as positioner using EPICS swait record.
* Simulated process controller as positioner using EPICS transform record.
* synApps userArrayCalcs and EPICS acalcout record.
* Add subnet check for APSU beamlines.
* Add template support for writing NeXus/HDF5 files.
* New lineup2() plan can be used in console, notebooks, and queueserver.

Fixes
-----------

* Fix ``AD_full_file_name_local()`` for case when the read & write paths are identical.

Maintenance
-----------

* Avoid voltage spikes when changing gain of SRS570 preamplifier.
* In ``listdevice(show_pv=True)``, set ``cname=True, dname=False`` if not provided by caller.
* Move ``.OVAL`` field from ``EpicsRecordOutputFields to new ``EpicsRecordAnalogOutputFields``
* Write tables of plot statistics in most compact form.

Known Problems
--------------

* Remove ``ScalerMotorFlyer``, pending issue 763.

******

released 2023-07-19

New Features
------------

* Add ophyd device support for APS Data Management workflows.