Skip to main content

qualia_vision/biosense/magnification/
mod.rs

1//! Eulerian Video Magnification (excellence-grade TODO-EVM1).
2//!
3//! Building blocks: Gaussian/Laplacian pyramid, temporal IIR band-pass,
4//! YIQ colour EVM, multi-scale motion EVM, SNR abstain, consent gate.
5
6pub mod colour_evm_yiq;
7pub mod eulerian_color_magnify;
8pub mod eulerian_motion_magnify;
9pub mod evm_snr_gate;
10pub mod evm_with_consent;
11pub mod gaussian_pyramid_build;
12pub mod gaussian_pyramid_level;
13pub mod laplacian_pyramid_build;
14pub mod pyramid_reconstruct;
15pub mod temporal_bandpass;
16pub mod temporal_bandpass_iir;
17
18pub use colour_evm_yiq::{colour_evm_yiq, ColourEvmParams};
19pub use eulerian_color_magnify::{eulerian_color_magnify, eulerian_color_magnify_ex};
20pub use eulerian_motion_magnify::{
21    eulerian_motion_magnify, eulerian_motion_magnify_ex, MotionEvmParams,
22};
23pub use evm_snr_gate::{
24    band_energy_snr, energy_ms, evm_snr_gate, evm_snr_gate_energies, evm_snr_gate_trace, EvmRefuse,
25    EvmSnrVerdict, DEFAULT_EVM_MIN_SNR,
26};
27pub use evm_with_consent::{eulerian_color_magnify_consented, eulerian_motion_magnify_consented};
28pub use gaussian_pyramid_build::{
29    gaussian_pyramid_build, gaussian_pyramid_scratch_elems, PyramidLevelMeta, MAX_PYRAMID_LEVELS,
30};
31pub use gaussian_pyramid_level::gaussian_pyramid_down_u8;
32pub use laplacian_pyramid_build::laplacian_pyramid_build;
33pub use pyramid_reconstruct::pyramid_reconstruct;
34pub use temporal_bandpass::{
35    bandpass_step, design_bandpass_iir, temporal_bandpass_planes, temporal_bandpass_series,
36    BandpassIir, LowpassAlpha,
37};
38pub use temporal_bandpass_iir::{temporal_bandpass_iir, BandpassState};
39
40// ---- Hz-explicit aliases expected by biosense re-exports / recipes ----
41
42/// Colour EVM with explicit sample rate and band (Hz).
43pub fn eulerian_color_magnify_hz(
44    frames: &[u8],
45    n_frames: usize,
46    width: u32,
47    height: u32,
48    fps: f32,
49    f_lo_hz: f32,
50    f_hi_hz: f32,
51    alpha: f32,
52    out: &mut [u8],
53) -> Result<f32, EvmRefuse> {
54    eulerian_color_magnify_ex(
55        frames,
56        n_frames,
57        width,
58        height,
59        ColourEvmParams {
60            fps,
61            f_lo_hz,
62            f_hi_hz,
63            alpha_chroma: alpha,
64            require_snr: true,
65            ..ColourEvmParams::default()
66        },
67        out,
68    )
69}
70
71/// Motion EVM with explicit sample rate and band (Hz).
72pub fn eulerian_motion_magnify_hz(
73    frames: &[u8],
74    n_frames: usize,
75    width: u32,
76    height: u32,
77    fps: f32,
78    f_lo_hz: f32,
79    f_hi_hz: f32,
80    alpha: f32,
81    out: &mut [u8],
82) -> Result<f32, EvmRefuse> {
83    eulerian_motion_magnify_ex(
84        frames,
85        n_frames,
86        width,
87        height,
88        MotionEvmParams {
89            fps,
90            f_lo_hz,
91            f_hi_hz,
92            alpha,
93            require_snr: true,
94            ..MotionEvmParams::default()
95        },
96        out,
97    )
98}