robust op• Data kinds: matrix × signal → table
• Call: import fullseye as fs; fs.ledger.residue_fault_locate(residues, periods, weights=None, lo=0.0, hi=None, tol=0.05) -> 'dict' (to call the implementation directly, import residue; residue.residue_fault_locate(residues, periods, weights=None, lo=0.0, hi=None, tol=0.05) -> 'dict'; from the registry, opsresidue.get("residue_fault_locate"))
Which band is corrupted? (redundant residue number system) -> dict.
With more bands than [lo, hi) needs, the bands check each other. Each band is left out in turn and the rest are solved; the band whose removal leaves a consistent set (every residual within tol x its period) while itself disagreeing by more than tol is the corrupted one. If no single removal is consistent, or two different removals both are, the answer is undecidable and the value is NaN — never a guess.
Returns {"value", "faulty", "consistent_all", "worst_leave_one_out"}:
faulty is the band index, -1 = all bands agree (no fault), -2 = undecidable. Localising one fault needs the range to be resolvable by every subset of N-1 bands (it is refused otherwise); the narrower [lo, hi) is relative to the periods' least common multiple, the more of the redundancy is left to localise with.
• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).
• Operator provenance and references — the sources of the research/methods this op family came from.
• The canonical algorithm (author, year) and its uses are named in the family usage guide above.
• poc_residue_crt — py -3.11 examples/poc_residue_crt.py
table as input)—
robust)*Provenance: residue.py — RESIDUE operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.