mlboydaisuke commited on
Commit
94ec2f5
·
verified ·
1 Parent(s): ee7e27a

Upload README.md with huggingface_hub

Browse files
Files changed (1) hide show
  1. README.md +50 -0
README.md ADDED
@@ -0,0 +1,50 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: mit
3
+ tags:
4
+ - executorch
5
+ - xnnpack
6
+ - pte
7
+ - on-device
8
+ - image-classification
9
+ - head-pose-estimation
10
+ ---
11
+ # sixdrepnet_headpose — ExecuTorch XNNPACK
12
+
13
+ - **Source**: thohemp/6DRepNet + osanseviero/6DRepNet_300W_LP_AFLW2000 weights
14
+ - **License**: MIT
15
+ - **Input**: [[1, 3, 224, 224]] — RGB, ImageNet norm, 224x224 face crop
16
+ - **Output**: 6D rotation representation [1,6]. To a rotation matrix: b1 = normalize(v[0:3]); b2 = normalize(v[3:6] - (b1·v[3:6])b1); b3 = cross(b1, b2); R = [b1 b2 b3]. Euler angles follow from R.
17
+
18
+ ## Variants
19
+
20
+ All variants take and return fp32 tensors — swap the `.pte` file, keep your app code.
21
+
22
+ | precision | file | size (MB) | parity vs fp32 eager (worst corr) | Mac median (ms)* |
23
+ |-----------|------|-----------|------------------------------------|------------------|
24
+ | fp32 | `sixdrepnet_headpose_xnnpack_fp32.pte` | 157.3 | 1.000000 | 7.6 |
25
+
26
+ \*Mac arm64, single process, median of 10 — a reference point for relative cost
27
+ only, not a device number (torch eager fp32 on the same machine: 16.3 ms).
28
+
29
+ ### Precisions that did not earn a slot
30
+
31
+ - **fp16 is not shipped**: it comes out at 100% of the fp32 file (157.3 MB vs 157.3 MB), so it buys nothing. XNNPACK serializes convolution weights as fp32 no matter what dtype the graph carries, so on a conv-heavy model fp16 saves no disk and only adds cast operations. Reach for int8 here, not fp16.
32
+ - **int8 is not shipped**: worst-output corr 0.815 against fp32 eager, below the 0.95 bar for this precision. The file converts and runs; the numbers do not hold up, so it is left out rather than shipped with a warning.
33
+
34
+ ## Verification (executorch 1.4.0, torch 2.13.0)
35
+
36
+ Parity is measured against the fp32 eager model on real image input; `corr` is
37
+ the correlation over all elements of each output tensor.
38
+
39
+ | output | shape | max_abs_diff | corr |
40
+ |--------|-------|--------------|------|
41
+ | 0 | [1, 6] | 8.643e-07 | 1.000000 |
42
+
43
+ XNNPACK delegate coverage (fp32): 100.0% (59/59 ops)
44
+
45
+ ## Conversion
46
+
47
+ torch.export -> to_edge_transform_and_lower(XnnpackPartitioner) -> .pte
48
+ (conversion scripts: [executorch-models](https://github.com/john-rocky/executorch-models))
49
+
50
+ **Notes (int8)**: int8 is measured but not shipped. Correlation is a weak read on a six-element output, so the check that matters is the angle between the fp32 and int8 rotations: median 46.5 deg over ten faces, worst 104 deg. That is the known failure mode of re-parameterized RepVGG under post-training quantization — its fused branches leave weight ranges too wide for an int8 grid — and it needs quantization-aware training rather than anything on the export side.