getframes

Realistic synthetic camera frames for scientific imaging pipelines.

getframes generates physically realistic frames from CCD, CMOS, EMCCD, eAPD, and sCMOS detectors, with accurate, auditable noise physics — read noise, dark current, shot noise, fixed-pattern non-uniformity, a unified stochastic gain stage, clock-induced charge, nonlinearity, and cosmic rays. Generate dark, bias, and flat frames, or render a star field through a PSF and telescope into a science frame. Use it to build, test, and validate image-processing pipelines against ground truth.

import getframes as gf

cam = gf.Camera.from_preset("andor_ikon_m934")
frame = cam.dark_frame(exposure=60.0, temperature=-60.0, seed=0)

print(frame.stats())   # {'mean': ..., 'std': ..., ...}

Install

pip install getframes

Where to next

• Getting started — your first frames.
• The noise model — the physics, step by step.
• Observing scenes — sources, PSFs, and telescopes.
• Spectral mode — wavelength-resolved QE and SEDs.
• Camera presets — the built-in library and adding your own.
• API reference — every public class and function.
• API stability — what 1.0 guarantees.

Status

getframes 1.0 is stable: the public API is frozen under Semantic Versioning. See API stability.