Skip to content

hcmlab/hpo-mesh-annotator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 

Repository files navigation

HPO-Mesh-Annotator

Plotly HPO Bootstrap

Interactive 3D face mesh annotation tool for Human Phenotype Ontology (HPO) facial phenotyping.

🚀 Quick Start

  1. Open in any modern browser
  2. Annotate points by clicking (blue=selected, gray=unselected)
  3. Navigate steps with Next/Previous or arrow keys
  4. Export face-mesh-selections-YYYY-MM-DD.json

📊 HPO Steps

Step HPO Term
1 Abnormality of the mouth
2 Abnormality of the orbital region
3 Abnormality of the nose
4 Abnormality of the eye
5 Abnormality of facial soft tissue
6 Abnormal midface morphology
7 Abnormal forehead morphology
8 Abnormal facial shape
9 Abnormality of the periorbital region
10 Abnormality of the chin
11 Abnormal facial expression
12 Craniofacial hyperostosis

💾 Sample JSON Output


{
  "version": "1.0.0",
  "generated": "2025-12-05T23:14:29.239Z",
  "annotations": [
    {
      "id": "HP:0000153",
      "description": "Abnormality of the mouth",
      "points": []
    },
    {
      "id": "HP:0000315",
      "description": "Abnormality of the orbital region",
      "points": []
    }
  ]
}

🔍 Use Cases

  • Craniofacial phenotyping for research
  • Rare disease classification training data generation
  • Medical AI datasets for facial landmark annotation
  • HPO validation of MediaPipe face mesh points

📱 Controls

  • Click points to toggle selection
  • Ctrl/Cmd + Drag to pan
  • Scroll to zoom
  • ← → arrows navigate steps
  • Reset All clears every step
  • Export JSON downloads selections

🎨 Customization

Edit STEPS in source:


const STEPS = {
        "HP:XXXXXXX": "HPO description text goes here",
        "FINAL": "Congrats! You are done!", // Keep this one
    };


Star if useful for HPO facial phenotyping!

About

Precision tool for root level facial HPO phenotype mapping on 3D face meshes with step-wise selection.

Resources

License

Stars

Watchers

Forks

Languages