Convert landmark list to COCO 17-keypoint body schema

Use This When

• Standardizing pose landmarks from various models to COCO body keypoint format
• Building pose analysis pipelines that require consistent 17-point body representation
• Interfacing with downstream components expecting named COCO landmark fields
• Preparing pose data for visualization or analytics using COCO convention

What It Does

• Converts ordered landmark list to structured COCO Human17 format with named fields
• Maps 17 keypoints to COCO schema: nose, eyes, ears, shoulders, elbows, wrists, hips, knees, ankles
• Validates minimum landmark count and fails if fewer than 17 landmarks provided
• Returns typed Landmarks2d.Human17 structure for downstream components requiring COCO format

Works Best With

• detect-landmarks → this component → pose-based analytics expecting COCO schema
• Pose estimation → this component → filter-pose-bbox or calculate-landmark-angle
• Integration with visualize-landmarks for COCO-standard skeleton rendering
• Feeding pose-aware components that rely on named keypoint access

Caveats

• Requires exactly 17 or more landmarks; fails with fewer even if partial pose acceptable
• No validation that landmark semantics match COCO ordering; assumes correct input sequence
• Confidence scores preserved but not validated; downstream must check confidence if needed
• Additional landmarks beyond 17 ignored; use only first 17 points in order