Skip to main content

Crate vernier_core

Crate vernier_core 

Source
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 segmentation field 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.