Expand description
Pure-Rust core for vernier.
This crate has no Python dependencies and is usable directly from Rust binaries, CLI tools, and embedded contexts.
By design, the public API of this crate is the source of truth for vernier’s
evaluation semantics. The vernier-ffi crate is a thin data-conversion
layer over this one; if you find yourself adding logic to vernier-ffi
rather than here, that’s a code smell worth resolving.
See the project’s docs/explanation/ for the architecture overview and
docs/adr/ for the design decisions that shaped this crate.
Re-exports§
pub use accumulate::Accumulated;pub use dataset::CocoDataset;pub use dataset::CocoDetections;pub use dataset::EvalDataset;pub use error::EvalError;pub use evaluate::evaluate_bbox;pub use evaluate::evaluate_boundary;pub use evaluate::evaluate_keypoints;pub use evaluate::evaluate_segm;pub use evaluate::evaluate_with;pub use evaluate::AreaRange;pub use evaluate::EvalGrid;pub use evaluate::EvaluateParams;pub use parity::ParityMode;pub use summarize::Summary;
Modules§
- accumulate
- Per-image evaluation → precision/recall/scores arrays.
- boundary_
parity - Pinned numerical constants for the boundary-IoU subsystem.
- breakdown
- Generalized Breakdown axis — value-typed slice descriptor that replaces the hardcoded COCO area ranges (ADR-0016, proposed).
- dataset
- Dataset abstraction and the COCO ground-truth implementation.
- distributed
- Instance-paradigm body for the partial wire format and merge orchestration (ADR-0031, generalized in ADR-0032).
- error
- Typed errors for the evaluator.
- evaluate
- Per-image evaluation orchestrator.
- lvis_
parity - Pinned numerical constants for the LVIS evaluation subsystem.
- matching
- Greedy GT × DT matching over a precomputed similarity matrix.
- parity
- Parity-mode flag and pinned numerical constants.
- segmentation
- COCO
segmentationfield deserialization and normalization. - similarity
- Similarity computation between ground-truth and detection annotations.
- stream
- Streaming evaluator (ADR-0013).
- summarize
- Twelve-stat detection summary atop
crate::Accumulated. - tables
- Result tables — opt-in DataFrame-shaped views over the locked spine (per ADR-0019).
- tide
- TIDE error decomposition (Bolya et al., 2020).
Constants§
- VERSION
- Library version string. Useful for parity tracing in fixtures and for debugging mismatches between Rust and Python sides of the FFI boundary.
Functions§
- dump_
bbox_ iou_ histogram_ csv - Stage-0 instrumentation hook for the bbox-IoU optimization plan.