Release 2026-10-17

Models

The models in this release, what each requires, how it generates and what it writes.

Current service input policy

Input preparation update — the model release is unchanged The historical model snapshot below describes the original engine input contract. Current service policy platform-zero-pad-v1 reports missing common and panel genes and prepares absent rows as zero before calling that engine. This is a zero-expression assumption, not a recovered measurement or an accuracy guarantee.

Submit the full available raw matrix. Each model retains its fixed 2,000-gene panel and fixed common axis; no HVGs are reselected. Stage1 keeps its common-axis normalization formula, with absent rows assumed zero. PBE and BCS normalize on the fixed panel. Incomplete inputs can change predictions relative to complete measurements.

Identifiers must remain unique and compatible after supported preparation. NaN, infinity, negative values, and non-positive common or panel library sums are refused. Blank numeric CSV cells are interpreted as zero. Results expose the applied policy and missing-gene counts in metadata.input_preparation; older results may have no preparation record.

The user-facing expression view follows platform-observed-panel-v1: it returns only genes present in the original input after supported identifier mapping that also belong to the fixed output panel. Input rows with observed zero counts are retained. A panel gene absent from the input is excluded from this view even if the model generated a nonzero value. Genes outside the model panel are not generated.

Internal zero-padding and fixed-panel inference are unchanged. Original model outputs are preserved; partial panel coverage adds separate input-observed NPZ and H5AD files selected by the default result pointers. Full panel coverage uses the originals without extra files. metadata.output_projection distinguishes model and returned gene counts, excluded genes, and the returned-axis hash. Historical results are not rewritten.

Read the current input guide and the common-axis and fixed-panel API.

Model release

This page documents immutable model release iclr27-pbe-bcs-main-20261016, built from the ICLR 2027 submission method: PBE, the patient-bulk encoder — a generator conditioned on each sample's own bulk profile — followed by BCS, a bulk-consistency correction of the generated expression. Each model is trained against one single-cell reference and generates on a fixed 2,000-gene panel chosen at training time — the cohort's disease-prior genes first, then highly variable genes (HVGs) until the panel is full — and never re-selected at inference.

ModelPublic idCell typesRequired genesReference
Breast tumourbreast-tumour-2k-v21116,864GEO GSE176078
T-ALLt-all-2k-v21055,719ScPCA SCPCP000003
Sepsis PBMCsepsis-pbmc-2k-v11040,200GEO GSE279448 and GSE279452
Record the release_id. Every job records the release it ran against, as release_id and model_id. Results are comparable across jobs that share both and not otherwise — the cell-type axis and the input requirement both belong to the release, and a replacement release changes them beneath the same product name.

Breast tumour

Breast tumour, bulk-conditioned single-cell generation (GSE176078 reference)

Cell-type composition and 1,000 generated single cells per sample for bulk breast tumour RNA-seq.

Public id (disease_model)breast-tumour-2k-v2
model_idiclr27-pbe-bcs-GSE176078
release_idiclr27-pbe-bcs-main-20261016
ReferenceHuman breast tumour single-cell reference — GEO GSE176078
Required input16,864 genes, every one present exactly once · raw counts · identifiers exactly as the list spells them (HGNC symbols)
Generation1,000 cells per sample · dopri5, 20 steps · seed 20260904 (fixed per release)
MethodPBE+BCS — generator A1_simple_bulk, correction BCS (legacy E01 consistent_cp10k)
11 CELL TYPES
  • B-cells
  • Cancer Epithelial
  • Cycling T-cells
  • Endothelial
  • Fibroblast
  • Myeloid
  • NK
  • Normal Epithelial
  • PVL
  • Plasmablasts
  • T cells
Applies toHuman breast tumour tissue, bulk RNA-seq of the whole tumour including its microenvironment, raw counts.
Not applicable toBlood, normal breast, other tumour types, cell lines or non-human samples.
Validation. Research model from the ICLR 2027 submission. Verified for output contract and fleet reproducibility; biological validity of generated cells is not claimed.

T-ALL

T-cell acute lymphoblastic leukaemia, bulk-conditioned single-cell generation (ScPCA SCPCP000003 reference)

Cell-type composition and 1,000 generated single cells per sample for bulk T-ALL RNA-seq.

Public id (disease_model)t-all-2k-v2
model_idiclr27-pbe-bcs-SCPCP000003
release_idiclr27-pbe-bcs-main-20261016
ReferenceHuman T-ALL single-cell reference — ScPCA SCPCP000003
Required input55,719 genes, every one present exactly once · raw counts · identifiers exactly as the list spells them (17,475 Ensembl ids (ENSG…) and 38,244 HGNC symbols)
Generation1,000 cells per sample · dopri5, 20 steps · seed 20260904 (fixed per release)
MethodPBE+BCS — generator A1_simple_bulk, correction BCS (legacy E01 consistent_cp10k)
10 CELL TYPES
  • ALL blast
  • B
  • Classical Monocyte
  • Cytotoxic T
  • DC
  • Erythroid
  • FCGR3A+ Monocyte
  • HSC
  • NKT
  • naive/Tcm
Applies toHuman T-ALL bone marrow or peripheral blood, bulk RNA-seq, raw counts.
Not applicable toSolid tissue, other leukaemias, cell lines or non-human samples.
Validation. Research model from the ICLR 2027 submission. Verified for output contract and fleet reproducibility; biological validity of generated cells is not claimed.

Sepsis PBMC

Sepsis peripheral blood mononuclear cells, bulk-conditioned single-cell generation (GSE279448/GSE279452 reference)

Cell-type composition and 1,000 generated single cells per sample for bulk sepsis PBMC RNA-seq.

Public id (disease_model)sepsis-pbmc-2k-v1
model_idiclr27-pbe-bcs-GSE279448_GSE279452_sepsis_PBMC
release_idiclr27-pbe-bcs-main-20261016
ReferenceHuman sepsis PBMC single-cell reference — GEO GSE279448 and GSE279452
Required input40,200 genes, every one present exactly once · raw counts · identifiers exactly as the list spells them (11,253 Ensembl ids (ENSG…) and 28,947 HGNC symbols)
Generation1,000 cells per sample · dopri5, 20 steps · seed 20260904 (fixed per release)
MethodPBE+BCS — generator H03, correction BCS (legacy E01 consistent_cp10k)
10 CELL TYPES
  • T_cell
  • Monocyte
  • B_cell
  • NK_cell
  • Erythroid
  • Platelet
  • Plasma
  • Neutrophil
  • DC
  • HSPC
Applies toHuman PBMC from sepsis cohorts, bulk RNA-seq, raw counts.
Not applicable toWhole blood with granulocytes, solid tissue, cell lines or non-human samples. The reference is PBMC, so neutrophil-rich whole blood will be described against an axis that under-represents it.
Validation. Research model from the ICLR 2027 submission. Verified for output contract and fleet reproducibility; biological validity of generated cells is not claimed. New tissue in this release; no prior model to compare against.

Required input

The requirement is exact, and it is per model: the complete set of genes the reference cohort and the training data had in common, each present exactly once, as raw counts, under the identifier the list spells for it. The engine normalises over that whole set (log1p CP10k) before it selects the 2,000-gene panel, so a missing gene or a duplicate identifier is an error — not a zero, and not a lower coverage figure.

ModelRequired genesIdentifiers in the listRequired gene list
Breast tumour16,864HGNC symbolsGET /b2sc/models/breast-tumour-2k-v2/required-genes
T-ALL55,71917,475 Ensembl ids (ENSG…) and 38,244 HGNC symbolsGET /b2sc/models/t-all-2k-v2/required-genes
Sepsis PBMC40,20011,253 Ensembl ids (ENSG…) and 28,947 HGNC symbolsGET /b2sc/models/sepsis-pbmc-2k-v1/required-genes
  • Raw counts only. The model normalises for itself, so a matrix that is already CPM, TPM, FPKM, log-scaled or z-scored is the wrong input, not a lesser one — and the non-negative forms produce confident, wrong proportions rather than an error.
  • Identifiers exactly as the list spells them. The lists are not symbols-only: the T-ALL and Sepsis PBMC lists mix HGNC symbols and Ensembl ids (ENSG…) gene by gene, as the reference data spelled them, and the breast list is HGNC symbols throughout. Your gene column is matched verbatim against the downloadable list — nothing is converted on the way in. gene_id_type other than symbol answers 400 GENE_IDS_MUST_BE_SYMBOLS, because a conversion would hide the exact mismatch the check exists to show; re-label the file to the list instead.
  • Every required gene present exactly once. The new-run page fetches the list once per model and checks your file against it before uploading anything, reporting how many are missing and the first of them; a file that fails is refused there, with the engine's own rule stated.
  • Extra genes are not an error. The engine takes the required set from your matrix and leaves the rest.
There is no coverage percentage. The earlier generation accepted a file once it matched a fraction of the panel. This one does not: the count in the table is the whole requirement, and the API publishes it per model as input_gene_contract.required_genes, with the list itself at input_gene_contract.required_genes_url.

Generation and seeds

Every model in this release generates 1,000 cells per sample, allocated across its cell types by the estimated proportions (largest-remainder allocation, stable cell-type order for ties), and integrates the flow with the dopri5 solver over 20 steps in batches of 2,048. Generation is sample-major, then cell-type-major, with direct bulk conditioning throughout.

ModelCells per sampleSolverStepsSeeds
Breast tumour1,000dopri52020260904, fixed for the release; weights for 20260905 and 20260906 are shipped but not selectable yet
T-ALL1,000dopri52020260904, fixed for the release; weights for 20260905 and 20260906 are shipped but not selectable yet
Sepsis PBMC1,000dopri52020260904, fixed for the release; weights for 20260905 and 20260906 are shipped but not selectable yet

A job runs on one seed and records it. There is no seed parameter on the API or in the UI: every run uses the release's default seed, and the two other seeds are shipped weight sets that are not selectable yet. With the same seed, device class, solver, batch size and library versions the output is bitwise identical — measured on this platform as a same-GPU repeat for the breast and T-ALL models. Equality across different GPU generations is not promised; the run_manifest names the device and versions the job actually used.

Outputs

A completed job writes seven files directly under its result prefix. There is no analysis stage for any model in this release: the proportions and the generated cells are the complete result, and the job list, results page and GET /b2sc/jobs/{id}/files all read from the same manifest.

FileWhat it holds
platform_manifest.jsonThe index of the result. Names every other file, and carries release_id, model_id, seed, n_cells_per_sample, n_samples, the cell-type axis, the engine code version and image digest, the input sha256 and expression_semantics.
proportions.csvOne row per sample (sample_id), one column per cell type, the estimated proportion of each to six decimal places. Each row sums to 1 within rounding — the values are written to six decimal places, so a row can total 0.999999 or 1.000001.
cell_counts.csvThe same table as integer cell counts — how many of the generated cells per sample were allocated to each type (largest-remainder allocation, stable cell-type order for ties).
generated_cells.h5adThe generated single cells as an AnnData file: obs carries sample_id and cell_type; var is the model's 2,000-gene panel; X is continuous BCS-corrected generated expression; not measured or integer counts.
generated_cells.npzThe same expression matrix and axes as compressed NumPy arrays, for readers without an AnnData stack.
run_manifest.jsonThe engine's own record of the run (schema b2sc.iclr27-inference/v1): solver, steps, batch size, seed, device and library versions, the sha256 of every checkpoint it loaded, and the per-sample proportions and allocations it computed.
verification.jsonThe engine's self-check of the output contract — shapes, finite non-negative expression, unique axes, allocation totals, checkpoint load, output hashes. PASS or the job does not complete.
Expression semantics. The generated expression is continuous BCS-corrected generated expression; not measured or integer counts. It is not log1p CP10k either. Treat generated_cells.h5ad as a sample from a generative model conditioned on your bulk profile, not as a measurement, and do not feed it to a tool that assumes integer counts.

Release history

This reference describes the models currently served by this release. Read the Model changelog for dated release notes and compatibility changes, and the API reference for endpoints.

Retired model ids breast-tumour-2k, breast-tumour-5k and t-all-2k are refused for new submissions. The API returns INVALID_MODEL with the currently available ids.

Research Use Only. Not a medical device and not cleared or approved by any regulator. Every output is a computational prediction, not a clinical finding, and must not be used to diagnose, treat, or decide the care of any patient without independent clinical review.