Mick228 commited on
Commit
6bf498f
·
verified ·
1 Parent(s): 30d21dd

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

Browse files
Files changed (2) hide show
  1. README.md +10 -35
  2. labelforge_model.json +8 -6
README.md CHANGED
@@ -6,10 +6,13 @@ tags:
6
  - labelforge-base-model
7
  - facemap
8
  - pose-estimation
9
- - mouse
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
- | View | Side View |
 
 
23
  | Target | Pupil |
24
  | Variant | General |
25
  | Version | v1 |
26
  | Status | final |
27
  | Backend | Facemap |
28
  | Keypoints | 12 |
29
- | Source model | `Pupil_Base_v4_12kp` |
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
  |---|---|---|
@@ -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
- "original_model_path": "\\\\NASKAMPA\\lts\\Team\\Mick\\FM_Side_View\\Pupil_Model\\Current_Model\\Pupil_Base_v4_12kp.pt",
108
- "source_model_name": "Pupil_Base_v4_12kp"
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
+ }