Download experiments/README.md from Angione-Lab/Shape2Force: direct link, hf CLI and curl.
- Browser
- Download file 3.16 kB
-
https://huggingface.co/Angione-Lab/Shape2Force/resolve/main/experiments/README.md
- Command line
-
hf download hf://Angione-Lab/Shape2Force/experiments/README.md
-
curl -L -o README.md https://huggingface.co/Angione-Lab/Shape2Force/resolve/main/experiments/README.md
Baselines and ablations
Code for the evaluation of the released checkpoints and for the baseline and ablation models. Run every command from the repository root; a GPU is used when available.
experiments/
layout.py paths and split-manifest helpers
manifest_data.py data loader driven by a split manifest
ablation_models.py U-Net and S2F generator variants
losses.py reconstruction losses
configs.py training protocol and variants
train.py train one variant
evaluate.py evaluate checkpoints and trained runs on all manifests
run_all.py run the steps in order
splits/ split manifests
results/eval/ evaluation tables
Data
The image pairs are available on Zenodo (doi: 10.5281/zenodo.18457879). Place them in dataset/ or set
S2F_DATASET_ROOT. Each manifest in splits/ lists one sample per row (folder relative to the dataset root,
condition, Young's modulus, pixel-size setting, colour-scale limit and substrate setting):
alltune_train(280) andalltune_val(81): single-cell training and validation sets;test_fibro_*: independent single-cell test sets;spheroid_train(129) andspheroid_val(28).
Usage
python -m experiments.run_all --steps eval_released
python -m experiments.run_all --steps train,eval_runs --variants s2f_no_substrate,unet_no_substrate --seeds 0,1
python -m experiments.train --variant unet --seed 0
Runs are written to experiments/runs/<variant>_seed<seed>/ and resume when restarted. Add
--epochs 1 --max-batches 2 for a quick test.
Training protocol
All variants use the training and validation sets above, batch size 2, 1024 × 1024 px, the augmentations of
data/augmentations.py and Adam (β1 = 0.5, β2 = 0.999) with a cosine schedule and 10 % warm-up per phase.
| phase | epochs | reconstruction loss | other terms | lr |
|---|---|---|---|---|
| 1 | 100 | 100 × weighted MSE + soft Dice | 1 × adversarial | 1e-4 |
| 2 | 40 | 10 × RME | 1 × adversarial, 100 × traction-stress consistency | 1e-5 |
Phase 2 starts from the best phase-1 generator. In each phase the checkpoint with the lowest validation loss is kept; the final model is the best phase-2 checkpoint.
Variants reported in the paper
| model | variant |
|---|---|
| U-Net | unet_no_substrate |
| pix2pix | unet_gan_no_substrate |
| S2F | s2f_no_substrate |
| S2F (+ substrate) | s2f_staged |
| without multi-scale input module | s2f_no_substrate_no_multiscale |
| without bottleneck context and attention modules | s2f_no_substrate_bridge_plain |
| without attention gates | s2f_no_substrate_no_attention_gates |
| without discriminator | s2f_no_substrate_no_gan |
| without traction-stress consistency loss | s2f_staged_no_force |
The input-free baseline (average training map) is evaluated with python -m experiments.evaluate --meanmap.
Other variants are listed in configs.py.
Outputs
evaluate.py computes per-image MSE, MS-SSIM, pixel-wise Pearson r, RME and mean traction stress (Pa), and writes
results/eval/per_image.csv, summary.csv and model_params.csv.