diff --git a/core/dr-face/src/calibrate.rs b/core/dr-face/src/calibrate.rs index 21c15f2..859a53a 100644 --- a/core/dr-face/src/calibrate.rs +++ b/core/dr-face/src/calibrate.rs @@ -21,11 +21,20 @@ //! fails. The exceptions (mirrors, photographs of photographs, collages) are //! rare enough to be noise at this scale. //! -//! **Positives have to be earned.** In order of trustworthiness: pairs the user -//! has confirmed onto one person; then burst siblings, since FR-CULL-5 already -//! groups bursts and two faces in adjacent frames are near-certainly the same -//! person. Nothing else — bootstrapping positives from high cosine is circular, -//! fitting the calibration to the belief it was supposed to test. +//! **Positives have to be earned.** A positive is a pair of faces the user has +//! confirmed onto one person (FR-CULL-10), and there is no second source: the +//! only labelling this subsystem has is the labelling somebody did by hand. +//! Bootstrapping positives from a high cosine is circular — it fits the +//! calibration to the belief it was supposed to test — and that is the whole +//! of the alternative. +//! +//! docs/faces.md §8.1 names one more that would cost no labelling at all: two +//! faces in adjacent frames of one burst are near-certainly the same person, +//! and FR-CULL-5's grouping is sitting there. Nothing draws on it. This crate +//! cannot see a catalog, let alone the bursts in one — it is handed cosines by +//! whoever assembled the pair — and no caller does that assembly on its behalf +//! yet. Until one does, and until the purity of a burst pair is *measured* +//! rather than assumed, the positives are the confirmations and nothing else. //! //! Which is why a fresh library has **no valid calibration** — no fit of its //! own — and says so. It is not left without a curve: it uses the reference @@ -44,9 +53,10 @@ const BINS: usize = 200; /// Far stricter than the reference implementation's floor of two positives and /// one negative. That floor is reasonable there: its pairs come from a curated /// gallery of labelled reference portraits, where a positive pair is -/// trustworthy by construction. Here the positives are bootstrapped from bursts -/// and a handful of early confirmations, and the whole risk is fitting -/// confidently to too few of them. +/// trustworthy by construction. Here every positive is a pair somebody +/// confirmed while working through a young library's suggestions — a handful, +/// arriving slowly — and the whole risk is fitting confidently to too few of +/// them. pub const MIN_POSITIVE_PAIRS: u64 = 200; pub const MIN_NEGATIVE_PAIRS: u64 = 2_000;