hartmannActor

Versions

The hartmann actor is responsible for taking and analysing Hartmann door exposures to determine the optimal focus for the BOSS spectrographs at APO and LCO (sp1 and sp2, respectively). It also commands the spectrograph collimator motors to adjust the focus.

Procedure

The hartmann actor performs the following steps:

Turns on the appropriate arc lamps and waits for them to warm up.
Takes two BOSS exposures, each one with a different Hartmann door closed (left and right). For a perfectly focused system, the exposures would be identical. As spectrograph focus degrades, the position of the spectral lines in one of the Hartmann images shifts vertically with respect to the other. The shift is proportional to the amount of defocus, which can be corrected by either adjusting the collimator position or the position of the blue or red cameras via the camera "rings". In practice only ring needs to be adjusted, with the other camera being the reference one and its focus optimised by the collimator. The blue ring/camera is the one that is adjusted.
The images are analysed to determine the vertical shift. This is done by applying vertical shifts to one of the images and computing the product of both images. The product will be maximised when the vertical shift is correct. A calibration is applied to convert the vertical shift to a collimator movement.
If the collimator can correct the focus for both cameras, within a tolerance, the collimator is moved that amount. Otherwise, the necessary ring movement is computed and the user is instructed to move the blue ring by that amount and rerun the hartmann collimate command.

Usage

See hartmann --help for usage instructions. In general the hartmann collimate command runs the entire sequence. --no-move can be used to run the sequence without moving the collimator. Other flags such as --exposure-time or --ignore-residuals can be used to change the command behaviour.

Code style and development

hartmannActor uses uv for package and dependency management, and ruff for code style enforcement. ty is the recommended type checker. See pyproject.toml for configuration details.

Development Status
- 4 - Beta
Intended Audience
- Science/Research
Natural Language
- English
Operating System
- OS Independent
Topic
- Software Development :: Libraries :: Python Modules

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sdss_hartmannactor-3.1.0.tar.gz (18.2 kB view details)

Uploaded Aug 3, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

sdss_hartmannactor-3.1.0-py3-none-any.whl (22.3 kB view details)

Uploaded Aug 3, 2026 Python 3

File details

Details for the file sdss_hartmannactor-3.1.0.tar.gz.

File metadata

Download URL: sdss_hartmannactor-3.1.0.tar.gz
Upload date: Aug 3, 2026
Size: 18.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for sdss_hartmannactor-3.1.0.tar.gz
Algorithm	Hash digest
SHA256	`daabfe57ec20a6f76ce42f5101256eafd76d4a75fb6d26402d9a3418442a7690`
MD5	`5ce5776d2cb6096f3c6c40bc8b9a34d7`
BLAKE2b-256	`b0a900110ca0ee2bb2af7efd39929394352c4cc30515df02b610c8f82ec9235a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for sdss_hartmannactor-3.1.0.tar.gz:

Publisher: release.yml on sdss/hartmannActor

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: sdss_hartmannactor-3.1.0.tar.gz
- Subject digest: daabfe57ec20a6f76ce42f5101256eafd76d4a75fb6d26402d9a3418442a7690
- Sigstore transparency entry: 2335234016
- Sigstore integration time: Aug 3, 2026
Source repository:
- Permalink: sdss/hartmannActor@efb0b581db91499fa5159a67f1f5f8980eaf54b7
- Branch / Tag: refs/tags/3.1.0
- Owner: https://github.com/sdss
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@efb0b581db91499fa5159a67f1f5f8980eaf54b7
- Trigger Event: push