STATE — Replogle (X_hvg)

State Transition (ST) models using X_hvg inputs on Replogle. This repository contains 4 fewshot and 4 zeroshot canonical models, with their saved configurations, loading files and available CellEval v1 outputs.

Paired representation · All 36 canonical models · STATE code and setup

Model index

One row is one trained model. Additional saved checkpoints are snapshots of that run, not additional models. Fewshot uses the original best.ckpt; the replaced zeroshot bundles use final.ckpt.

X_hvg versus X_state

Representation comparison

Values are equal-weight means of context means, using paired perturbations with finite values for both models. DE-count Spearman is computed across perturbations within each context. The tables and figure use the same 4 contexts in both regimes.

Fewshot

Metric X_hvg X_state
AUPRC 0.3085 0.2393
Pearson delta 0.4132 0.3659
DE-count Spearman 0.7601 0.7354
DE overlap at N 0.2294 0.1775
LFC Spearman 0.4551 0.4175
PDS L1 0.7504 0.7302

Zeroshot

Metric X_hvg X_state
AUPRC 0.2702 0.3104
Pearson delta 0.1747 0.3508
DE-count Spearman 0.6367 0.7088
DE overlap at N 0.2277 0.1460
LFC Spearman 0.1490 0.3257
PDS L1 0.6449 0.6454

Across the three dataset comparisons, the zeroshot reruns favor X_state on AUPRC, Pearson delta and DE-count Spearman. Fewshot results are closer for Tahoe and Parse; Replogle fewshot favors X_hvg. The advantage is metric-dependent: zeroshot Replogle overlap is lower with X_state, and zeroshot Tahoe/Parse LFC Spearman is lower.

These are descriptive comparisons of saved experiments, not a controlled estimate of representation effects across regimes. The original fewshot and rerun zeroshot recipes differ. All selected zeroshot runs trained for 120k steps; Tahoe uses the 768-width, sample-batch pair. For example, the original Tahoe fewshot horizons were 200k (X_hvg) and 80k (X_state). See each run’s unchanged config.yaml for architecture, batching and training settings.

Full precision: paired context scores, all available contexts, same-context summary. The reproduction script downloads only the pinned per-perturbation CSVs listed with SHA256 hashes in model_index.json. These are saved CellEval v1 scores, not CellEval2 rescoring.

Download and use

Download one complete run to retain its checkpoint, vocabulary maps, gene ordering and config. The command below excludes the large saved generations. Remove the exclusion to include adata_pred.h5ad and adata_real.h5ad.

hf download arcinstitute/ST-HVG-Replogle \
  --revision bf681c8247bd63c12611434ad16f1fdf42b69d4d \
  --include "zeroshot/hepg2/*" \
  --exclude "*.h5ad" --local-dir ./state-model

Install the STATE package and prepare matching input features (X_hvg), gene order, perturbation labels and context metadata. Configs retain their original training-time filesystem paths; provide a TOML with paths to your local data and the intended split rather than relying on those absolute paths.

state tx predict \
  --output-dir ./state-model/zeroshot/hepg2 \
  --checkpoint final.ckpt --toml /path/to/local-data-split.toml

For a retained fewshot run, use its directory and --checkpoint best.ckpt. Saved CSVs and generations can be inspected without rerunning prediction. The refresh preserves the saved evaluation outputs; it does not claim numerical parity from a different software version.

Collection and provenance

Dataset X_hvg X_state Canonical models
Parse ST-HVG-Parse ST-SE-Parse 16
Replogle ST-HVG-Replogle ST-SE-Replogle 16
Tahoe ST-HVG-Tahoe ST-SE-Tahoe 4

Updated 2026-11-12: 18 zeroshot bundles replaced across the collection, 18 fewshot models retained, and Plasmablast removed from the default branches. Complete selected rerun bundles include checkpoints, configs, loading files, training logs, CellEval CSVs, PR arrays and predicted/real H5ADs. Previous artifacts remain available under the revision tag before-zeroshot-refresh-20261112; historical revisions are not part of the canonical 36-model index.

Use is governed by the model license and acceptable use policy.

Downloads last month

-

Downloads are not tracked for this model. How to track
Inference Providers NEW
This model isn't deployed by any Inference Provider. 🙋 Ask for provider support

Space using arcinstitute/ST-HVG-Replogle 1

Collection including arcinstitute/ST-HVG-Replogle