Data

Tools

Indexes

Applications

Experiments

Open Source Science

itclust

Iterative transfer learning with neural network improves clustering and cell type classification in single-cell RNA-seq analysis

https://github.com/jianhuupenn/itclust

Science Score: 33.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ○
    codemeta.json file
  • ○
    .zenodo.json file
  • ✓
    DOI references
    Found 3 DOI reference(s) in README
  • ✓
    Academic publication links
    Links to: biorxiv.org, nature.com
  • ✓
    Committers with academic emails
    2 of 3 committers (66.7%) from academic institutions
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (11.0%) to scientific vocabulary

Keywords

cell-classification clustering-algorithm machine-learning neural-network rna-seq single-cell transfer-learning
Last synced: 6 months ago · JSON representation

Repository

Iterative transfer learning with neural network improves clustering and cell type classification in single-cell RNA-seq analysis

Basic Info
  • Host: GitHub
  • Owner: jianhuupenn
  • Language: Jupyter Notebook
  • Default Branch: master
  • Homepage:
  • Size: 80.7 MB
Statistics
  • Stars: 51
  • Watchers: 4
  • Forks: 8
  • Open Issues: 1
  • Releases: 0
Topics
cell-classification clustering-algorithm machine-learning neural-network rna-seq single-cell transfer-learning
Created over 6 years ago · Last pushed about 4 years ago
Metadata Files
Readme

README.md

ItClust v1.2.0

ItClust: Iterative transfer learning with neural network improves clustering and cell type classification in single-cell RNA-seq analysis

ItClust is an Iterative Transfer learning algorithm for scRNA-seq Clustering. It starts from building a training neural network to extract gene-expression signatures from a well-labeled source dataset. This step enables initializing the target network with parameters estimated from the training network. The target network then leverages information in the target dataset to iteratively fine-tune parameters in an unsupervised manner, so that the target-data-specific gene-expression signatures are captured. Once fine-tuning is finished, the target network then returns clustered cells in the target data. ItClust has shown to be a powerful tool for scRNA-seq clustering and cell type classification analysis. It can accurately extract information from source data and apply it to help cluster cells in target data. It is robust to strong batch effect between source and target data, and is able to separate unseen cell types in the target. Furthermore, it provides confidence scores that facilitates cell type assignment. With the increasing popularity of scRNA-seq in biomedical research, we expect ItClust will make better utilization of the vast amount of existing well annotated scRNA-seq datasets, and enable researchers to accurately cluster and annotate cells in scRNA-seq.

ItClust workflow

Figure made by Nan Ma.

For thorough details, see the preprint: Bioxiv

Usage

The ItClust package is an implementation of Iterative Transfer learning algorithm for scRNA-seq Clustering. With ItClust, you can:

  • Preprocess single cell gene expression data from various formats.
  • Build a network for target data clustering with prioe knowledge learnt from the source data.
  • Obtain soft-clustering assignments of cells.
  • Obtain cell type confidence score for each clsuter to assist cell type assignment.
  • Visualize cell clustering/classification results and gene expression patterns.

System Requirements

Python support packages: pandas, numpy, keras, scipy, scanpy, anndata, natsort, sklearn.

Versions the software has been tested on

Environment 1: - System: Mac OS 10.13.6 - Python: 3.7.0 - Python packages: pandas = 0.25.3, numpy = 1.18.1, keras = 2.2.4, tensorflow = 1.14.0, scipy = 1.4.1, scanpy = 1.4.4.post1, anndata = 0.6.22.post1, natsort = 7.0.1, sklearn = 0.22.1

Environment 2: - System: Linux 3.10.0 - Python: 3.7.5 - Python packages: pandas = 0.25.3, numpy = 1.17.3, keras = 2.3.1, scipy = 1.4.1, scanpy = 1.4.4.post1, anndata = 0.6.22.post1, natsort = 6.0.0, sklearn = 0.21.3

Environment 3: - System: Ubuntu 16.04.6 LTS - Python: 3.5.2 - Python packages: pandas = 0.22.0, numpy = 1.16.4, keras = 2.2.4, scipy = 1.0.1, scanpy = 1.3.1+21.g1df151f, anndata = 0.6.20, natsort = 5.2.0, sklearn = 0.19.1

Installation guide, Demo and Instructions

Please refer to: https://github.com/jianhuupenn/ItClust/blob/master/tutorial/tutorial.md

Contributing

Souce code: Github
Author email: jianhu@pennmedicine.upenn.edu
We are continuing adding new features. Bug reports or feature requests are welcome.

Debugging

If you see this error information:

TypeError: add_weight() got multiple values for argument 'name'

Please update your Keras and TensorFlow to the same version as one of the tested environments.

Reference

Please consider citing the following reference: - Hu, J., Li, X., Hu, G. et al. Iterative transfer learning with neural network for clustering and cell type classification in single-cell RNA-seq analysis. Nat Mach Intell (2020). https://doi.org/10.1038/s42256-020-00233-7 - https://www.nature.com/articles/s42256-020-00233-7 - If you do not have access to the link above, you can access the paper by https://rdcu.be/b78Ya - https://www.biorxiv.org/content/10.1101/2020.02.02.931139v1.full (preprint)

Owner

  • Name: JianHu
  • Login: jianhuupenn
  • Kind: user
  • Location: Atlanta

Assistant Professor at the Department of Human Genetics, Emory School of Medicine

GitHub Events

Total
  • Watch event: 3
  • Fork event: 1
  • Create event: 1
Last Year
  • Watch event: 3
  • Fork event: 1
  • Create event: 1

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 91
  • Total Committers: 3
  • Avg Commits per committer: 30.333
  • Development Distribution Score (DDS): 0.538
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
JianHu j****u@p****u 42
JianHu 2****n 38
JianHu j****u@m****u 11
Committer Domains (Top 20 + Academic)
mail.med.upenn.edu: 1 pennmedicine.upenn.edu: 1

Issues and Pull Requests

Last synced: over 1 year ago

All Time
  • Total issues: 15
  • Total pull requests: 1
  • Average time to close issues: 19 days
  • Average time to close pull requests: less than a minute
  • Total issue authors: 9
  • Total pull request authors: 1
  • Average comments per issue: 6.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • bitcometz (4)
  • mvis1231 (3)
  • cartal (2)
  • wzqwtt (1)
  • qingnanl (1)
  • mydkzgj (1)
  • Ci-TJ (1)
  • Qiuchizhai (1)
  • mohit1997 (1)
Pull Request Authors
  • jianhuupenn (1)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 33 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 3
  • Total maintainers: 1
pypi.org: itclust

An Iterative Transfer learning algorithm for scRNA-seq Clustering

  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 33 Last month
Rankings
Stargazers count: 9.5%
Dependent packages count: 10.0%
Forks count: 11.9%
Average: 21.3%
Dependent repos count: 21.7%
Downloads: 53.4%
Maintainers (1)
jianhu
Last synced: 6 months ago

Dependencies

ItClust_package/ItClust.egg-info/requires.txt pypi
  • anndata *
  • keras *
  • natsort *
  • numpy *
  • pandas *
  • scanpy *
  • scipy *
  • sklearn *
ItClust_package/setup.py pypi
  • keras *