Mick228 commited on
Commit
8198722
·
verified ·
1 Parent(s): e80889c

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 -37
  2. labelforge_model.json +8 -6
README.md CHANGED
@@ -6,11 +6,13 @@ tags:
6
  - labelforge-base-model
7
  - facemap
8
  - pose-estimation
9
- - mouse
10
  - side-view
 
11
  - pupil
12
  - eye
13
- - 2p
 
14
  ---
15
 
16
  # SideView_Pupil_2P_v1
@@ -19,18 +21,21 @@ tags:
19
 
20
  | | |
21
  |---|---|
22
- | View | Side View |
 
 
23
  | Target | Pupil |
24
  | Variant | 2P |
25
  | Version | v1 |
26
  | Status | final |
27
  | Backend | Facemap |
28
  | Keypoints | 12 |
29
- | Source model | `Pupil_2P_v3_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,35 +51,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 mode | finetune |
56
- | Training frames | 43 |
57
- | Epochs | 80 |
58
- | Batch size | 1 |
59
- | Learning rate | 0.0001 |
60
- | Image size (H x W) | 1024x1280 |
61
-
62
- General Facemap 12-keypoint trainer. NEW mode starts from the original Facemap pretrained network with fresh 12-keypoint heads. FINE-TUNE mode loads and verifies an existing 12-keypoint model before continuing training. Partially labeled frames are retained. Invisible, unset, missing, or invalid individual keypoints are stored as NaN and masked by Facemap during training.
63
-
64
- ## Use in LabelForge
65
-
66
- Download the model from LabelForge's **Model Library**, or select `SideView_Pupil_2P_v1.pt` directly. `labelforge_model.json` sets the version, keypoint groups, colours and locked keypoint order automatically.
67
-
68
- To fetch it from Python:
69
-
70
- ```python
71
- from huggingface_hub import snapshot_download
72
- path = snapshot_download("MusallLab/LabelForge-SideView_Pupil_2P_v1")
73
- ```
74
-
75
- ## Files
76
-
77
- - `SideView_Pupil_2P_v1.pt`: Facemap model weights
78
- - `labelforge_model.json`: LabelForge metadata (keypoint schema, version)
79
- - `labels.csv`, `keypoints.txt`: keypoint order
80
- - `training_model_info.json`: training statistics
 
6
  - labelforge-base-model
7
  - facemap
8
  - pose-estimation
9
+ - 2photon
10
  - side-view
11
+ - mouse
12
  - pupil
13
  - eye
14
+ - nose
15
+ - mouth
16
  ---
17
 
18
  # SideView_Pupil_2P_v1
 
21
 
22
  | | |
23
  |---|---|
24
+ | Recording | 2Photon |
25
+ | View | Side view |
26
+ | Subject | Mouse |
27
  | Target | Pupil |
28
  | Variant | 2P |
29
  | Version | v1 |
30
  | Status | final |
31
  | Backend | Facemap |
32
  | Keypoints | 12 |
33
+ | Created by | Mick Daubenfeld |
34
 
35
  ## Keypoints
36
 
37
+ Listed in model-output order. **Do not reorder them**; groups, colours and
38
+ shortcuts can be changed in LabelForge without affecting the model.
39
 
40
  | # | Keypoint | Group |
41
  |---|---|---|
 
51
  | 10 | `nose_bottom` | Nose |
52
  | 11 | `mouth` | Mouth |
53
  | 12 | `lowerlip` | Mouth |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
labelforge_model.json CHANGED
@@ -7,7 +7,6 @@
7
  "version": 1,
8
  "backend": "facemap",
9
  "model_path": "SideView_Pupil_2P_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.824818Z",
104
  "imported_external_model": true,
105
  "status": "final",
106
  "purpose": "2P side-view eye and pupil tracking",
107
- "original_model_path": "\\\\NASKAMPA\\lts\\Team\\Mick\\FM_Side_View\\Pupil_Model\\2P_Finetune\\Current_Model\\Pupil_2P_v3_12kp.pt",
108
- "source_model_name": "Pupil_2P_v3_12kp"
109
- }
 
 
 
 
 
 
7
  "version": 1,
8
  "backend": "facemap",
9
  "model_path": "SideView_Pupil_2P_v1.pt",
 
10
  "keypoint_schema": {
11
  "locked": true,
12
  "groups": [
 
96
  }
97
  ]
98
  },
 
 
99
  "training_settings": {},
100
  "created_at": "2026-08-26T15:36:38.824818Z",
101
  "imported_external_model": true,
102
  "status": "final",
103
  "purpose": "2P side-view eye and pupil tracking",
104
+ "source_model_name": "Pupil_2P_v3_12kp",
105
+ "descriptors": {
106
+ "recording": "2photon",
107
+ "view": "side",
108
+ "subject": "mouse"
109
+ },
110
+ "author": "Mick Daubenfeld"
111
+ }