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)
| File | Size | Uploaded | |
|---|---|---|---|
| scouter_learn-0.1.10.tar.gz | 14.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|