Release History#

v1.0.0b1 (2026-04-17)#

Features#

Manual suggestions: A new method for the Agent that allows manual optimization control (#235).
Reconfigurable search spaces: Search spaces can now be modified between optimization steps, allowing dynamic adjustment of DOF bounds and constraints (#268).
Model checkpoints: Save and restore optimizer state across sessions (#233).
Fixed parameters: Hold specific parameters constant during optimization via Agent.fixed_dofs (#252).
Multi-point routing: When suggesting multiple points, suggestions are now routed to minimize actuator travel (#217).
Failed and abandoned suggestions: Properly handle and track failed optimization trials (#272).
Optimization logging callback: New OptimizationCallbackRouter and logging callback for monitoring optimization progress (#270).
Optimization step tracking via event-model: Optimization metadata is now emitted as Bluesky event-model documents (#236).
Queueserver support: New QueueserverAgent for running optimization through the Bluesky queueserver (#212, #264, #266).
Actuator and Sensor types: Expanded protocol types to support flyable and collectable devices (#211).
Python 3.13 support (#206).

Breaking Changes#

Plans moved to top-level package: Plans are now imported from blop.plans instead of blop.ax.plans (#259).
Simulation code separated: The simulation module has been extracted into a separate blop_sim package (#248, #256).
Deprecated code removed: Legacy APIs deprecated in earlier releases have been removed (#218).
Deprecated bayesian.acquisition removed: Use BoTorch’s built-in constrained acquisition functions instead (#207).

Dependency Changes#

Requires Ax Platform >= 1.2.3 (#241).
Requires BoTorch >= 0.16.0 (#221).

Documentation#

New how-to guide for using Tiled as a databroker (#215).
New how-to guide for using ophyd and ophyd-async devices (#210).
New explanation document for the Ax integration (#227).
Updated tutorials for the simple experiment and XRT KB mirrors (#222, #223, #224).

v0.9.0 (2025-12-08)#

What’s Changed#

Protocols for optimization with Bluesky by @thopkins32 in https://github.com/NSLS-II/blop/pull/185
Evaluation functions by @thopkins32 in https://github.com/NSLS-II/blop/pull/186
Standard plans for optimization that work with protocols by @thopkins32 in https://github.com/NSLS-II/blop/pull/187
Refactor Ax agent to use new protocols by @thopkins32 in https://github.com/NSLS-II/blop/pull/188
Remove default evaluation options by @thopkins32 in https://github.com/NSLS-II/blop/pull/189
Direct AxOptimizer protocol impelementation by @thopkins32 in https://github.com/NSLS-II/blop/pull/191
Remove unused Ax helpers by @thopkins32 in https://github.com/NSLS-II/blop/pull/193
Simplified DOF classes for Ax backend by @thopkins32 in https://github.com/NSLS-II/blop/pull/195
Simpler Objective class, ScalarizedObjective, and OutcomeConstraints by @thopkins32 in https://github.com/NSLS-II/blop/pull/196
Protocol explanation by @thopkins32 in https://github.com/NSLS-II/blop/pull/192
New DOFConstraint class and Agent update by @thopkins32 in https://github.com/NSLS-II/blop/pull/198
Agent composition over inheritance by @thopkins32 in https://github.com/NSLS-II/blop/pull/199
Add how-to-guide for outcome constraints by @thopkins32 in https://github.com/NSLS-II/blop/pull/200
Extensive updates to reference docs by @thopkins32 in https://github.com/NSLS-II/blop/pull/201
Change furo theme -> pydata-sphinx-theme by @thopkins32 in https://github.com/NSLS-II/blop/pull/202
Update docstrings with much more detail by @thopkins32 in https://github.com/NSLS-II/blop/pull/203

v0.8.1 (2025-11-06)#

What’s Changed#

Pin networkx and tabulate (required by python-tsp) by @thopkins32 in https://github.com/NSLS-II/blop/pull/171
Update blop conda-forge badge by @thopkins32 in https://github.com/NSLS-II/blop/pull/172
Baseline measurements by @thopkins32 in https://github.com/NSLS-II/blop/pull/173
Implement suggest & ingest from gest-api by @thopkins32 in https://github.com/NSLS-II/blop/pull/174
Move tests to tests/integration by @thopkins32 in https://github.com/NSLS-II/blop/pull/176
Improve Bluesky plans by @thopkins32 in https://github.com/NSLS-II/blop/pull/177
Include ellipses in doctest by @thopkins32 in https://github.com/NSLS-II/blop/pull/179
Parameter constraints by @thopkins32 in https://github.com/NSLS-II/blop/pull/181

v0.8.0 (2025-10-13)#

What’s Changed#

DOC: add citation information to README by @mrakitin in https://github.com/NSLS-II/blop/pull/119
Ax Adapters for Blop and Minimal Agent Interface by @thopkins32 in https://github.com/NSLS-II/blop/pull/126
Adding Pixi by @jessica-moylan in https://github.com/NSLS-II/blop/pull/135
Ax custom generation strategies by @thopkins32 in https://github.com/NSLS-II/blop/pull/136
Ax Analyses by @thopkins32 in https://github.com/NSLS-II/blop/pull/138
Adding tiled comptability using dictionaries by @jessica-moylan in https://github.com/NSLS-II/blop/pull/143
Implement multitask models by @thomaswmorris in https://github.com/NSLS-II/blop/pull/124
Refactored tests to reduce redundancy (179 -> 35 tests) by @thopkins32 in https://github.com/NSLS-II/blop/pull/148
Update tutorial notebooks by @thopkins32 in https://github.com/NSLS-II/blop/pull/147
Deprecating older APIs by @thopkins32 in https://github.com/NSLS-II/blop/pull/146
Auto-generated API docs for Agent, AxAgent, DOFs, and Objectives by @thopkins32 in https://github.com/NSLS-II/blop/pull/149
Executable tutorials using jupyterlab by @jessica-moylan in https://github.com/NSLS-II/blop/pull/154
Update and simplify packaging by @thopkins32 in https://github.com/NSLS-II/blop/pull/155
Documentation Update by @thopkins32 in https://github.com/NSLS-II/blop/pull/160
Add docs on attaching data to experiments by @thopkins32 in https://github.com/NSLS-II/blop/pull/162
How-to guide for custom generation strategies by @thopkins32 in https://github.com/NSLS-II/blop/pull/163

New Contributors#

@jessica-moylan made their first contribution in https://github.com/NSLS-II/blop/pull/117

v0.7.5 (2025-06-18)#

What’s Changed#

Remove ‘created’ from release types by @jennmald in https://github.com/NSLS-II/blop/pull/105
Refactor DOFs to fix trust domain behavior by @thomaswmorris in https://github.com/NSLS-II/blop/pull/97
Update installation.rst to reflect the version of python tested against by @whs92 in https://github.com/NSLS-II/blop/pull/107
Fix CI failures due to domain transforms by @thomaswmorris in https://github.com/NSLS-II/blop/pull/108
Update documentation for Agent, DOF, and Objective by @thomaswmorris in https://github.com/NSLS-II/blop/pull/113
Remove ortools as a dependency by @thomaswmorris in https://github.com/NSLS-II/blop/pull/115
Ax integrations with the Bluesky ecosystem by @thopkins32 in https://github.com/NSLS-II/blop/pull/112

New Contributors#

@whs92 made their first contribution in https://github.com/NSLS-II/blop/pull/107

v0.7.4 (2025-03-04)#

Add missing files for documentation
Fix trigger condition for releases on PyPI and documentation

v0.7.3 (2025-03-04)#

What’s Changed#

Fix documentation CI error by @jennmald in https://github.com/NSLS-II/blop/pull/84
Fix fitness and constraint plots by @jennmald in https://github.com/NSLS-II/blop/pull/80
Refactor: Make agent default compatible with Bluesky Adaptive by @maffettone in https://github.com/NSLS-II/blop/pull/86
Ruff linter support; Removal of black, flake8, and isort by @thopkins32 in https://github.com/NSLS-II/blop/pull/95
Add type hints by @thopkins32 in https://github.com/NSLS-II/blop/pull/87
Remove Python 3.9 support by @thopkins32 in https://github.com/NSLS-II/blop/pull/101
Add XRT demo to blop tutorials by @jennmald in https://github.com/NSLS-II/blop/pull/102

New Contributors#

@jennmald made their first contribution in https://github.com/NSLS-II/blop/pull/84
@maffettone made their first contribution in https://github.com/NSLS-II/blop/pull/86
@thopkins32 made their first contribution in https://github.com/NSLS-II/blop/pull/95

v0.7.2 (2025-01-31)#

Renamed package in PyPI to blop.
bloptools is still avaliable on PyPI.

v0.7.1 (2024-09-26)#

Add simulated hardware.
Added a method to prune bad data.

v0.7.0 (2024-05-13)#

Added functionality for Pareto optimization.
Support for discrete degrees of freedom.

v0.6.0 (2024-02-01)#

More sophisticated targeting capabilities for different objectives.
More user-friendly agent controls.

v0.5.0 (2023-11-09)#

Added hypervolume acquisition and constraints.
Better specification of latent dimensions.
Implemented Monte Carlo acquisition functions.
Added classes for DOFs and objectives.

v0.4.0 (2023-08-11)#

Easier-to-use syntax when building the agent.
Modular and stateful agent design for better usability.
Added the ability to save/load both data and hyperparameters.
Added passive degrees of freedom.
Added a number of test functions / artificial landscapes for optimization.
Updated the Sphinx documentation theme to furo.

v0.3.0 (2023-06-17)#

Implemented multi-task optimization.
Simplified the syntax on initializing the agent.
Resolved issues discovered at NSLS-II ISS.

v0.2.0 (2023-04-25)#

Rebased the Bayesian optimization models to be compatible with botorch code.
Optimization objectives can be customized with experiment modules.
Added optimization test functions for quicker testing and development.

v0.1.0 (2023-03-10)#

Changed from using SafeConfigParser to ConfigParser.
Implemented the initial version of the GP optimizer.
Updated the repo structure based on the new cookiecutter.
Added tests to the CI.

v0.0.2 (2021-05-14)#

Fixed _run_flyers() for sirepo optimization.

v0.0.1 - Initial Release (2020-09-01)#

Initial release of the Beamline Optimization library.

Used in:

Planned:

https://github.com/NSLS-II-TES/profile_collection