Phips commited on
Commit
279aa3b
Β·
verified Β·
1 Parent(s): 55e8d2e

rewrite Why section: academic tone, trainer motivation, community credit

Browse files
Files changed (1) hide show
  1. README.md +33 -18
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 many SR networks already. Here's the honest case for NERVE β€” and when
45
- to pick something else.
46
-
47
- **One-line pitch:** a ~1.8M-param, pure-conv SR net that trains with plain
48
- `train.py`, exports to dynamic ONNX on the first try, and converts to ncnn β€”
49
- with no fusion step, no variants, no custom ops.
50
-
51
- **Why it's worth your time:**
52
- - **One file, one variant.** The architecture is a single readable file and the
53
- model is one size. No S/M/L matrix, no fused-vs-unfused checkpoints, nothing
54
- to fuse before deploy β€” **what you train is what you ship.**
 
 
 
 
 
 
 
 
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, so it fits
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:** if you want maximum PSNR/LPIPS on academic
68
- benchmarks, or a big transformer, NERVE isn't trying to win that β€” use HEART.
69
- NERVE wins on *simplicity, deployability and hassle-free training*.
 
 
 
 
 
 
 
 
 
 
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