rPPG Web — Getting Started

pnpm add @elata-biosciences/rppg-web

import { RppgProcessor } from "@elata-biosciences/rppg-web";

const processor = new RppgProcessor("wasm", 30); // backend, sampleRate

// Feed green-channel intensity from face ROI each frame
processor.pushSample(performance.now(), greenIntensity);

// Get current heart rate estimate
const metrics = processor.getMetrics();
console.log("BPM:", metrics.bpm);
console.log("Quality:", metrics.quality);

new RppgProcessor(backend: Backend, sampleRate: number, windowSeconds?: number)

// Green channel only
processor.pushSample(timestampMs, intensity);

// RGB channels
processor.pushSampleRgb(timestampMs, r, g, b, skinRatio?);

// RGB with motion and clip metadata
processor.pushSampleRgbMeta(timestampMs, r, g, b, skinRatio?, motion?, clipRatio?);

const metrics: Metrics = processor.getMetrics();

processor.enableTracker(minBpm?, maxBpm?, numParticles?);

const snapshot = processor.getStateSnapshot();
// ... later
processor.loadStateSnapshot(snapshot);