Upload wiflow-v1/MODEL_CARD.md with huggingface_hub
Browse files- wiflow-v1/MODEL_CARD.md +31 -0
wiflow-v1/MODEL_CARD.md
ADDED
|
@@ -0,0 +1,31 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# WiFlow v1 — WiFi CSI Pose Estimation Model
|
| 2 |
+
|
| 3 |
+
Camera-supervised WiFlow pose model trained on real ESP32 CSI + MediaPipe ground truth.
|
| 4 |
+
|
| 5 |
+
## Metrics
|
| 6 |
+
- **PCK@20: 92.9%** (17 COCO keypoints)
|
| 7 |
+
- Eval loss: 0.082
|
| 8 |
+
- Bone constraint loss: 0.008
|
| 9 |
+
- Parameters: 186,946 (974 KB)
|
| 10 |
+
|
| 11 |
+
## Architecture
|
| 12 |
+
- TCN: 2 dilated causal conv blocks (k=3, d=[1,2])
|
| 13 |
+
- Input: 35 subcarriers x 20 time steps (ruvector-solver reduced from 70)
|
| 14 |
+
- Output: 17 COCO keypoints [x, y] in [0, 1]
|
| 15 |
+
- Scale: lite (189K params)
|
| 16 |
+
|
| 17 |
+
## Training
|
| 18 |
+
- 345 paired samples (5 min capture)
|
| 19 |
+
- ESP32-S3 CSI: 7,000 frames at 23fps
|
| 20 |
+
- Mac camera: 6,470 frames at 22fps via MediaPipe PoseLandmarker
|
| 21 |
+
- 50 epochs (33 supervised + 17 refinement)
|
| 22 |
+
- ruvector optimizations: O6 subcarrier selection, O7 attention, O8 Stoer-Wagner min-cut, O9 multi-SPSA
|
| 23 |
+
|
| 24 |
+
## Usage
|
| 25 |
+
```javascript
|
| 26 |
+
const model = JSON.parse(fs.readFileSync('wiflow-v1.json'));
|
| 27 |
+
// Load into WiFlowSupervisedModel and call forward(csiInput)
|
| 28 |
+
```
|
| 29 |
+
|
| 30 |
+
## License
|
| 31 |
+
Apache-2.0
|