Yin Jun Phua commited on
docs: record sha256 for checkpoint_n50_unconstrained_best.pt and add retrain provenance note
Browse files
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 |
-
|
| 25 |
-
reproduction commands.
|
| 26 |
|
| 27 |
## Contents
|
| 28 |
|
| 29 |
-
| File | Size | SHA-256 | Purpose |
|
| 30 |
|---|---:|---|---|
|
| 31 |
-
| `checkpoint_n50_ncf_best.pt` |
|
| 32 |
-
| `checkpoint_n15_ncf_best.pt` |
|
| 33 |
-
| `checkpoint_n50_unconstrained_best.pt` |
|
| 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
|
| 60 |
-
transitions (neuro-symbolic, active-learning, and
|
| 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 |
|