Skip to main content

qualia_vision/recipes/
self_monitor_pulse.rs

1//! Recipe: consent → quality → ROI → rPPG ensemble HR.
2
3use crate::biosense::{
4    ensemble_hr, face_roi_center, frame_blur_score, reject_low_quality, roi_mean_rgb,
5    BiosenseConsent, HrEstimate, QualityReject,
6};
7use crate::cv::buffer::{GrayView, RgbView};
8use crate::cv::color::rgb_to_gray_u8;
9use crate::cv::error::CvError;
10
11/// `rgb_frames` consecutive RGB frames packed; each frame_bytes = w*h*3.
12pub fn self_monitor_pulse(
13    consent: BiosenseConsent,
14    rgb_frames: &[u8],
15    n_frames: usize,
16    width: u32,
17    height: u32,
18    fps: f32,
19) -> Result<HrEstimate, CvError> {
20    if !consent.may_process() {
21        return Err(CvError::InvalidParameter);
22    }
23    let fb = (width * height * 3) as usize;
24    if n_frames < 32 || rgb_frames.len() < n_frames * fb {
25        return Err(CvError::BufferTooSmall);
26    }
27    // Quality on first frame
28    let mut gray = vec![0u8; (width * height) as usize];
29    let v0 =
30        RgbView::new(width, height, width * 3, &rgb_frames[..fb]).ok_or(CvError::EmptyInput)?;
31    rgb_to_gray_u8(v0, &mut gray)?;
32    let gv = GrayView::new(width, height, width, &gray).ok_or(CvError::EmptyInput)?;
33    let blur = frame_blur_score(gv);
34    if reject_low_quality(blur, 0.0, 10.0, 40.0) == QualityReject::TooBlurry {
35        return Err(CvError::InvalidParameter);
36    }
37    let roi = face_roi_center(v0);
38    let mut means = vec![0.0f32; n_frames * 3];
39    for i in 0..n_frames {
40        let slice = &rgb_frames[i * fb..(i + 1) * fb];
41        let v = RgbView::new(width, height, width * 3, slice).ok_or(CvError::EmptyInput)?;
42        let mut m = [0.0f32; 3];
43        roi_mean_rgb(v, roi, &mut m);
44        means[i * 3] = m[0];
45        means[i * 3 + 1] = m[1];
46        means[i * 3 + 2] = m[2];
47    }
48    ensemble_hr(consent, &means, n_frames, fps, 0.15)
49}