Convert landmark list to AP-10K animal 17-keypoint schema

Use This When

• Standardizing animal pose landmarks to AP-10K format for wildlife or livestock monitoring
• Building animal behavior analysis systems requiring consistent quadruped keypoint schema
• Interfacing with components expecting AP-10K animal landmark format
• Preparing animal pose data for veterinary applications or zoological research

What It Does

• Converts ordered 17-point landmark list to structured Animal17 format with named fields
• Maps animal keypoints: eyes, nose, neck, tail, shoulders, elbows, paws (front/back), hips, knees
• Validates minimum landmark count and fails if fewer than 17 landmarks provided
• Returns typed Landmarks2d.Animal17 structure for downstream animal pose analysis

Works Best With

• Animal pose detector → this component → behavior classification or movement analysis
• Wildlife monitoring → this component → species identification or health assessment
• Integration with visualize for animal skeleton overlay on video feeds
• Feeding analytics for gait analysis or lameness detection in livestock

Caveats

• Requires exactly 17 or more landmarks; fails with fewer even if partial pose acceptable
• Species morphology variation affects landmark semantics; calibrate per animal type
• Occlusion from vegetation or other animals reduces keypoint detection quality
• Paw landmarks (FPAW/BPAW) may be ambiguous in species with atypical limb structure