aocore

Shared conventions, conformance checks and optics primitives for the adaptive-optics simulation stack: aobasis, pyturb, getframes, makewfs, solvephase, shmpipeline-ao and pyRTC.

The packages of the stack hand each other OPD maps, images, wind vectors and slopes. aocore makes sure they mean the same thing by them:

• CONVENTIONS.md is the contract: array axes, pixel centres, units, propagation sign and normalization, RMS and Strehl definitions, Zernike orientation, wind and slope conventions, and who owns which primitive.
• aocore.conformance holds executable checks of the contract that every package runs against its own implementation in its test suite.
• The primitives themselves, implemented once:
  • a NumPy/CuPy array backend;
  • anti-aliased and segmented pupils with telescope presets;
  • FFT, matrix-Fourier, focal-plane and angular-spectrum propagators with exact adjoints;
  • wavefront metrics, least-squares phase unwrapping, pixel binning and unit constants.

pip install aocore              # CPU
pip install "aocore[cuda12]"    # + CuPy for CUDA 12.x

import aocore as ac

pupil = ac.Pupil.vlt(128)
prop = ac.FocalPlanePropagator(pupil.shape, pupil.pitch, 1.6e-6, 1.6e-6 / 8 / 2, (64, 64))
print(ac.rms(opd, pupil, remove="tiptilt"))  # CONVENTIONS 4.1

# In any package's tests:
from aocore import conformance

conformance.check_tilt_direction(
    my_image_from_opd, pupil_shape=(64, 64), pitch=..., pixel_scale=...
)

aocore depends only on NumPy, SciPy and threadpoolctl. CuPy is optional.

License

MIT. Everything in the stack must be shippable under MIT (see CONVENTIONS 8.4).