Skip to content

Commit 2cf9507

Browse files
committed
README: fix Usage block to match published headline + new tester defaults
- Step 3: loss._lambda=1.5 -> loss._lambda=1, the lambda used for the paper's Table 2/3 results (and the lambda whose joint .ckpt is now published in WEIGHT_FILES as ninja_desc_<base_desc>_joint). - Evaluation: drop the stale epoch=21 step=13749 example (which pointed at an internal eq_lr/2021-07-16_run1 path that no longer applies). The default invocation now relies on lemurianet_module.py's auto- download of the published joint checkpoint when padesc_checkpoint.base_dir is null. Custom-run example uses padesc_checkpoint.epoch=last instead.
1 parent ad65801 commit 2cf9507

1 file changed

Lines changed: 10 additions & 4 deletions

File tree

README.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -98,18 +98,24 @@ python -m ninjadesc.pa_desc.tools.recon_trainer \
9898

9999
```bash
100100
python -m ninjadesc.pa_desc.tools.trainer \
101-
profiler=simple trainer.max_epochs=300 trainer.gpus=4 loss._lambda=1.5
101+
profiler=simple trainer.max_epochs=300 trainer.gpus=4 loss._lambda=1
102102
```
103103

104-
`loss._lambda` is the privacy parameter that trades off matching utility against image-reconstruction concealment.
104+
`loss._lambda` is the privacy parameter that trades off matching utility against image-reconstruction concealment. The paper's headline numbers (Table 2/3) are at `loss._lambda=1`.
105105

106-
**Evaluation** on MegaDepth:
106+
**Evaluation** on MegaDepth — by default the tester auto-downloads the published joint-training checkpoint for the chosen `base_desc` (`ninja_desc_<base_desc>_joint.ckpt`) when `padesc_checkpoint.base_dir` is left null:
107+
108+
```bash
109+
python -m ninjadesc.pa_desc.tools.tester base_desc=sosnet
110+
```
111+
112+
To evaluate your own joint-training run instead, point at its checkpoint directory:
107113

108114
```bash
109115
python -m ninjadesc.pa_desc.tools.tester \
110116
base_desc=sosnet \
111117
padesc_checkpoint.base_dir=${NINJADESC_OUTPUT_ROOT}/pa_desc_joint/<run> \
112-
padesc_checkpoint.epoch=21 padesc_checkpoint.step=13749
118+
padesc_checkpoint.epoch=last
113119
```
114120

115121
## Repository layout

0 commit comments

Comments
 (0)