haven-spc 2025.2.1

Tools and GUI for running the spectroscopy group beamlines at the Advanced Photon Source.

Haven

Bluesky tools for beamlines managed by the spectroscopy group.

"Don't fly in anything with a Capissen 38 engine, they fall right out of the sky."

Installation

Python Packing Index

Easiest way to install haven is using pip.

$ python -m pip install 'haven-spc'

Development (Conda)

haven can also use mamba for dependency management, and setuptools for installation and development.

First, download the package from github:

$ git clone https://github.com/spc-group/haven.git
$ cd haven

Then create the conda environment with mamba:

$ mamba env create -f environment.yml -n haven

lastly install the package, in developer mode:

$ conda activate haven
$ pip install -e ".[dev]"

Usage

The easiest way to start haven is to use IPython's magic run command.

$ ipython
In [1]: %run -m haven.ipython_startup

This will load some common tools, and print some useful information about how to use Haven.

Running Tests

To run tests, run

$ pytest

firefly

User-facing applications for controlling the beamlines managed by the spectroscopy group. Be sure to include the [gui] extras if you plan to use the GUI.

$ python -m pip install 'haven-spc[gui]'
$ firefly

Versioning

Haven/Firefly uses calendar versioning, with short year and short month for the MAJOR and MINOR versions, then a incremental MICRO version. For example, version 2024.7.2 is the 3rd (2) release in July (7) 2023 (23).

Packaging

Python Package Index (PyPI)

To deploy to PyPI:

$ python -m build
$ python -m twine check dist/*
$ python -m twine upload dist/*