Publish FrontView_FaceTongue_General_v1
Browse files- FrontView_FaceTongue_General_v1.pt +3 -0
- README.md +75 -0
- keypoints.txt +7 -0
- labelforge_model.json +84 -0
- labels.csv +1 -0
- training_model_info.json +52 -0
FrontView_FaceTongue_General_v1.pt
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:e6421f6fd2f0768eb0989feb886d98d60e8c71cc7e43d6665965099b146d36be
|
| 3 |
+
size 8628373
|
README.md
ADDED
|
@@ -0,0 +1,75 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
library_name: facemap
|
| 3 |
+
pipeline_tag: keypoint-detection
|
| 4 |
+
tags:
|
| 5 |
+
- labelforge
|
| 6 |
+
- labelforge-base-model
|
| 7 |
+
- facemap
|
| 8 |
+
- pose-estimation
|
| 9 |
+
- mouse
|
| 10 |
+
- front-view
|
| 11 |
+
- face
|
| 12 |
+
- tongue
|
| 13 |
+
- general
|
| 14 |
+
---
|
| 15 |
+
|
| 16 |
+
# FrontView_FaceTongue_General_v1
|
| 17 |
+
|
| 18 |
+
General front-view face and tongue tracking. A LabelForge base model from the Musall Lab.
|
| 19 |
+
|
| 20 |
+
| | |
|
| 21 |
+
|---|---|
|
| 22 |
+
| View | Front View |
|
| 23 |
+
| Target | Face + Tongue |
|
| 24 |
+
| Variant | General |
|
| 25 |
+
| Version | v1 |
|
| 26 |
+
| Status | final |
|
| 27 |
+
| Backend | Facemap |
|
| 28 |
+
| Keypoints | 7 |
|
| 29 |
+
| Source model | `Frontview_Base_v4_7kp_Tongue230` |
|
| 30 |
+
|
| 31 |
+
## Keypoints
|
| 32 |
+
|
| 33 |
+
Listed in model-output order. **Do not reorder them**; groups, colours and shortcuts can be changed in LabelForge without affecting the model.
|
| 34 |
+
|
| 35 |
+
| # | Keypoint | Group |
|
| 36 |
+
|---|---|---|
|
| 37 |
+
| 1 | `nose_tip` | Nose |
|
| 38 |
+
| 2 | `nose_bottom` | Nose |
|
| 39 |
+
| 3 | `mouth` | Mouth |
|
| 40 |
+
| 4 | `lowerlip` | Mouth |
|
| 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
|
keypoints.txt
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
nose_tip
|
| 2 |
+
nose_bottom
|
| 3 |
+
mouth
|
| 4 |
+
lowerlip
|
| 5 |
+
whiskerpad_left
|
| 6 |
+
whiskerpad_right
|
| 7 |
+
tongue_tip
|
labelforge_model.json
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"schema_version": 1,
|
| 3 |
+
"model_name": "FrontView_FaceTongue_General_v1",
|
| 4 |
+
"model_family": "FrontView_FaceTongue_General",
|
| 5 |
+
"display_name": "Face + Tongue",
|
| 6 |
+
"variant": "General",
|
| 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": [
|
| 14 |
+
{
|
| 15 |
+
"name": "Nose",
|
| 16 |
+
"palette": "Orange",
|
| 17 |
+
"keypoints": [
|
| 18 |
+
{
|
| 19 |
+
"name": "nose_tip",
|
| 20 |
+
"color": "#E7A15E",
|
| 21 |
+
"shortcut": ""
|
| 22 |
+
},
|
| 23 |
+
{
|
| 24 |
+
"name": "nose_bottom",
|
| 25 |
+
"color": "#DF9550",
|
| 26 |
+
"shortcut": ""
|
| 27 |
+
}
|
| 28 |
+
]
|
| 29 |
+
},
|
| 30 |
+
{
|
| 31 |
+
"name": "Mouth",
|
| 32 |
+
"palette": "Red",
|
| 33 |
+
"keypoints": [
|
| 34 |
+
{
|
| 35 |
+
"name": "mouth",
|
| 36 |
+
"color": "#ED7A78",
|
| 37 |
+
"shortcut": ""
|
| 38 |
+
},
|
| 39 |
+
{
|
| 40 |
+
"name": "lowerlip",
|
| 41 |
+
"color": "#E86866",
|
| 42 |
+
"shortcut": ""
|
| 43 |
+
}
|
| 44 |
+
]
|
| 45 |
+
},
|
| 46 |
+
{
|
| 47 |
+
"name": "Whiskers",
|
| 48 |
+
"palette": "Purple",
|
| 49 |
+
"keypoints": [
|
| 50 |
+
{
|
| 51 |
+
"name": "whiskerpad_left",
|
| 52 |
+
"color": "#B38AE5",
|
| 53 |
+
"shortcut": ""
|
| 54 |
+
},
|
| 55 |
+
{
|
| 56 |
+
"name": "whiskerpad_right",
|
| 57 |
+
"color": "#A477DA",
|
| 58 |
+
"shortcut": ""
|
| 59 |
+
}
|
| 60 |
+
]
|
| 61 |
+
},
|
| 62 |
+
{
|
| 63 |
+
"name": "Tongue",
|
| 64 |
+
"palette": "Pink",
|
| 65 |
+
"keypoints": [
|
| 66 |
+
{
|
| 67 |
+
"name": "tongue_tip",
|
| 68 |
+
"color": "#E78BB5",
|
| 69 |
+
"shortcut": ""
|
| 70 |
+
}
|
| 71 |
+
]
|
| 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 |
+
"original_model_path": "\\\\NASKAMPA\\lts\\Team\\Mick\\FM_Front_View\\Basemodel+Tongue\\Current_Model\\Frontview_Base_v4_7kp_Tongue230.pt",
|
| 83 |
+
"source_model_name": "Frontview_Base_v4_7kp_Tongue230"
|
| 84 |
+
}
|
labels.csv
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
nose_tip_x,nose_tip_y,nose_bottom_x,nose_bottom_y,mouth_x,mouth_y,lowerlip_x,lowerlip_y,whiskerpad_left_x,whiskerpad_left_y,whiskerpad_right_x,whiskerpad_right_y,tongue_tip_x,tongue_tip_y
|
training_model_info.json
ADDED
|
@@ -0,0 +1,52 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"model_name": "Frontview_Base_v4_7kp_Tongue230",
|
| 3 |
+
"created_at": "2026-07-22T18:53:14",
|
| 4 |
+
"facemap_version_target": "1.0.8",
|
| 5 |
+
"model_type": "continued_finetuning_on_new_tongue_frames",
|
| 6 |
+
"starting_model": "\\\\NASKAMPA\\lts\\Team\\Mick\\FM_Front_View\\Basemodel\\Current_Model\\Frontview_Base_v3_7kp_KeptTongue.pt",
|
| 7 |
+
"output_model": "\\\\NASKAMPA\\lts\\Team\\Mick\\FM_Front_View\\Basemodel\\Current_Model\\Frontview_Base_v4_7kp_Tongue230.pt",
|
| 8 |
+
"keypoints": [
|
| 9 |
+
"nose_tip",
|
| 10 |
+
"nose_bottom",
|
| 11 |
+
"mouth",
|
| 12 |
+
"lowerlip",
|
| 13 |
+
"whiskerpad_left",
|
| 14 |
+
"whiskerpad_right",
|
| 15 |
+
"tongue_tip"
|
| 16 |
+
],
|
| 17 |
+
"number_of_keypoints": 7,
|
| 18 |
+
"number_of_training_images": 229,
|
| 19 |
+
"training_round": "Tongue230_7kp",
|
| 20 |
+
"visibility_counts": {
|
| 21 |
+
"nose_tip": 229,
|
| 22 |
+
"nose_bottom": 229,
|
| 23 |
+
"mouth": 229,
|
| 24 |
+
"lowerlip": 229,
|
| 25 |
+
"whiskerpad_left": 229,
|
| 26 |
+
"whiskerpad_right": 229,
|
| 27 |
+
"tongue_tip": 188
|
| 28 |
+
},
|
| 29 |
+
"image_shape": [
|
| 30 |
+
1024,
|
| 31 |
+
1280
|
| 32 |
+
],
|
| 33 |
+
"bbox": [
|
| 34 |
+
[
|
| 35 |
+
0,
|
| 36 |
+
1024,
|
| 37 |
+
0,
|
| 38 |
+
1280
|
| 39 |
+
]
|
| 40 |
+
],
|
| 41 |
+
"training_parameters": {
|
| 42 |
+
"epochs": 100,
|
| 43 |
+
"batch_size": 1,
|
| 44 |
+
"learning_rate": 5e-05,
|
| 45 |
+
"weight_decay": 0.0,
|
| 46 |
+
"random_seed": 20260722,
|
| 47 |
+
"device": "cpu"
|
| 48 |
+
},
|
| 49 |
+
"training_manifest": "\\\\NASKAMPA\\lts\\Team\\Mick\\FM_Front_View\\Basemodel\\Training_Data\\Frontview_Base_v4_7kp_Tongue230_training_manifest.csv",
|
| 50 |
+
"visibility_handling": "Invisible/unset keypoints were converted to NaN and masked.",
|
| 51 |
+
"training_note": "V4 starts from the completed V3 model and is fine-tuned only with the newly labeled Tongue230 dataset."
|
| 52 |
+
}
|