Skip to main content

A DEep-learning and SIngle-cell based DEconvolution method for solid tumors

Project description

DeSide: Cellular Deconvolution of Bulk RNA-seq

PyPI version Install with pip MIT

What is DeSide?

DeSide is a DEep-learning and SIngle-cell based DEconvolution method for solid tumors, which can be used to infer cellular proportions of different cell types from bulk RNA-seq data.

DeSide consists of the following four parts (see figure below):

  • DNN Model
  • Single Cell Dataset Integration
  • Cell Proportion Generation
  • Bulk Tumor Synthesis
Overview of DeSide

In this repository, we provide the code for implementing these four parts and visualizing the results.

Requirements

DeSide requires Python 3.8 or higher. It has been tested on Linux and MacOS, but should work on Windows as well.

  • tensorflow>=2.11.1
  • scikit-learn==0.24.2
  • anndata>=0.8.0
  • scanpy==1.8.0
  • umap-learn==0.5.1
  • pandas==1.5.3
  • numpy>=1.22
  • matplotlib
  • seaborn>=0.11.2
  • bbknn==1.5.1
  • SciencePlots
  • matplotlib<3.7

Installation

pip should work out of the box:

# creating a virtual environment is recommended
conda create -n deside python=3.8
conda activate deside
# update pip
python3 -m pip install --upgrade pip
# install deside
pip install deside

Usage Examples

Usage examples can be found: DeSide_mini_example

Three examples are provided:

  • Using pre-trained model
  • Training a model from scratch
  • Generating a synthetic dataset

Documentation

For all detailed documentation, please check https://deside.readthedocs.io/. The documentation will demonstrate the usage of DeSide from the following aspects:

  • Installation in a virtual environment
  • Usage examples
  • Datasets used in DeSide
  • Functions and classes in DeSide

License

DeSide can be used under the terms of the MIT License.

Contact

Any questions or suggestions about DeSide are welcomed! Please report it on issues, or contact Xin Xiong (onlybelter@outlook.com) or Xuefei Li (xuefei.li@siat.ac.cn).

Manuscript

@article {Xiong2023.05.11.540466,
	author = {Xin Xiong and Yerong Liu and Dandan Pu and Zhu Yang and Zedong Bi and Liang Tian and Xuefei Li},
	title = {DeSide: A unified deep learning approach for cellular decomposition of bulk tumors based on limited scRNA-seq data},
	elocation-id = {2023.05.11.540466},
	year = {2023},
	doi = {10.1101/2023.05.11.540466},
	URL = {https://www.biorxiv.org/content/early/2023/05/14/2023.05.11.540466},
	eprint = {https://www.biorxiv.org/content/early/2023/05/14/2023.05.11.540466.full.pdf},
	journal = {bioRxiv}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

DeSide-1.2.2.tar.gz (152.4 kB view hashes)

Uploaded Source

Built Distribution

DeSide-1.2.2-py3-none-any.whl (98.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page