Mick228 commited on
Commit
946f684
·
verified ·
1 Parent(s): f2e8521

Publish FrontView_FaceTongue_General_v1

Browse files
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
+ }