How to install GEARS with PyTorch Geometric?

First install PyG following its official documentation, then run 'pip install cell-gears'. Ensure your PyTorch version is compatible to avoid common setup errors.

Can GEARS predict effects for bulk RNA-seq data?

No, GEARS is specifically designed for single-cell RNA-sequencing data and has not been tested for bulk sequencing. It relies on the granularity of single-cell data for accurate perturbation modeling.

GEARS vs scGen for perturbation prediction?

GEARS excels at multi-gene perturbation prediction using graph networks, while scGen is more general for single-cell data generation. GEARS is better for combinatorial effects, but scGen might be more versatile for tasks like data augmentation.

How to prepare my own dataset for GEARS training?

Create a scanpy adata object with 'gene_name' in adata.var, and 'condition', 'cell_type' in adata.obs, then use the new_data_process method as shown in the API documentation for custom data integration.

Does GEARS work for cross-cell type predictions?

No, GEARS is not designed for cross-cell type transfer and assumes a consistent cellular context. The README explicitly states it cannot handle training across multiple cell types.

What are the minimum data requirements for GEARS to work well?

GEARS needs datasets with multiple perturbation types and sufficient cells per perturbation; the README warns that too few cells or perturbations may lead to poor model performance.

GEARS

MITPython

A geometric deep learning model that predicts transcriptional outcomes of single and multi-gene perturbations from single-cell RNA-seq data.

GitHub

What is GEARS?

GEARS is a geometric deep learning model that predicts transcriptional outcomes of genetic perturbations using single-cell RNA-sequencing data. It solves the challenge of anticipating how novel combinations of gene perturbations will affect gene expression patterns, which is crucial for understanding genetic interactions and identifying therapeutic targets. The model leverages graph neural networks to represent gene-gene relationships and predict expression changes.

Target Audience

Bioinformatics researchers and computational biologists working with single-cell perturbation screens who need to predict effects of multi-gene interventions. Particularly valuable for labs studying genetic interactions, functional genomics, and therapeutic target discovery.

Value Proposition

GEARS uniquely predicts outcomes for novel multi-gene perturbations by learning from existing perturbation data, unlike methods limited to single-gene predictions. Its graph-based architecture captures biological interactions more effectively than traditional approaches, providing more accurate forecasts of combinatorial genetic effects.

Overview

GEARS is a geometric deep learning model that predicts outcomes of novel multi-gene perturbations

Use Cases

Best For

Related Projects

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

379 stars84 forks0 contributors

Predicting transcriptional responses to novel multi-gene perturbations
Analyzing single-cell RNA-seq data from genetic screens
Studying gene-gene interaction networks in functional genomics
Accelerating therapeutic target discovery through in silico perturbation
Modeling combinatorial genetic effects in cellular systems
Research labs needing to prioritize experimental perturbations

Not Ideal For

Researchers working with bulk RNA-sequencing data, as GEARS is specifically designed for single-cell datasets and has not been tested for bulk sequencing.
Projects requiring predictions across different cell types, since GEARS is not designed for cross-cell type transfer and assumes consistent cellular contexts.
When only single-gene perturbation data is available for training, as GEARS cannot reliably predict combinatorial effects without exposure to some multi-gene data.
Datasets with very few cells per perturbation or limited perturbation types, as the model may not perform well under such conditions according to the README.

Pros & Cons

Pros

Multi-Gene Prediction Capability

Forecasts transcriptional outcomes for both single and combinatorial gene perturbations, enabling researchers to predict novel multi-gene effects as shown in the API with examples like ['CBL', 'CNN1'].

Graph-Based Biological Modeling

Uses geometric deep learning with graph neural networks to capture gene-gene interaction networks, providing a more accurate representation of complex biological relationships than traditional methods.

Uncertainty Estimation

Provides confidence metrics for predictions through specialized training, as highlighted in the uncertainty tutorial, helping assess reliability in experimental prioritization.

Streamlined API Workflow

Offers a simple Python interface for training, prediction, and data processing, with clear demos and Colab notebooks that simplify adoption and reproducibility.

Cons

Limited Data Compatibility

Exclusively designed for single-cell RNA-seq data and not tested for bulk sequencing, restricting use to specific experimental setups as admitted in the README notes.

Requires Combinatorial Training Data

Must be trained on some combinatorial perturbation data to predict multi-gene outcomes, which limits applicability when only single-gene datasets are available.

Complex Dependency Setup

Installation depends on PyG (PyTorch Geometric), which can have compatibility issues and a steeper learning curve compared to lighter, more straightforward libraries.

Frequently Asked Questions

Home

Computational Biology

totalVI

Deep probabilistic analysis of single-cell and spatial omics data

Stars1,650

Forks466

Last commit2 days ago

scGPT

scGPT is a foundation model designed for single-cell multi-omics data analysis using generative AI. It leverages transformer architecture pretrained on millions of single-cell profiles to enable a wide range of downstream biological tasks, advancing computational biology by providing a powerful, unified model for cellular data. ## Key Features - **Pretrained Model Zoo** — Offers multiple organ-specific and whole-human models trained on millions of cells for various applications. - **Zero-Shot Applications** — Supports tasks like cell embedding and reference mapping without task-specific training. - **Reference Mapping** — Enables fast similarity search across millions of cells using efficient indexing with faiss. - **Multi-Task Fine-Tuning** — Can be adapted for scRNA-seq integration, cell type annotation, perturbation prediction, and GRN inference. - **Online Tools** — Provides accessible web applications for reference mapping, cell annotation, and GRN inference via cloud GPUs. ## Philosophy scGPT aims to build a foundational AI model for single-cell biology, democratizing access to advanced computational methods and accelerating discoveries in multi-omics research through open-source collaboration.

Stars1,589

Forks335

Last commit2 months ago