Mick228 commited on
Commit
7abfbd0
·
verified ·
1 Parent(s): 3fb6a03

Add model details (recording, view, subject) and author; remove an internal path; refresh tags

Browse files
Files changed (2) hide show
  1. README.md +11 -36
  2. labelforge_model.json +8 -6
README.md CHANGED
@@ -6,10 +6,14 @@ tags:
6
  - labelforge-base-model
7
  - facemap
8
  - pose-estimation
9
- - mouse
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
- | 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
  |---|---|---|
@@ -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
- "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
- }
 
 
 
 
 
 
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
+ }