ArcInstitute/state

State is a machine learning model that predicts cellular perturbation response across diverse contexts

What it solves

State provides a framework for predicting how cells respond to perturbations (such as genetic changes) across different biological contexts. It allows researchers to model cellular state transitions and create high-dimensional embeddings of cellular data to better understand biological responses.

How it works

The project implements two primary model types:

  1. State Transition (ST) Models: These models are trained to predict the outcome of a perturbation. The workflow involves preprocessing raw cellular data (normalizing counts and selecting highly variable genes), training the model using specific dataset configurations, and then performing inference or evaluation on new data.
  2. State Embedding (SE) Models: These models are pretrained to create embeddings of cells. The process involves building a data profile, fitting the embedding model, and transforming new datasets into embedding space. These embeddings can be stored in a vector database (like LanceDB) for similarity queries.

Who it’s for

It is designed for computational biologists and researchers working with single-cell data who need to predict genetic perturbation effects or annotate new datasets using pretrained cellular embeddings.

Highlights

  • Perturbation Prediction: Ability to train models that predict cellular responses to genetic perturbations.
  • Embedding Generation: Tools to pretrain and apply cell embedding models for dataset annotation.
  • Vector Database Integration: Optional support for LanceDB to store and query cellular embeddings.
  • Flexible Configuration: Uses Hydra and TOML files to manage complex dataset splits, including zero-shot and few-shot scenarios.

Related

  • Dispatch
  • Project
  • Project
  • Project
  • Dispatch