This is a collection of utility functions for gene group activity evaluation in scanpy, both for per-cell scoring and marker-based enrichment/overrepresentation analyses. Drug2cell makes use of established methodology, and offers it in a convenient/efficient form for easy scanpy use. The package comes with a set of ChEMBL derived drug target sets, but has straightforward input formatting so it can be easily used with any gene groups of choice.
pip install drug2cell
import drug2cell as d2c
Per-cell scoring can be done via d2c.score()
, and creates a new gene group feature space object in .uns['drug2cell']
of the supplied object. The .obs
and .obsm
of the original object are copied over for ease of downstream use, like plotting or potential marker detection.
Enrichment is done with GSEA, contained within the function d2c.gsea()
. Overrepresentation analysis can be done with the hypergeometric test of d2c.hypergeometric()
. Both of those require having ran sc.tl.rank_genes_groups()
on the input object, and return one data frame per evaluated cluster with enrichment/overrepresentation results.
It's possible to provide your own gene groups as a dictionary, with the names of the groups as keys and the corresponding gene lists as the values. Pass this dictionary as the targets
argument of any of those three functions.
Please refer to the demo notebook, all of the input arguments are detailed in ReadTheDocs.
Drug2cell also features instructions on how to parse the ChEMBL database into drugs and their targets. Some additional notebooks are included. Both refer to a pre-parsed data frame of ChEMBL human targets, which can be accessed at ftp://ftp.sanger.ac.uk/pub/users/kp9/chembl_30_merged_genesymbols_humans.pkl
.
d2c.chembl
which can assist you shall you wish to filter it in a different way.If you use drug2cell in your work, please cite the paper
@article{kanemaru2023spatially,
title={Spatially resolved multiomics of human cardiac niches},
author={Kanemaru, Kazumasa and Cranley, James and Muraro, Daniele and Miranda, Antonio MA and Ho, Siew Yen and Wilbrey-Clark, Anna and Patrick Pett, Jan and Polanski, Krzysztof and Richardson, Laura and Litvinukova, Monika and others},
journal={Nature},
volume={619},
number={7971},
pages={801--810},
year={2023},
publisher={Nature Publishing Group UK London}
}