Document ScoNet naming and Scoliosis eval configs

2026-03-08 17:34:33 +08:00
parent 295d951206
commit 4e0b0a18dc
5 changed files with 315 additions and 74 deletions
@@ -69,6 +69,26 @@ python -m torch.distributed.launch --nproc_per_node=4 \
 opengait/main.py --cfgs configs/sconet/sconet_scoliosis1k.yaml --phase test --log_to_file
 ```

+### Modality sanity check
+
+The silhouette and skeleton-map pipelines are different experiments and should not be mixed when you interpret results.
+
+* `Scoliosis1K-sil-pkl` is the silhouette modality used by the standard ScoNet configs.
+* pose-derived heatmap roots such as `Scoliosis1K_sigma_8.0/pkl` or DRF exports are skeleton-map inputs and require `in_channel: 2`.
+
+Naming note:
+
+* in this repo, the local `ScoNet` training config and model class are usually the paper's `ScoNet-MT`, not the CE-only paper `ScoNet`
+* in these docs, `ScoNet-MT-ske` means the skeleton-map variant of that same model path
+* checkpoint filenames like `ScoNet-20000-better.pt` do not identify the modality by name alone
+
+A strong silhouette checkpoint does not validate the skeleton-map path. In particular, `ckpt/ScoNet-20000-better.pt` is a silhouette checkpoint:
+
+* its first convolution expects 1-channel input
+* the matching eval config points to `Scoliosis1K-sil-pkl`
+
+So if you are debugging DRF or `ScoNet-MT-ske` reproduction, do not use `ScoNet-20000-better.pt` as evidence that the heatmap preprocessing is correct.
+
 ---

 ## Pose-to-Heatmap Conversion