BioTIP
BioTIP: Biological Tipping-Point Identification and Characterization
Science Score: 46.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
✓Academic publication links
Links to: pubmed.ncbi, ncbi.nlm.nih.gov, nature.com -
✓Committers with academic emails
5 of 17 committers (29.4%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (10.1%) to scientific vocabulary
Keywords from Contributors
Repository
BioTIP: Biological Tipping-Point Identification and Characterization
Basic Info
Statistics
- Stars: 21
- Watchers: 1
- Forks: 6
- Open Issues: 6
- Releases: 0
Metadata Files
README.md
BioTIP: an R-package for Characterization of Biological Tipping Points
What is BioTIP?
Abrupt and often irreversible changes (or tipping points) are decisive in the progression of biological processes. We, therefore, developed this R-package for the characterization of biological tipping points using gene expression profiles. BioTIP is the first toolset that amalgamates two computational impediments in multivariate expression-data analysis: (1) detection of tipping points accurately, and (2) identification of significant critical transition signals (CTSs).
The following figure outlines BioTIP pipeline:
a, Analytic pipeline of single-cell RNA-seq analysis, with BioTIP as an alternative to mainstream analyses by focusing on transition states. The arrows in orange show that BioTIP is applied to cell state ensembles (clusters) without inputting the pseudo-order information. The dashed orange arrow shows that BioTIP may use pseudo-order information to visualize and interpret the results.
b, Overview of BioTIP’s three analytical steps. The scRNA-seq profiles with cell cluster IDs are the inputs, which can be generated by independent pipelines. The outputs are significant CT states and their characteristic CTSs which can infer CT-driven transcription factors. Three analytic steps HVG: highly variable genes. DNB: dynamic biomarker network; Ic: index of criticality.
Why BioTIP?
BioTIP addresses and shows robust performances by addressing three analytical challenges of the existing tipping-point methods:
- The sizes of the statistical ensembles (e.g., cellular populations) vary considerably. BioTIP provides Ic.shrink score (an improved version on Ic score) to address the bias towards differently sized populations.
- Multiple tipping points may coexist during an observed progression and multiple CTSs may coexist in the same critical transition state. BioTIP can detect multiple tipping points and CTSs.
- Under exposure to a stimulus, the same population of cells faces multiple trajectories. BioTIP has robust performance for different trajectory inference methods.
6 Case Studies
We applied BioTIP to six datasets and compared BioTIP's performance with other existing tools (see examples). The six datasets are as following:
- Dataset 1 consists of 96 selected genes in 929 human embryonic stem cells (hESCs) of predefined 9 clusters (Bargaje et al., 2017).
- Dataset 2 consists of 10.3k genes in 131 mouse lung alveolar type (AT2) development, collected at four time points (Treutlein et al., 2014).
- Dataset 3 consists of 10.9k genes of 7,240 developing mesoderm cells collected at embryonic day (E) 8.25 when precursor cells of major organs have been formed (Pijuan-Sala et al., 2019).
- Dataset 4 contained 12.7k genes in 11k E8.25 cells, with 16 predefined developing mesoderm subtypes (Ibarra-Soria et al., 2018).
- Dataset 5 contained 15.2k genes of 1,531 mesoderm cells of embryoid bodies (EB), describing how hemangiogenic (HA) and smooth muscle lineages are specified from FLK1-expressing (FLK1+) mesoderm (Zhao and Choi, 2019).
- Dataset 6 is an epithelial-to-mesenchymal transition (EMT) data simulated from an established 18-gene regulatory network of 5,363 cells consisting of four stable states and between-state transition cells (Sha et al., 2020).
For each dataset, cell-type biomarkers or cluster identities are given by the original publications. The scRNA-seq data quality control (e.g., removing triplicate cell and mitochondria gene), normalize distinct sequencing depths, general feature selections, and cell cluster are performed following the corresponding manuscripts.
Method Comparison
Robustness
Cell clustering is a prerequisite for CTS identification with BioTIP. While different cell cluster numbers may affect BioTIP's prediction, a reasonable clustering method (with reasonably chosen parameters) will not have a major impact on the CTSs identified. BioTIP is designed for the case where the transition state can be identified as a cell cluster, and therefore soft clustering is not always applicable.
BioTIP also demonstrated robustness with respect to different clustering methods. Details can be found here.
Where to apply BioTIP?
To adopt tipping-point theory to transcriptomic analysis, there are two commonly accepted premises:
- The system of the individual cell has a dissipative structure (e.g., having discrete states, including the one showing semi-stability).
- Each state has a characteristic gene expression profile and thus presents a distinct molecular phenotype.
BioTIP applies to data meeting these premises, including both single-cell and bulk-cell transcriptomes. The impending transition states are called ‘critical transition states’ or ‘tipping points.’
We have successfully applied BioTIP to identify temporal features of molecular-network dynamics from gene expression profiles. Importantly, the CTS identifications helped infer the underlying gene-regulatory network and the involving key transcription factors.
How does BioTIP work?
BioTIP tutorial: This is a detailed walkthrough of BioTIP on one of our key results (Mouse Gastrulation, GSE87038, E8.25 2019).
Vignette: This documented exampled case studies on bulk (GSE6136) and single-cell (Nestorowa 2016) datasets.
How to install?
To use the newest BioTIP package, either clone/download this repository, or you can install BioTIP with:
r
library("devtools")
devtools::install_github("xyang2uchicago/BioTIP")
You can install the released version of BioTIP from CRAN with:
r
install.packages("BioTIP")
or even better:
r
source('http://bioconductor.org/biocLite.R')
biocLite("BioTIP")
Acknowledgements
BioTIP is made possible by contributions from the following authors: Xinan H Yang, Zhezhen Wang, Yuxi Sun, Andrew Goldstein, Dannie Griggs, Antonio Feliciano, Yanqiu Wang, Biniam Feleke, Qier An, Ieva Tolkaciovaite, and John M Cunningham.
Owner
- Name: YangGroup
- Login: xyang2uchicago
- Kind: user
- Location: Chicago
- Company: the University of Chicago
- Website: http://home.uchicago.edu/~xyang2/
- Repositories: 1
- Profile: https://github.com/xyang2uchicago
GitHub Events
Total
- Watch event: 2
- Member event: 1
- Push event: 12
- Fork event: 1
Last Year
- Watch event: 2
- Member event: 1
- Push event: 12
- Fork event: 1
Committers
Last synced: over 2 years ago
Top Committers
| Name | Commits | |
|---|---|---|
| zhezhenwang | z****g@g****m | 73 |
| YangGroup | 4****o | 42 |
| Jennifer Sun | y****8@J****l | 37 |
| Jennifer Sun | y****8@d****u | 32 |
| ysun98 | y****1@u****u | 28 |
| Nitesh Turaga | n****a@g****m | 12 |
| Jennifer Sun | j****n@J****l | 12 |
| Jennifer Sun | y****8@j****n | 7 |
| J Sun | j****8@d****u | 5 |
| zhezhenwang | 3****g | 5 |
| Biniam Feleke | b****o@o****m | 4 |
| J Wokaty | j****y@s****u | 2 |
| J Wokaty | j****y | 2 |
| Hervé Pagès | h****b@g****m | 1 |
| Zhezhen Wang | z****g@Z****l | 1 |
| J Sun | j****8@J****l | 1 |
| J Sun | j****8@d****u | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 7 months ago
All Time
- Total issues: 6
- Total pull requests: 1
- Average time to close issues: N/A
- Average time to close pull requests: about 20 hours
- Total issue authors: 6
- Total pull request authors: 1
- Average comments per issue: 0.83
- Average comments per pull request: 0.0
- Merged pull requests: 1
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 2
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 2
- Pull request authors: 0
- Average comments per issue: 0.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- Phoenix12580 (1)
- sugarballer (1)
- 31474molly (1)
- gpunzi (1)
- NGUaqr (1)
- zyb1984 (1)
Pull Request Authors
- benjkallo (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- bioconductor 10,361 total
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 5
- Total maintainers: 3
bioconductor.org: BioTIP
BioTIP: An R package for characterization of Biological Tipping-Point
- Homepage: https://github.com/xyang2uchicago/BioTIP
- Documentation: https://bioconductor.org/packages/release/bioc/vignettes/BioTIP/inst/doc/BioTIP.pdf
- License: GPL-2
-
Latest release: 1.22.0
published 11 months ago