summaryrefslogtreecommitdiff
path: root/doc/HOWTO.md
diff options
context:
space:
mode:
authorskal <pascal.massimino@gmail.com>2026-02-14 01:37:50 +0100
committerskal <pascal.massimino@gmail.com>2026-02-14 01:37:50 +0100
commitf72f404e755149e80350dc6eb34015d5e7630d44 (patch)
tree7c7d600fccaf8030a245f799b3fcd28e82161d0b /doc/HOWTO.md
parentef091948ecb9bf83b71b28cb47d529732ad54c17 (diff)
Document CNN v2 training pipeline improvements
- HOWTO.md: Document always-save-checkpoint behavior and --quiet flag - COMPLETED.md: Add milestone entry for Feb 14 CNN v2 fixes - Details: checkpoint saving, num_layers derivation, output streamlining Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Diffstat (limited to 'doc/HOWTO.md')
-rw-r--r--doc/HOWTO.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/doc/HOWTO.md b/doc/HOWTO.md
index c98f6ee..506bf0a 100644
--- a/doc/HOWTO.md
+++ b/doc/HOWTO.md
@@ -166,8 +166,11 @@ Enhanced CNN with parametric static features (7D input: RGBD + UV + sin encoding
**Defaults:** 200 epochs, 3×3 kernels, 8→4→4 channels, batch-size 16, patch-based (8×8, harris detector).
- Live progress with single-line update
+- Always saves final checkpoint (regardless of --checkpoint-every interval)
+- When multiple kernel sizes provided (e.g., 3,5,3), num_layers derived from list length
- Validates all input images on final epoch
- Exports binary weights (storage buffer architecture)
+- Streamlined output: single-line export summary, compact validation
- All parameters configurable via command-line
**Validation Only** (skip training):
@@ -207,12 +210,19 @@ Enhanced CNN with parametric static features (7D input: RGBD + UV + sin encoding
**Export Binary Weights:**
```bash
+# Verbose output (shows all layer details)
./training/export_cnn_v2_weights.py checkpoints/checkpoint_epoch_100.pth \
--output-weights workspaces/main/cnn_v2_weights.bin
+
+# Quiet mode (single-line summary)
+./training/export_cnn_v2_weights.py checkpoints/checkpoint_epoch_100.pth \
+ --output-weights workspaces/main/cnn_v2_weights.bin \
+ --quiet
```
Generates binary format: header + layer info + f16 weights (~3.2 KB for 3-layer model).
Storage buffer architecture allows dynamic layer count.
+Use `--quiet` for streamlined output in scripts (used automatically by train_cnn_v2_full.sh).
**TODO:** 8-bit quantization for 2× size reduction (~1.6 KB). Requires quantization-aware training (QAT).