{ "info": { "author": "Kevin Menden", "author_email": "kevin.menden@t-online.de", "bugtrack_url": null, "classifiers": [], "description": "![Scaden](docs/img/scaden_logo.png)\n\n## Single-cell assisted deconvolutional network\n\nScaden is a deep-learning based algorithm for cell type deconvolution of bulk RNA-seq samples. It was developed \nat the DZNE T\u00fcbingen and the ZMNH in Hamburg. \nA pre-print describing the method is available at Biorxiv:\n [Deep-learning based cell composition analysis from tissue expression profiles](https://www.biorxiv.org/content/10.1101/659227v2)\n\nA complete documentation is available [here](https://scaden.readthedocs.io)\n\n\n![Figure1](docs/img/figure1.png)\n\nScaden overview. a) Generation of artificial bulk samples with known cell type composition from scRNA-seq data. b) Training \nof Scaden model ensemble on simulated training data. c) Scaden ensemble architecture. d) A trained Scaden model can be used\nto deconvolve complex bulk mixtures.\n\n### 1. System requirements\nScaden was developed and tested on Linux (Ubuntu 16.04 and 18.04). It was not tested on Windows or Mac, but should\nalso be usable on these systems when installing with Pip or Bioconda. Scaden does not require any special\nhardware (e.g. GPU), however we recommend to have at least 16 GB of memory.\n\nScaden requires Python 3. All package dependencies should be handled automatically when installing with pip or conda.\n\n### 2. Installation guide\nThe recommended way to install Scaden is using conda and the Bioconda channel:\n\n`conda install -c bioconda scaden`\n\nInstllation with conda takes only a few minutes (2-5), depending on the internet connetion.\nAlternatively Scaden can be installed with pip:\n\n`pip install scaden`\n\nWe also provide a docker image with Scaden installed:\n[https://hub.docker.com/r/kevinmenden/scaden](https://hub.docker.com/r/kevinmenden/scaden)\n\n### 3. Demo\nWe provide several curated [training datasets](https://scaden.readthedocs.io/en/latest/datasets/) for Scaden. For this demo,\nwe will use the human PBMC training dataset, which consists of 4 different scRNA-seq datasets and 32,000 samples in total.\nYou can download it here:\n[https://figshare.com/s/e59a03885ec4c4d8153f](https://figshare.com/s/e59a03885ec4c4d8153f).\n\nFor this demo, you will also need to download some test samples to perform deconvolution on, along with their associated labels.\nYou can download the data we used for the Scaden paper here:\n[https://figshare.com/articles/Publication_Figures/8234030](https://figshare.com/articles/Publication_Figures/8234030)\n\nWe'll perform deconvolution on simulated samples from the data6k dataset. You can find the samples and labels in 'paper_data/figures/figure2/data/data6k_500_*'\nonce you have downloaded this data from the link mentioned above.\n\nThe first step is to perform preprocessing on the training data. This is done with the following command:\n\n`scaden process pbmc_data.h5ad paper_data/figures/figure2/data/data6k_500_samples.txt`\n\nThis will generate a file called 'processed.h5ad', which we will use for training. The training data\nwe have downloaded also contains samples from the data6k scRNA-seq dataset, so we have to exclude them from training\nto get a meaningfull test of Scaden's performance. The following command will train a Scaden ensemble for 5000 steps per model (recommended),\nand store it in 'scaden_model'. Data from the data6k dataset will be excluded from training. Depending on your machine, this can take about 10-20 minutes.\n\n`scaden train processed.h5ad --steps 5000 --model_dir scaden_model --train_datasets 'data8k donorA donorC'`\n\nFinally, we can perform deconvolution on the 500 simulates samples from the data6k dataset:\n\n`scaden predict paper_data/figures/figure2/data/data6k_500_samples.txt --model_dir scaden_model`\n\nThis will create a file named 'cdn_predictions.txt' (will be renamed in future version to 'scaden_predictions.txt'), which contains\nthe deconvolution results. You can now compare these predictions with the true values contained in \n'paper_data/figures/figure2/data/data6k_500_labels.txt'. This should give you the same results as we obtained in the Scaden paper\n(see Figure 2).\n\n### 4. Instructions for use\nFor a general description on how to use Scaden, please check out our [usage documentation](https://scaden.readthedocs.io/en/latest/usage/).\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/KevinMenden/scaden", "keywords": "bioinformatics,deep learning,machine learning,single cell sequencing,deconvolution", "license": "MIT License", "maintainer": "", "maintainer_email": "", "name": "scaden", "package_url": "https://pypi.org/project/scaden/", "platform": "", "project_url": "https://pypi.org/project/scaden/", "project_urls": { "Homepage": "https://github.com/KevinMenden/scaden" }, "release_url": "https://pypi.org/project/scaden/0.9.2/", "requires_dist": [ "pandas (==0.21)", "numpy (==1.14.5)", "scikit-learn", "scipy", "seaborn", "tensorflow (==1.12.1)", "matplotlib", "scanpy (==1.2.2)", "tqdm", "click" ], "requires_python": "", "summary": "Cell type deconvolution using single cell data", "version": "0.9.2" }, "last_serial": 5884981, "releases": { "0.9.0": [ { "comment_text": "", "digests": { "md5": "99e08e06c3dd1971b864ad39b2b2abed", "sha256": "da41a1dad2f7a031e9821641a6f1818838a9ccc07c198f73297a2b2de9384cd0" }, "downloads": -1, "filename": "scaden-0.9.0-py3-none-any.whl", "has_sig": false, "md5_digest": "99e08e06c3dd1971b864ad39b2b2abed", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 15251, "upload_time": "2019-04-24T13:55:07", "url": "https://files.pythonhosted.org/packages/6d/72/b744a072da9847f6a70baaa3fc421232e5d4b2153135d48e68946315c139/scaden-0.9.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "09f53cfec0211a8dbe219c7f451881c3", "sha256": "c5c3c58aa9a9c36151dcbd746445ed038fbc33e7906529a2bbff1d84dcfb7239" }, "downloads": -1, "filename": "scaden-0.9.0.tar.gz", "has_sig": false, "md5_digest": "09f53cfec0211a8dbe219c7f451881c3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12646, "upload_time": "2019-04-24T13:55:10", "url": "https://files.pythonhosted.org/packages/76/90/b125c692b364b736b7271b4ceef5fa317bc9ef9bd79c670581358382ed4b/scaden-0.9.0.tar.gz" } ], "0.9.2": [ { "comment_text": "", "digests": { "md5": "99d1344e57cf5809457b5e53d789b66e", "sha256": "f6aa4ab362a77e6e3bca9a3522a33f3da07e86fe5e6ce566b063a8e7b0b8f09d" }, "downloads": -1, "filename": "scaden-0.9.2-py3-none-any.whl", "has_sig": false, "md5_digest": "99d1344e57cf5809457b5e53d789b66e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17112, "upload_time": "2019-09-25T12:15:59", "url": "https://files.pythonhosted.org/packages/e7/8f/1953a88c323a8c1531ba43051cb70ce2f0797d109cde006ac904a88b4439/scaden-0.9.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7492dada7d71380688dc4812edafa246", "sha256": "325a3c6edafbca88860bca06fdcabd7b9c7814addf0892f372ed71846fd55bb9" }, "downloads": -1, "filename": "scaden-0.9.2.tar.gz", "has_sig": false, "md5_digest": "7492dada7d71380688dc4812edafa246", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15799, "upload_time": "2019-09-25T12:16:01", "url": "https://files.pythonhosted.org/packages/02/2b/779e3687bd4874553adf90b14f1196185e2427294e897e1f56b0c8b34ef1/scaden-0.9.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "99d1344e57cf5809457b5e53d789b66e", "sha256": "f6aa4ab362a77e6e3bca9a3522a33f3da07e86fe5e6ce566b063a8e7b0b8f09d" }, "downloads": -1, "filename": "scaden-0.9.2-py3-none-any.whl", "has_sig": false, "md5_digest": "99d1344e57cf5809457b5e53d789b66e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17112, "upload_time": "2019-09-25T12:15:59", "url": "https://files.pythonhosted.org/packages/e7/8f/1953a88c323a8c1531ba43051cb70ce2f0797d109cde006ac904a88b4439/scaden-0.9.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7492dada7d71380688dc4812edafa246", "sha256": "325a3c6edafbca88860bca06fdcabd7b9c7814addf0892f372ed71846fd55bb9" }, "downloads": -1, "filename": "scaden-0.9.2.tar.gz", "has_sig": false, "md5_digest": "7492dada7d71380688dc4812edafa246", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15799, "upload_time": "2019-09-25T12:16:01", "url": "https://files.pythonhosted.org/packages/02/2b/779e3687bd4874553adf90b14f1196185e2427294e897e1f56b0c8b34ef1/scaden-0.9.2.tar.gz" } ] }