getframes 2.0.0__tar.gz → 2.1.0__tar.gz

{getframes-2.0.0 → getframes-2.1.0}/.gitignore

@@ -222,3 +222,5 @@ __marimo__/
 
 # Streamlit
 .streamlit/secrets.toml
+keck_ttf
+*.png

{getframes-2.0.0 → getframes-2.1.0}/CHANGELOG.md

@@ -6,6 +6,55 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [2.1.0] - 2026-07-19
+
+### Added
+
+- Five scientific-camera presets used by the Keck tip/tilt and low-bandwidth WFS
+  detector trade example: KURO 1200B, Prime 95B, Marana 4.2B-11, QHY530 Pro II,
+  and Aries 6504 Pro. All five now include a wavelength-resolved `qe_curve`:
+  Marana and Aries from Andor's/Gpixel's published data (the Aries
+  `QE x fill factor` trace is digitized from Gpixel's graph); KURO 1200B,
+  Prime 95B, and QHY530 Pro II are digitized from published manufacturer QE
+  plots.
+- A `quantum_efficiency` override on `Camera.expose_series`, matching
+  `Camera.expose` and supporting pre-integrated spectral electron-rate series.
+- A Keck/SciMeasure Little Joe CCD39 preset with the manufacturer CCD39-01
+  standard-AR/no-window spectral-response curve.
+- `getframes.analysis.matched_filter_centroid`, a background-insensitive
+  cross-correlation centroid with sub-pixel peak refinement.
+- `Frame.binned(factor, method=...)`, post-read digital binning of a frame into
+  `factor x factor` super-pixels (sum or mean).
+- `CameraConfig.supported_binnings` and `CameraConfig.binning_method` — binning is
+  now a first-class config parameter. The Keck-trade presets set these directly and
+  drop the `extra.detector_modes` per-binning tables; cameras with more than one
+  read-noise operating point keep a slim `extra.read_modes` list instead.
+- Native pixel binning in the signal chain: `Camera.expose`, `Camera.expose_series`,
+  and `noise.simulate_frame` accept `binning` and `binning_mode`. `"digital"`
+  (post-read, the default) reads each native pixel with its own read noise then sums,
+  so binned read noise grows as `binning`; `"on_chip"` (pre-read charge-domain /
+  hardware binning) sums the charge before the amplifier, so a single read noise is
+  applied per super-pixel. Exposed `noise.block_sum` for the super-pixel summation.
+- `getframes.analysis.centroid` now accepts a per-pixel array `background` (e.g. a
+  master sky+dark frame) and an optional `threshold` (scalar or per-pixel noise
+  map), making it a calibrated thresholded centre-of-gravity estimator suitable
+  for a real-time controller. Both additions are backwards compatible.
+- A Keck LGS tip/tilt and low-bandwidth wavefront-sensor detector trade-study
+  example, including physically sampled AO/sub-aperture PSFs, complete detector
+  Monte Carlo simulations, blackbody NGS weighting of each camera's QE curve
+  (`--ngs-teff`), the 600–950 nm TTS/LBWFS arm bandpass folded into the zero-point
+  bands, Monte Carlo standard errors on every point, a per-camera closed-loop
+  cadence optimisation (a physical `a·f + b·f²` noise model fitted to the Monte
+  Carlo data, saturation-aware, against a Tyler tilt-lag disturbance model), and
+  a best/worst-performer frame gallery figure beside the trade curves.
+
+### Fixed
+
+- Type-checking compatibility with newer NumPy (2.2): tightened stub types for
+  `_stamp_bounds`/`_radial_grid` shape arguments, pinned `float64` on a few
+  `np.linspace` constructions, and dropped now-unused `type: ignore` comments
+  around the `trapz`/`trapezoid` shim. No behavioural change.
+
 ## [2.0.0] - 2026-06-29
 
 The 2.0 cut promotes the full surface grown across 1.1–1.6 to **stable** and lands
@@ -248,6 +297,8 @@ together in 1.0.
 - Documentation, runnable examples, and CI (lint, type-check, test matrix, PyPI
   release via Trusted Publishing).
 
-[Unreleased]: https://github.com/jacotay7/getframes/compare/v1.0.0...HEAD
-[1.0.0]: https://github.com/jacotay7/getframes/compare/v0.1.0...v1.0.0
-[0.1.0]: https://github.com/jacotay7/getframes/releases/tag/v0.1.0
+[Unreleased]: https://github.com/jacotay7/getframes/compare/2.1.0...HEAD
+[2.1.0]: https://github.com/jacotay7/getframes/compare/2.0.0...2.1.0
+[2.0.0]: https://github.com/jacotay7/getframes/compare/1.0.0...2.0.0
+[1.0.0]: https://github.com/jacotay7/getframes/compare/0.1.0...1.0.0
+[0.1.0]: https://github.com/jacotay7/getframes/releases/tag/0.1.0

{getframes-2.0.0 → getframes-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: getframes
-Version: 2.0.0
+Version: 2.1.0
 Summary: Generate physically realistic synthetic camera frames (CCD/CMOS/EMCCD/eAPD/sCMOS) — dark, bias, flat, and rendered star fields — with auditable noise physics for scientific imaging pipelines.
 Project-URL: Homepage, https://github.com/jacotay7/getframes
 Project-URL: Documentation, https://jacotay7.github.io/getframes/
@@ -165,6 +165,11 @@ preset_info()         # rich descriptors for each preset
 | `leonardo_saphira` | EAPD | HgCdTe avalanche IR array (AO wavefront sensing) |
 | `zwo_asi2600mm` | CMOS | Sony IMX571 cooled CMOS |
 | `hamamatsu_orca_fusion` | sCMOS | Back-thinned sCMOS with per-pixel read noise |
+| `andor_marana_4_2b_11` | sCMOS | 11 µm-pixel, back-illuminated scientific CMOS |
+| `photometrics_prime_95b` | sCMOS | 11 µm-pixel, 95% peak-QE scientific CMOS |
+| `princeton_instruments_kuro_1200b` | sCMOS | Back-illuminated scientific CMOS |
+| `qhy530_pro_ii` | CMOS | Global-shutter Sony IMX530 scientific camera |
+| `tucsen_aries_6504_pro` | sCMOS | Sub-electron sensitive-mode read noise |
 | `generic_ccd` / `generic_cmos` / `generic_emccd` / `generic_eapd` / `generic_scmos` | — | Idealised references for teaching/testing |
 
 ## How the dark-frame model works

{getframes-2.0.0 → getframes-2.1.0}/README.md

@@ -121,6 +121,11 @@ preset_info()         # rich descriptors for each preset
 | `leonardo_saphira` | EAPD | HgCdTe avalanche IR array (AO wavefront sensing) |
 | `zwo_asi2600mm` | CMOS | Sony IMX571 cooled CMOS |
 | `hamamatsu_orca_fusion` | sCMOS | Back-thinned sCMOS with per-pixel read noise |
+| `andor_marana_4_2b_11` | sCMOS | 11 µm-pixel, back-illuminated scientific CMOS |
+| `photometrics_prime_95b` | sCMOS | 11 µm-pixel, 95% peak-QE scientific CMOS |
+| `princeton_instruments_kuro_1200b` | sCMOS | Back-illuminated scientific CMOS |
+| `qhy530_pro_ii` | CMOS | Global-shutter Sony IMX530 scientific camera |
+| `tucsen_aries_6504_pro` | sCMOS | Sub-electron sensitive-mode read noise |
 | `generic_ccd` / `generic_cmos` / `generic_emccd` / `generic_eapd` / `generic_scmos` | — | Idealised references for teaching/testing |
 
 ## How the dark-frame model works