Skip to main content

Scouter: a transcriptional response predictor for unseen genetic perturbtions with LLM embeddings

Scouter is a deep neural network with simple architecture, for the task of predicting transcriptional response to unseen genetic perturbtions.

Scouter employs the LLM embeddings generated from text description of genes, enabling the perdiction on unseen genes.

For more details read our manuscript


Installation

pip install scouter-learn

Main API

Below is an example that includes main APIs to train Scouter on a perturbation dataset.

from scouter import Scouter, ScouterData, adamson_small, embedding_small

adata = adamson_small()
embd = embedding_small()
scouterdata = ScouterData(adata=adata, embd=embd, key_label='condition', key_var_genename='gene_name')
scouterdata.setup_ad('embd_index')
scouterdata.gene_ranks()
scouterdata.get_dropout_non_zero_genes()
scouterdata.split_Train_Val_Test(seed=1)

# Model Training
scouter_model = Scouter(scouterdata)
scouter_model.model_init()
scouter_model.train()

# Prediction
scouter_model.pred(['ATP5B+ctrl', 'MANF+ctrl'])

# Evaluation
scouter_model.barplot('MANF+ctrl')

Demos

Name Description
Demo.ipynb A detailed tutorial on how to apply Scouter to a smaller version of Adamson dataset, including preprocessing, paramter setting, model training, and evaluation
OwnDataTutorial.ipynb A tutorial to guide users to load their own dataset and embedding matrix.
UnmatchRemedy.ipynb A tutorial that illustrates the problem of unmatched genes between perturbation dataset and embedding matrix, and provides a remedy.

Metadata

Release files for scouter-learn 0.1.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for scouter-learn 0.1.10
File Size Uploaded
scouter_learn-0.1.10.tar.gz 14.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for scouter-learn 0.1.10
File Interpreter ABI Platform
scouter_learn-0.1.10-py3-none-any.whl Python 3 none any Details

Total release size: 29.9 kB

Release files / scouter_learn-0.1.10.tar.gz

Download URL scouter_learn-0.1.10.tar.gz
Size 14.4 kB
Tags Source
SHA-256 checksum
How to use checksums
2dfe8bea9c7a06a4a40071161ca65fcc15d1063817b5fc115e0612a50ef530a5
BLAKE2b-256 checksum
How to use checksums
6a89fb4efc3aedfcc41b4c888ce55a1eb4066a44dbaea6e151a7b2677152ac8a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.11.0

Release files / scouter_learn-0.1.10-py3-none-any.whl

Download URL scouter_learn-0.1.10-py3-none-any.whl
Size 15.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f55168ddb024beef644ebeabe20508831d1091d320beeceeb91ee1a4901bcc07
BLAKE2b-256 checksum
How to use checksums
904fa180fde30a2cdec877b41774d117a2cd559219da5e67eefb0f7043531e62
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.11.0

Release history Release notifications | RSS feed

This release

0.1.10 This release

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page