Metadata-Version: 2.4
Name: crisgi
Version: 0.1.0
Summary: Charting Critical Transient Gene Interactions in Disease Progression from Multi-modal Transcriptomics
Home-page: https://github.com/compbioclub/CRISGI
Author: Lyu C., Jiang A., Ng K. H., Liu X., Chen L.
Author-email: 
License: MIT
Project-URL: Homepage, https://github.com/compbioclub/CRISGI
Project-URL: Documentation, https://compbioclub.github.io/CRISGI/
Project-URL: Repository, https://github.com/compbioclub/CRISGI.git
Project-URL: Bug Tracker, https://github.com/compbioclub/CRISGI/issues
Keywords: bioinformatics,genomics,critical transitions,gene interactions,transcriptomics,single-cell,spatial transcriptomics,disease progression,machine learning,neural networks
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.20.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: scipy>=1.7.0
Requires-Dist: scikit-learn>=1.0.0
Requires-Dist: torch>=2.5.0
Requires-Dist: torchvision>=0.20.0
Requires-Dist: joblib>=1.0.0
Requires-Dist: scanpy>=1.8.0
Requires-Dist: anndata>=0.8.0
Requires-Dist: matplotlib>=3.3.0
Requires-Dist: seaborn>=0.11.0
Requires-Dist: pyvis>=0.2.0
Requires-Dist: scikit-survival>=0.17.0
Requires-Dist: gseapy>=1.0.0
Requires-Dist: pymannkendall>=1.4.0
Requires-Dist: pyseat
Requires-Dist: Pillow>=8.0.0
Requires-Dist: ipykernel>=6.0.0
Requires-Dist: ipython>=8.0.0
Requires-Dist: jupyter>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-cov>=2.10; extra == "dev"
Requires-Dist: black>=21.0; extra == "dev"
Requires-Dist: flake8>=3.8; extra == "dev"
Requires-Dist: isort>=5.0; extra == "dev"
Requires-Dist: pre-commit>=2.15.0; extra == "dev"
Requires-Dist: mypy>=0.910; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.4.0; extra == "docs"
Requires-Dist: mkdocs-material>=8.0.0; extra == "docs"
Requires-Dist: mkdocstrings[python]>=0.19.0; extra == "docs"
Requires-Dist: mknotebooks>=0.7.0; extra == "docs"
Provides-Extra: tutorial
Requires-Dist: notebook>=6.0.0; extra == "tutorial"
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# CRISGI

Welcome to the official documentation of Charting CRItical tranSient Gene Interactions (**CRISGI**) in Disease Progression from Multi-modal Transcriptomics!

## 🗺️ Overview

![Figure1](./docs/figure/Figure1.png)

Critical transitions (CTs) in gene regulatory networks (GRNs) drive pivotal shifts in disease progression. While CT theory holds great promise for early disease detection, existing computational frameworks face major limitations. They rely on unsupervised ranking of CT signals at individual gene or gene-module level, apply unranked gene set enrichment analyses, and depend on manual inspection of signal trends to infer CT presence and onset within a single cohort. Additionally, multimodal transcriptomic data remain underutilized. These approaches limit mechanistic resolution and hinder clinical translation.

We present CRISGI, a novel CT framework designed to overcome these challenges. CRISGI enables phenotype-specific CT gene-gene interaction modeling, CT-rank enrichment analyses, automated CT presence and onset prediction, and supports bulk, single-cell, and spatial transcriptomic (ST) data.

## 🚀 Getting Started

Want to start using it immediately? Check out the [Installation Guide](https://compbioclub.github.io/CRISGI/installation/) and [Usage Guide](https://compbioclub.github.io/CRISGI/usage/).

### 📥 Installation

CRISGI is a Python package that can be installed via pip. You can install it from PyPI or from the source.

Details on how to install CRISGI can be found in the [Installation](https://compbioclub.github.io/CRISGI/installation/) section.

### 🔧 Usage

CRISGI is designed to be user-friendly and easy to use. The package provides a set of functions that can be used to perform various tasks related to critical transitions in gene interactions. Detailed instructions on how to use CRISGI can be found in the following sections.

### 📖 Tutorials

Moreover, you can find some tutorials in the [Tutorial](https://compbioclub.github.io/CRISGI/tutorial/) section. These tutorials will guide you through the process of using CRISGI for your own data analysis.

## 📚 API Reference

For more detailed information, please refer to the [API Reference](https://compbioclub.github.io/CRISGI/api_reference/).

## 📑 Citation

If you use CRISGI in your research, please cite the following paper:

APA format:

```
Lyu, C., Jiang, A., Ng, K. H., Liu, X., & Chen, L. (2025). Predicting Early Transitions in Respiratory Virus Infections via Critical Transient Gene Interactions. bioRxiv. https://doi.org/10.1101/2025.04.18.649619
```


BibTeX format:

```bibtex
@article{crisgi,
  title={Predicting Early Transitions in Respiratory Virus Infections via Critical Transient Gene Interactions},
  author={Lyu, Chengshang and Jiang, Anna and Ng, Ka Ho and Liu, Xiaoyu and Chen, Lingxi},
  journal={bioRxiv},
  year={2025},
  doi={10.1101/2025.04.18.649619},
  publisher={Cold Spring Harbor Laboratory}
}
```
