| --- |
| license: mit |
| language: |
| - en |
| library_name: onnx |
| tags: |
| - face-detection |
| - centerface |
| - dynamic-input-shape |
| - rootreal |
| --- |
| |
| # CenterFace — dynamic-input-shape ONNX (RootReal-curated) |
|
|
| A **dynamic-input-shape** ONNX export of **CenterFace** (anchor-free face detection + |
| 5-point landmarks), curated by RootReal to fix [Forgejo #11856](https://git.rootreal.io/textpast/rootreal/issues/11856). |
|
|
| ## Why this exists |
|
|
| The upstream [`Star-Clouds/CenterFace`](https://github.com/Star-Clouds/CenterFace) export |
| (`centerface.onnx`, MIT) declared a **fully static** input `input.1 = [10, 3, 32, 32]` |
| (fixed batch of 10 AND fixed 32×32 spatial dims). ONNX Runtime therefore rejects any real |
| detection tensor `(1, 3, H, W)`: |
|
|
| ``` |
| INVALID_ARGUMENT: Got invalid dimensions for input: input.1 |
| index: 0 Got: 1 Expected: 10 |
| index: 2 Got: H Expected: 32 |
| index: 3 Got: W Expected: 32 |
| ``` |
|
|
| The CenterFace graph is **purely convolutional** (60 Conv / 59 BatchNormalization / |
| 42 Relu / 13 Add / 3 ConvTranspose / 1 Sigmoid — no Reshape/Flatten/Tile that could bake |
| in static shape values), so the static shape is **purely an export artifact**. This model |
| rewrites `input.1` to **`[batch(dynamic), 3, height(dynamic), width(dynamic)]`** with |
| **zero weight/node change** — the canonical equivalent of passing |
| `dynamic_axes={'input.1': {0:'batch', 2:'height', 3:'width'}}` to `torch.onnx.export`, |
| without needing PyTorch. |
|
|
| ## Provenance / reproduction |
|
|
| - **Derived from:** `Star-Clouds/CenterFace` `models/onnx/centerface.onnx` (MIT). |
| - **Upstream sha256:** `77e394b51108381b4c4f7b4baf1c64ca9f4aba73e5e803b2636419578913b5fe` |
| - **This artifact sha256:** `884bf341ce5ba95a30667f86eaa36f24d62041d9d28002eee3bb6926701924bf` |
| - **Size:** 7,532,788 bytes (362 initializers + 178 nodes, byte-identical to upstream). |
| - **Reproduce:** `infrastructure/scripts/ml/centerface-rewrite-input-shape-dynamic.py` |
| in the [RootReal repo](https://git.rootreal.io/textpast/rootreal) regenerates this file |
| byte-for-byte from the upstream MIT source. |
|
|
| ## Accuracy |
|
|
| WIDER FACE val Easy/Medium/Hard: 0.935 / 0.924 / 0.875 (unchanged from upstream — only the |
| input shape declaration differs; the trained weights are identical). |
|
|
| ## Migration note |
|
|
| Hosted under a personal namespace (`SCKEMPER/centerface-dynamic`) because the RootReal |
| Hugging Face org (`rootreal/`) was not writable at curation time. Migration target: |
| `rootreal/centerface` (pending org access). The model is a deterministic MIT derivation |
| fully reproducible from the upstream source via the committed script, so re-hosting is |
| trivial. |
|
|
