Struct CocoAnnotation 

pub struct CocoAnnotation {
    pub id: AnnId,
    pub image_id: ImageId,
    pub category_id: CategoryId,
    pub area: f64,
    pub is_crowd: bool,
    pub ignore_flag: Option<bool>,
    pub bbox: Bbox,
    pub segmentation: Option<Segmentation>,
    pub keypoints: Option<Vec<f64>>,
    pub num_keypoints: Option<u32>,
}

A COCO annotation as stored on the dataset side (ground truth).

Detection annotations follow a separate path — see the future loadRes-equivalent — because their iscrowd is always 0 (quirk E2) and their area is auto-derived (quirk J3). Conflating the two would let a DT bug silently corrupt GT semantics.

Fields

id: AnnId

Annotation id (preserved verbatim from JSON).

image_id: ImageId

Image this annotation belongs to.

category_id: CategoryId

Category this annotation belongs to.

area: f64

Pixel area as recorded in JSON. For GT, COCO stores this directly; we trust the field.

is_crowd: bool

Crowd flag (the COCO iscrowd field). pycocotools coerces this to bool via truthiness, so 0/1 ints round-trip identically.

ignore_flag: Option<bool>

Optional explicit ignore flag.

None means the JSON had no ignore field. pycocotools (quirk D1) silently overwrites whatever was here with is_crowd; vernier preserves it and lets Self::effective_ignore resolve the strict vs corrected disposition at eval time.

bbox: Bbox

Bounding box. Required for every COCO ground-truth annotation (even keypoint-only annotations carry a bbox; the bbox is what J3 derives DT-area from). Phase 3 adds keypoints as an additional optional field.

segmentation: Option<Segmentation>

COCO segmentation field, in any of the three shapes pycocotools accepts (multi-polygon, uncompressed RLE, compressed RLE). None for keypoint-only annotations or fixtures that omit it. The matching engine normalizes via Segmentation::to_rle at eval time.

keypoints: Option<Vec<f64>>

Flat keypoint triplets [x_1, y_1, v_1, x_2, y_2, v_2, ...] (per ADR-0012). None for non-keypoint annotations; the eval pipeline raises EvalError::InvalidAnnotation when a GT is missing keypoints under iouType="keypoints".

num_keypoints: Option<u32>

COCO num_keypoints count of visible keypoints (v > 0), per ADR-0012. pycocotools precomputes this on GT (driving the quirk D2 implicit-ignore branch); on DT it is not required and is derived from keypoints when needed.

Implementations

impl CocoAnnotation

pub fn effective_ignore(&self, mode: ParityMode) -> bool

Resolves the effective ignore flag for this annotation under a given parity mode (per ADR-0002 / quirk D1).

• Strict reproduces pycocotools: the user’s ignore field is discarded, and ignore is set to is_crowd.
• Corrected honors the user’s explicit ignore field when present; falls back to is_crowd when absent.

Trait Implementations

impl Annotation for CocoAnnotation

fn image_id(&self) -> ImageId

Image this annotation belongs to.

fn category_id(&self) -> CategoryId

Category this annotation belongs to.

fn area(&self) -> f64

Pixel area.

fn is_crowd(&self) -> bool

Crowd flag (raw, before parity resolution).

fn effective_ignore(&self, mode: ParityMode) -> bool

Effective ignore flag under the given parity mode.

impl Clone for CocoAnnotation

fn clone(&self) -> CocoAnnotation

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CocoAnnotation

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CocoAnnotation

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CocoAnnotation

fn eq(&self, other: &CocoAnnotation) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CocoAnnotation

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CocoAnnotation