Yin Jun Phua commited on
Commit
2d21c89
·
verified ·
1 Parent(s): cb5013a

docs: record sha256 for checkpoint_n50_unconstrained_best.pt and add retrain provenance note

Browse files
Files changed (1) hide show
  1. README.md +25 -9
README.md CHANGED
@@ -21,16 +21,15 @@ regulatory rules from perturbation-state transition data, with
21
  support-conditional uniqueness certificates and active experiment
22
  planning. This repo hosts the paper's released checkpoints. The public
23
  code lives in a companion package (`able-public`); see the
24
- [reproducibility README](https://github.com/) for install and
25
- reproduction commands.
26
 
27
  ## Contents
28
 
29
- | File | Size | SHA-256 | Purpose |
30
  |---|---:|---|---|
31
- | `checkpoint_n50_ncf_best.pt` | ~24 MB | `57c968490a2f1535582cc009fc38f659b6fe4b56f89bf72c9bcfb285640a0c8d` | Main 50-variable NCF-pointer proposer. Used for BBM (Table 2, Figs. 2/3/4/6), Ablation A (Table 9 row), and all default evaluation commands in the public README. |
32
- | `checkpoint_n15_ncf_best.pt` | ~24 MB | `26cdef1bb4bfb39fbb4c278d2f40528c1328664a80c22c97ee99a901fe4a34f0` | 15-variable NCF-pointer proposer used for Table 1 (four curated biological networks). |
33
- | `checkpoint_n50_unconstrained_best.pt` | ~24 MB | *(to be added)* | Ablation B: 50-variable NCF-free decoder variant (unconstrained truth-table head), used only for Appendix Table 9 / Ablation B. |
34
 
35
  All three are plain PyTorch state dicts saved via
36
  `torch.save({"model_state_dict": ..., "optimizer_state_dict": ...,
@@ -52,13 +51,30 @@ All three are plain PyTorch state dicts saved via
52
  Exact configs are embedded in each `.pt` under the `"config"` key, and
53
  are also committed alongside the public training scripts.
54
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
55
  ## Intended use
56
 
57
  - Reproduction of the ICML-2026 AI4Science paper numbers. The companion
58
  CLI `able-download-checkpoints` consumes this repo.
59
- - Research extensions on k-junta Boolean-network recovery from perturbation
60
- transitions (neuro-symbolic, active-learning, and certificate-style
61
- work).
62
 
63
  ## Limitations
64
 
 
21
  support-conditional uniqueness certificates and active experiment
22
  planning. This repo hosts the paper's released checkpoints. The public
23
  code lives in a companion package (`able-public`); see the
24
+ reproducibility README there for install and reproduction commands.
 
25
 
26
  ## Contents
27
 
28
+ | File | Size (bytes) | SHA-256 | Purpose |
29
  |---|---:|---|---|
30
+ | `checkpoint_n50_ncf_best.pt` | 24,097,458 | `57c968490a2f1535582cc009fc38f659b6fe4b56f89bf72c9bcfb285640a0c8d` | Main 50-variable NCF-pointer proposer. Used for BBM (Table 2, Figs. 2/3/4/6), Ablation A (Table 9 row), and all default evaluation commands in the public README. |
31
+ | `checkpoint_n15_ncf_best.pt` | 23,965,466 | `26cdef1bb4bfb39fbb4c278d2f40528c1328664a80c22c97ee99a901fe4a34f0` | 15-variable NCF-pointer proposer used for Table 1 (four curated biological networks). |
32
+ | `checkpoint_n50_unconstrained_best.pt` | 25,312,058 | `03510ef826edce9a53cfa87049abf77cd17ea564e87ef4f06167d19e5b952f83` | Ablation B: 50-variable NCF-free decoder variant (unconstrained truth-table head), used only for Appendix Table 9 / Ablation B. See provenance note below. |
33
 
34
  All three are plain PyTorch state dicts saved via
35
  `torch.save({"model_state_dict": ..., "optimizer_state_dict": ...,
 
51
  Exact configs are embedded in each `.pt` under the `"config"` key, and
52
  are also committed alongside the public training scripts.
53
 
54
+ ## Provenance note for `checkpoint_n50_unconstrained_best.pt`
55
+
56
+ The original post-paper checkpoint for the Ablation B (`unconstrained`)
57
+ variant was unrecoverable at release time. The file in this repo is a
58
+ **retrain** produced from the same committed training script and
59
+ configuration (seed 42, same `DEFAULT_CONFIG`). It reproduces the
60
+ paper's expected ablation regime on the synthetic held-out eval
61
+ (`transition_acc` bouncing in `[0.014, 0.022]`, `tt_bit_acc ~= 0.836`,
62
+ `regulator_set_f1 ~= 0.60`, `functional_agreement ~= 0.92`) but will
63
+ **not be byte-identical** to the artifact that originally produced the
64
+ paper's Appendix Table 9 / Ablation B numbers, because synthetic data
65
+ streaming is sensitive to dataloader-order PRNG draws. Downstream BBM
66
+ Lift-Cert numbers are expected to be statistically equivalent but
67
+ may differ within run-to-run noise. If bit-exact reproduction of the
68
+ paper table is required, rerun the Lift-Cert pipeline against this
69
+ checkpoint and report the refreshed numbers.
70
+
71
  ## Intended use
72
 
73
  - Reproduction of the ICML-2026 AI4Science paper numbers. The companion
74
  CLI `able-download-checkpoints` consumes this repo.
75
+ - Research extensions on k-junta Boolean-network recovery from
76
+ perturbation transitions (neuro-symbolic, active-learning, and
77
+ certificate-style work).
78
 
79
  ## Limitations
80