Struct AnalysisResult 

pub struct AnalysisResult {

    pub width: usize,
    pub height: usize,
    pub source_channels: usize,
    pub background: f32,
    pub noise: f32,
    pub detection_threshold: f32,
    pub stars_detected: usize,
    pub stars: Vec<StarMetrics>,
    pub median_fwhm: f32,
    pub median_eccentricity: f32,
    pub median_snr: f32,
    pub median_hfr: f32,
    pub snr_weight: f32,
    pub psf_signal: f32,
    pub frame_snr: f32,
    pub trail_r_squared: f32,
    pub possibly_trailed: bool,
    pub measured_fwhm_kernel: f32,
    pub median_beta: Option<f32>,
}

Full analysis result for an image.

Fields

width: usize

Image width (after debayer if applicable).

height: usize

Image height (after debayer if applicable).

source_channels: usize

Number of source channels: 1 = mono, 3 = color (after debayer).

background: f32

Global background level (ADU).

noise: f32

Background noise sigma (ADU).

detection_threshold: f32

Actual detection threshold used (ADU above background).

stars_detected: usize

Total stars detected (raw detection count, before measure cap).

stars: Vec<StarMetrics>

Per-star metrics, sorted by flux descending, capped at max_stars.

median_fwhm: f32

Median FWHM across all measured stars (pixels).

median_eccentricity: f32

Median eccentricity across all measured stars.

median_snr: f32

Median per-star SNR.

median_hfr: f32

Median half-flux radius (pixels).

snr_weight: f32

SNR weight for frame ranking: (MeanDev / noise)².

psf_signal: f32

PSF signal: median(star_peaks) / noise.

frame_snr: f32

Per-frame SNR: background / noise (linear ratio). Use for stacking prediction: stacked_snr = sqrt(sum(frame_snr_i²)).

trail_r_squared: f32

Rayleigh R̄² (squared mean resultant length) for directional coherence of star position angles. Uses 2θ doubling for axial orientation data. 0.0 = uniform (no trail), 1.0 = all stars aligned (strong trail). A threshold of 0.5 corresponds to R̄ ≈ 0.71 (strong coherence).

possibly_trailed: bool

True if the image is likely trailed, based on the Rayleigh test. Fires when R̄² > threshold with significant p-value, or when R̄² > 0.05 with high median eccentricity (catches non-coherent guiding issues). Requires ≥20 detected stars for statistical reliability.

measured_fwhm_kernel: f32

Measured FWHM from adaptive two-pass detection (pixels). This is the FWHM used for the final matched filter kernel. If the first-pass FWHM was within 30% of 3.0, this equals 3.0.

median_beta: Option<f32>

Median Moffat β across all stars (None if Moffat fitting not used). Typical range: 2.0-5.0 for real optics. Lower = broader wings.