Add model details (recording, view, subject) and author; remove an internal path; refresh tags
Browse files- README.md +10 -35
- labelforge_model.json +8 -6
README.md
CHANGED
|
@@ -6,10 +6,13 @@ tags:
|
|
| 6 |
- labelforge-base-model
|
| 7 |
- facemap
|
| 8 |
- pose-estimation
|
| 9 |
-
-
|
| 10 |
- side-view
|
|
|
|
| 11 |
- pupil
|
| 12 |
- eye
|
|
|
|
|
|
|
| 13 |
- general
|
| 14 |
---
|
| 15 |
|
|
@@ -19,18 +22,21 @@ General side-view eye and pupil tracking. A LabelForge base model from the Musal
|
|
| 19 |
|
| 20 |
| | |
|
| 21 |
|---|---|
|
| 22 |
-
|
|
|
|
|
|
|
|
| 23 |
| Target | Pupil |
|
| 24 |
| Variant | General |
|
| 25 |
| Version | v1 |
|
| 26 |
| Status | final |
|
| 27 |
| Backend | Facemap |
|
| 28 |
| Keypoints | 12 |
|
| 29 |
-
|
|
| 30 |
|
| 31 |
## Keypoints
|
| 32 |
|
| 33 |
-
Listed in model-output order. **Do not reorder them**; groups, colours and
|
|
|
|
| 34 |
|
| 35 |
| # | Keypoint | Group |
|
| 36 |
|---|---|---|
|
|
@@ -46,34 +52,3 @@ Listed in model-output order. **Do not reorder them**; groups, colours and short
|
|
| 46 |
| 10 | `nose_bottom` | Nose |
|
| 47 |
| 11 | `mouth` | Mouth |
|
| 48 |
| 12 | `lowerlip` | Mouth |
|
| 49 |
-
|
| 50 |
-
## Training
|
| 51 |
-
|
| 52 |
-
| | |
|
| 53 |
-
|---|---|
|
| 54 |
-
| Facemap version | 1.0.8 |
|
| 55 |
-
| Training frames | 195 |
|
| 56 |
-
| Epochs | 80 |
|
| 57 |
-
| Batch size | 1 |
|
| 58 |
-
| Learning rate | 0.0001 |
|
| 59 |
-
| Image size (H x W) | 1024x1280 |
|
| 60 |
-
|
| 61 |
-
Dedicated Sideview Pupil Base V4 model trained on Round_01, Round_02, Round_03 and Round_04. Facemap Conv2_1x1 conv0/conv1/conv2 were replaced with 12-output heatmap heads before training. Only frames with all 12 keypoints visible were used.
|
| 62 |
-
|
| 63 |
-
## Use in LabelForge
|
| 64 |
-
|
| 65 |
-
Download the model from LabelForge's **Model Library**, or select `SideView_Pupil_General_v1.pt` directly. `labelforge_model.json` sets the version, keypoint groups, colours and locked keypoint order automatically.
|
| 66 |
-
|
| 67 |
-
To fetch it from Python:
|
| 68 |
-
|
| 69 |
-
```python
|
| 70 |
-
from huggingface_hub import snapshot_download
|
| 71 |
-
path = snapshot_download("MusallLab/LabelForge-SideView_Pupil_General_v1")
|
| 72 |
-
```
|
| 73 |
-
|
| 74 |
-
## Files
|
| 75 |
-
|
| 76 |
-
- `SideView_Pupil_General_v1.pt`: Facemap model weights
|
| 77 |
-
- `labelforge_model.json`: LabelForge metadata (keypoint schema, version)
|
| 78 |
-
- `labels.csv`, `keypoints.txt`: keypoint order
|
| 79 |
-
- `training_model_info.json`: training statistics
|
|
|
|
| 6 |
- labelforge-base-model
|
| 7 |
- facemap
|
| 8 |
- pose-estimation
|
| 9 |
+
- widefield
|
| 10 |
- side-view
|
| 11 |
+
- mouse
|
| 12 |
- pupil
|
| 13 |
- eye
|
| 14 |
+
- nose
|
| 15 |
+
- mouth
|
| 16 |
- general
|
| 17 |
---
|
| 18 |
|
|
|
|
| 22 |
|
| 23 |
| | |
|
| 24 |
|---|---|
|
| 25 |
+
| Recording | Widefield |
|
| 26 |
+
| View | Side view |
|
| 27 |
+
| Subject | Mouse |
|
| 28 |
| Target | Pupil |
|
| 29 |
| Variant | General |
|
| 30 |
| Version | v1 |
|
| 31 |
| Status | final |
|
| 32 |
| Backend | Facemap |
|
| 33 |
| Keypoints | 12 |
|
| 34 |
+
| Created by | Mick Daubenfeld |
|
| 35 |
|
| 36 |
## Keypoints
|
| 37 |
|
| 38 |
+
Listed in model-output order. **Do not reorder them**; groups, colours and
|
| 39 |
+
shortcuts can be changed in LabelForge without affecting the model.
|
| 40 |
|
| 41 |
| # | Keypoint | Group |
|
| 42 |
|---|---|---|
|
|
|
|
| 52 |
| 10 | `nose_bottom` | Nose |
|
| 53 |
| 11 | `mouth` | Mouth |
|
| 54 |
| 12 | `lowerlip` | Mouth |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
labelforge_model.json
CHANGED
|
@@ -7,7 +7,6 @@
|
|
| 7 |
"version": 1,
|
| 8 |
"backend": "facemap",
|
| 9 |
"model_path": "SideView_Pupil_General_v1.pt",
|
| 10 |
-
"parent_model": null,
|
| 11 |
"keypoint_schema": {
|
| 12 |
"locked": true,
|
| 13 |
"groups": [
|
|
@@ -97,13 +96,16 @@
|
|
| 97 |
}
|
| 98 |
]
|
| 99 |
},
|
| 100 |
-
"training_dataset": null,
|
| 101 |
-
"keypoint_source": "labels.csv",
|
| 102 |
"training_settings": {},
|
| 103 |
"created_at": "2026-08-26T15:36:38.2440255Z",
|
| 104 |
"imported_external_model": true,
|
| 105 |
"status": "final",
|
| 106 |
"purpose": "General side-view eye and pupil tracking",
|
| 107 |
-
"
|
| 108 |
-
"
|
| 109 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 7 |
"version": 1,
|
| 8 |
"backend": "facemap",
|
| 9 |
"model_path": "SideView_Pupil_General_v1.pt",
|
|
|
|
| 10 |
"keypoint_schema": {
|
| 11 |
"locked": true,
|
| 12 |
"groups": [
|
|
|
|
| 96 |
}
|
| 97 |
]
|
| 98 |
},
|
|
|
|
|
|
|
| 99 |
"training_settings": {},
|
| 100 |
"created_at": "2026-08-26T15:36:38.2440255Z",
|
| 101 |
"imported_external_model": true,
|
| 102 |
"status": "final",
|
| 103 |
"purpose": "General side-view eye and pupil tracking",
|
| 104 |
+
"source_model_name": "Pupil_Base_v4_12kp",
|
| 105 |
+
"descriptors": {
|
| 106 |
+
"recording": "widefield",
|
| 107 |
+
"view": "side",
|
| 108 |
+
"subject": "mouse"
|
| 109 |
+
},
|
| 110 |
+
"author": "Mick Daubenfeld"
|
| 111 |
+
}
|