Add model details (recording, view, subject) and author; remove an internal path; refresh tags
Browse files- README.md +11 -36
- labelforge_model.json +8 -6
README.md
CHANGED
|
@@ -6,10 +6,14 @@ tags:
|
|
| 6 |
- labelforge-base-model
|
| 7 |
- facemap
|
| 8 |
- pose-estimation
|
| 9 |
-
-
|
| 10 |
- front-view
|
|
|
|
| 11 |
- face
|
| 12 |
- tongue
|
|
|
|
|
|
|
|
|
|
| 13 |
- general
|
| 14 |
---
|
| 15 |
|
|
@@ -19,18 +23,21 @@ General front-view face and tongue tracking. A LabelForge base model from the Mu
|
|
| 19 |
|
| 20 |
| | |
|
| 21 |
|---|---|
|
| 22 |
-
|
|
|
|
|
|
|
|
| 23 |
| Target | Face + Tongue |
|
| 24 |
| Variant | General |
|
| 25 |
| Version | v1 |
|
| 26 |
| Status | final |
|
| 27 |
| Backend | Facemap |
|
| 28 |
| Keypoints | 7 |
|
| 29 |
-
|
|
| 30 |
|
| 31 |
## Keypoints
|
| 32 |
|
| 33 |
-
Listed in model-output order. **Do not reorder them**; groups, colours and
|
|
|
|
| 34 |
|
| 35 |
| # | Keypoint | Group |
|
| 36 |
|---|---|---|
|
|
@@ -41,35 +48,3 @@ Listed in model-output order. **Do not reorder them**; groups, colours and short
|
|
| 41 |
| 5 | `whiskerpad_left` | Whiskers |
|
| 42 |
| 6 | `whiskerpad_right` | Whiskers |
|
| 43 |
| 7 | `tongue_tip` | Tongue |
|
| 44 |
-
|
| 45 |
-
## Training
|
| 46 |
-
|
| 47 |
-
| | |
|
| 48 |
-
|---|---|
|
| 49 |
-
| Facemap version | 1.0.8 |
|
| 50 |
-
| Training mode | continued_finetuning_on_new_tongue_frames |
|
| 51 |
-
| Training frames | 229 |
|
| 52 |
-
| Epochs | 100 |
|
| 53 |
-
| Batch size | 1 |
|
| 54 |
-
| Learning rate | 5e-05 |
|
| 55 |
-
| Image size (H x W) | 1024x1280 |
|
| 56 |
-
|
| 57 |
-
V4 starts from the completed V3 model and is fine-tuned only with the newly labeled Tongue230 dataset.
|
| 58 |
-
|
| 59 |
-
## Use in LabelForge
|
| 60 |
-
|
| 61 |
-
Download the model from LabelForge's **Model Library**, or select `FrontView_FaceTongue_General_v1.pt` directly. `labelforge_model.json` sets the version, keypoint groups, colours and locked keypoint order automatically.
|
| 62 |
-
|
| 63 |
-
To fetch it from Python:
|
| 64 |
-
|
| 65 |
-
```python
|
| 66 |
-
from huggingface_hub import snapshot_download
|
| 67 |
-
path = snapshot_download("MusallLab/LabelForge-FrontView_FaceTongue_General_v1")
|
| 68 |
-
```
|
| 69 |
-
|
| 70 |
-
## Files
|
| 71 |
-
|
| 72 |
-
- `FrontView_FaceTongue_General_v1.pt`: Facemap model weights
|
| 73 |
-
- `labelforge_model.json`: LabelForge metadata (keypoint schema, version)
|
| 74 |
-
- `labels.csv`, `keypoints.txt`: keypoint order
|
| 75 |
-
- `training_model_info.json`: training statistics
|
|
|
|
| 6 |
- labelforge-base-model
|
| 7 |
- facemap
|
| 8 |
- pose-estimation
|
| 9 |
+
- widefield
|
| 10 |
- front-view
|
| 11 |
+
- mouse
|
| 12 |
- face
|
| 13 |
- tongue
|
| 14 |
+
- nose
|
| 15 |
+
- mouth
|
| 16 |
+
- whiskers
|
| 17 |
- general
|
| 18 |
---
|
| 19 |
|
|
|
|
| 23 |
|
| 24 |
| | |
|
| 25 |
|---|---|
|
| 26 |
+
| Recording | Widefield |
|
| 27 |
+
| View | Front view |
|
| 28 |
+
| Subject | Mouse |
|
| 29 |
| Target | Face + Tongue |
|
| 30 |
| Variant | General |
|
| 31 |
| Version | v1 |
|
| 32 |
| Status | final |
|
| 33 |
| Backend | Facemap |
|
| 34 |
| Keypoints | 7 |
|
| 35 |
+
| Created by | Mick Daubenfeld |
|
| 36 |
|
| 37 |
## Keypoints
|
| 38 |
|
| 39 |
+
Listed in model-output order. **Do not reorder them**; groups, colours and
|
| 40 |
+
shortcuts can be changed in LabelForge without affecting the model.
|
| 41 |
|
| 42 |
| # | Keypoint | Group |
|
| 43 |
|---|---|---|
|
|
|
|
| 48 |
| 5 | `whiskerpad_left` | Whiskers |
|
| 49 |
| 6 | `whiskerpad_right` | Whiskers |
|
| 50 |
| 7 | `tongue_tip` | Tongue |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
labelforge_model.json
CHANGED
|
@@ -7,7 +7,6 @@
|
|
| 7 |
"version": 1,
|
| 8 |
"backend": "facemap",
|
| 9 |
"model_path": "FrontView_FaceTongue_General_v1.pt",
|
| 10 |
-
"parent_model": null,
|
| 11 |
"keypoint_schema": {
|
| 12 |
"locked": true,
|
| 13 |
"groups": [
|
|
@@ -72,13 +71,16 @@
|
|
| 72 |
}
|
| 73 |
]
|
| 74 |
},
|
| 75 |
-
"training_dataset": null,
|
| 76 |
-
"keypoint_source": "labels.csv",
|
| 77 |
"training_settings": {},
|
| 78 |
"created_at": "2026-08-26T15:36:35.9825892Z",
|
| 79 |
"imported_external_model": true,
|
| 80 |
"status": "final",
|
| 81 |
"purpose": "General front-view face and tongue tracking",
|
| 82 |
-
"
|
| 83 |
-
"
|
| 84 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 7 |
"version": 1,
|
| 8 |
"backend": "facemap",
|
| 9 |
"model_path": "FrontView_FaceTongue_General_v1.pt",
|
|
|
|
| 10 |
"keypoint_schema": {
|
| 11 |
"locked": true,
|
| 12 |
"groups": [
|
|
|
|
| 71 |
}
|
| 72 |
]
|
| 73 |
},
|
|
|
|
|
|
|
| 74 |
"training_settings": {},
|
| 75 |
"created_at": "2026-08-26T15:36:35.9825892Z",
|
| 76 |
"imported_external_model": true,
|
| 77 |
"status": "final",
|
| 78 |
"purpose": "General front-view face and tongue tracking",
|
| 79 |
+
"source_model_name": "Frontview_Base_v4_7kp_Tongue230",
|
| 80 |
+
"descriptors": {
|
| 81 |
+
"recording": "widefield",
|
| 82 |
+
"view": "front",
|
| 83 |
+
"subject": "mouse"
|
| 84 |
+
},
|
| 85 |
+
"author": "Mick Daubenfeld"
|
| 86 |
+
}
|