Units and coordinates
makewfs follows the AO stack conventions defined by
aocore (CONVENTIONS.md), and
tests/test_conformance.py runs aocore's checks against both sensors. Pixel
centres, arcsecond/radian constants, OPD/phase conversion and flux-conserving
pixel binning come from aocore rather than local copies.
- Input arrays are
(y, x)NumPy arrays. - OPD is metres. Phase is radians and requires
input.reference_wavelength_m. input.grid_extent_mis the physical width/height represented by the input array; coordinates are centred on pixel centres.source.field_angle_arcsecis[x, y]on-sky angle, converted withaocore.ARCSEC_TO_RAD.lgs_launch_position_mis[x, y]in the entrance-pupil plane.- Optical output is photons/s/native detector pixel. Detector output is ADU.
The centred FFT helpers use unitary normalization. They keep the fftshift
convention (zero frequency on pixel n // 2) internally; the detector images
the sensors produce follow the stack's centring, with the optical axis at pixel
(n - 1) / 2, which the conformance tests check. Piston removal is a numerical
stabilization only; it does not alter intensity. Detector cropping reports lost
flux rather than renormalizing the image.