rewrite Why section: academic tone, trainer motivation, community credit
Browse files
README.md
CHANGED
|
@@ -41,32 +41,47 @@ Part of the **BODY** suite by **Philip Hofmann** β networks built to be
|
|
| 41 |
|
| 42 |
## Why NERVE?
|
| 43 |
|
| 44 |
-
There are
|
| 45 |
-
|
| 46 |
-
|
| 47 |
-
|
| 48 |
-
|
| 49 |
-
|
| 50 |
-
|
| 51 |
-
|
| 52 |
-
-
|
| 53 |
-
|
| 54 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 55 |
- **Export just works.** Dynamic-shape ONNX (verified, ORT parity ~1e-5) and a
|
| 56 |
clean ncnn conversion. Standard ops only (`Conv / Add / ReLU / DepthToSpace /
|
| 57 |
Resize`).
|
| 58 |
- **Boring, stable training.** Norm-free, bf16 AMP, no gradient clipping, a
|
| 59 |
single Charbonnier loss for the base stage.
|
| 60 |
-
- **Small and fast.** ~1.8M params β SPAN-class size but conv-only,
|
| 61 |
mobile, edge, web and game engines.
|
| 62 |
-
- **Real-world first.** Trained on a CC0 dataset with the full Real-ESRGAN OTF
|
| 63 |
-
degradation pipeline; the OTF GAN model restores degraded images, not just
|
| 64 |
-
clean bicubic downsamples.
|
| 65 |
- **Maintainable for years.** One op set, no exotic dependencies, ~90-line arch.
|
| 66 |
|
| 67 |
-
**When to pick something else
|
| 68 |
-
benchmarks, or a
|
| 69 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 70 |
|
| 71 |
---
|
| 72 |
|
|
|
|
| 41 |
|
| 42 |
## Why NERVE?
|
| 43 |
|
| 44 |
+
There are strong and established SR networks already. This is the honest case
|
| 45 |
+
for when NERVE is worth your time β and when it is not.
|
| 46 |
+
|
| 47 |
+
This project comes out of a trainer's frustration rather than a benchmark goal.
|
| 48 |
+
After training hundreds of SISR models (see
|
| 49 |
+
[Phhofm/models](https://github.com/Phhofm/models)), the recurring annoyance was
|
| 50 |
+
networks that felt like *paper* networks: they chase leaderboard metrics with
|
| 51 |
+
techniques that leave you juggling an unfused and a fused checkpoint, or whose
|
| 52 |
+
dynamic-ONNX conversion is fragile. This network is the opposite of that β built
|
| 53 |
+
so a trainer can pick it up, train it, and convert it to dynamic ONNX without
|
| 54 |
+
headaches.
|
| 55 |
+
|
| 56 |
+
**Strengths of NERVE**
|
| 57 |
+
- **Real-world usability over metric chasing.** Trained on a CC0 dataset with
|
| 58 |
+
the full Real-ESRGAN OTF degradation pipeline; the OTF GAN model restores
|
| 59 |
+
degraded images, not just clean bicubic downsamples.
|
| 60 |
+
- **One file, one variant.** A single readable architecture file and one model
|
| 61 |
+
size. No S/M/L matrix, no fused-vs-unfused checkpoints, nothing to fuse before
|
| 62 |
+
deploy β what you train is what you ship.
|
| 63 |
- **Export just works.** Dynamic-shape ONNX (verified, ORT parity ~1e-5) and a
|
| 64 |
clean ncnn conversion. Standard ops only (`Conv / Add / ReLU / DepthToSpace /
|
| 65 |
Resize`).
|
| 66 |
- **Boring, stable training.** Norm-free, bf16 AMP, no gradient clipping, a
|
| 67 |
single Charbonnier loss for the base stage.
|
| 68 |
+
- **Small and fast.** ~1.8M params β SPAN-class size but conv-only, suited to
|
| 69 |
mobile, edge, web and game engines.
|
|
|
|
|
|
|
|
|
|
| 70 |
- **Maintainable for years.** One op set, no exotic dependencies, ~90-line arch.
|
| 71 |
|
| 72 |
+
**When to pick something else.** If the goal is maximum PSNR/LPIPS on academic
|
| 73 |
+
benchmarks, or a large transformer, NERVE is not aiming there β use HEART, HAT,
|
| 74 |
+
ATD, DAT2, or one of the community networks below. NERVE aims at simplicity,
|
| 75 |
+
deployability and hassle-free training.
|
| 76 |
+
|
| 77 |
+
**Credit where it is due.** None of this exists in a vacuum. SISR has many
|
| 78 |
+
strong architectures and generous community members, for example HAT, ATD and
|
| 79 |
+
DAT2, the community network work of [umzi](https://github.com/umzi2) and
|
| 80 |
+
[Kim2091](https://github.com/Kim2091), fdat by
|
| 81 |
+
[sharekhan](https://github.com/stinkybread), and
|
| 82 |
+
[the-database](https://github.com/the-database) (traiNNer-redux, its benchmarks
|
| 83 |
+
and its models). This list is far from complete β apologies to anyone not named;
|
| 84 |
+
the SISR community has a great many people contributing a great deal.
|
| 85 |
|
| 86 |
---
|
| 87 |
|