Opal logo

Opal Norman

Observed-single expression reference for the Norman CRISPRa assay

Opal v1.0.0 Prediction endpoint CC BY 4.0 model and reference content Source-specific scope

Quick start 路 Evaluation 路 Limitations 路 Provenance

Research preprint 路 Source code 路 The Tiny Intelligence Lab

Opal Norman is a historical residual-kernel expression reference for the Norman K562 CRISPRa assay. It combines measured single-perturbation effects with a fitted symmetric pair correction and returns a population-mean expression-effect vector in the stored gene order.

Model and inputs

Use exact supported gene symbols in context K562/CRISPRa/Norman2019. Effects use the checkpoint's log2 scale. The example uses AHR and KLF1. Unknown interventions, same-target pairs and mismatched supplied gene order are rejected.

Quick start

Use Python 3.11-3.14; the local verification used Python 3.14.0. Install CPU Torch first if required, followed by the pinned source and dependencies:

python -m pip install "torch==2.9.1" --index-url https://download.pytorch.org/whl/cpu
python -m pip install -r requirements.txt
python verify_files.py
python example.py

The requirements pin the exact Opal code revision. The source repository and v1.0.0 release are public. No model training runs during installation or prediction. These checkpoints use Opal's custom loaders, not transformers.AutoModel.

example.py checks the original manifest hash, loads the files in this repository, runs a supported pair query and verifies symmetry and finite output. A successful example is an inference smoke check, not a new biological evaluation.

Evaluation

This repository distributes a historical source-specific reference checkpoint. Packaging verifies original file hashes, successful inference, finite outputs, output gene order and pair-order symmetry. It performs no new fitting, hyperparameter selection or biological scoring. See verification.json for the local preparation checks.

These checks do not establish accuracy on a new study. The six-task growth benchmark belongs to a different endpoint and must not be attributed to this expression checkpoint. Opal's retained expression-composition comparisons include negative outcomes against selected simple references; the broader release also retains failed frozen external transfer and failed promotion criteria. The linked paper and scientific findings preserve the original scope.

Limitations

Population-mean effects do not reproduce cell-level distributions or identify causal molecular mechanisms. This model requires measured source-local single references; it is not a general cold-intervention or arbitrary-context predictor. Reliability and uncertainty diagnostics are exploratory, with no calibrated biological coverage guarantee. No clinical-use validation, biological discovery claim or frontier-level superiority is established.

Provenance and license

The source is scPerturb v1.1, Zenodo record 7278143, file NormanWeissman2019_filtered.h5ad: https://zenodo.org/records/7278143 . Credit the scPerturb creators listed in that deposit and Norman et al., Exploring genetic interaction manifolds constructed from rich single-cell phenotypes, Science (2019). Original source: https://doi.org/10.1126/science.aax4438 .

The deposited collection is CC BY 4.0. Opal aggregates retained cells into matched population means and fits a residual model. These are adaptations; fitted/reference content is distributed under CC BY 4.0 with attribution. The original manifest records the supported context, training/benchmark pair identities, gene order and file hashes. No raw single-cell dataset is included.

LICENSE contains CC BY 4.0. Original Opal software and the inference example use MIT terms in CODE_LICENSE.txt; that software license does not replace the model/reference license.

Reproducibility and citation

  • Original manifest SHA-256: b7ecce11de745bf3d89807a2dbcf97073512d2d05fb44090ec92310b95d75456.
  • Opal source release: v1.0.0.
  • Original model files and their hashes: provenance.json.
  • Full folder checksums: SHA256SUMS.txt.
  • Scientific methods and negative findings: research findings and preprint.
  • Citation metadata: CITATION.cff. Cite the source study/dataset as well as Opal.

Prepared by The Tiny Intelligence Lab. Original checkpoint and manifest bytes are preserved; no new model training or biological evaluation was performed during packaging.

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