Metadata-Version: 2.2
Name: metachat
Version: 0.0.7
Summary: Spatial metabolic communication flow of cells.
Home-page: https://github.com/SonghaoLuo/metachat
Author: Songhao Luo
Author-email: songhal2@@uci.edu
License: MIT License
Keywords: metabolic cell communicaiton,spatial transcriptomics,spatial metabolomics,optimal transport
Classifier: Programming Language :: Python :: 3.9
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: adjustText==1.3.0
Requires-Dist: anndata==0.10.8
Requires-Dist: anndata2ri==1.3.1
Requires-Dist: gseapy==1.1.2
Requires-Dist: leidenalg==0.10.2
Requires-Dist: matplotlib==3.8.4
Requires-Dist: networkx==3.2.1
Requires-Dist: numpy==1.23.1
Requires-Dist: pandas==2.3.1
Requires-Dist: plotly==5.21.0
Requires-Dist: POT==0.9.3
Requires-Dist: pycirclize==1.6.0
Requires-Dist: pydpc==0.1.3
Requires-Dist: python_igraph==0.11.4
Requires-Dist: rpy2==3.5.15
Requires-Dist: scanpy==1.10.1
Requires-Dist: scikit_learn==1.4.2
Requires-Dist: scipy==1.13.1
Requires-Dist: seaborn==0.13.2
Requires-Dist: squidpy==1.2.2
Requires-Dist: tqdm==4.66.2
Provides-Extra: docs
Requires-Dist: sphinx==5.3.0; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints==1.18.1; extra == "docs"
Requires-Dist: sphinx-rtd-theme==1.0.0; extra == "docs"
Requires-Dist: sphinx-rtd-size==0.2.0; extra == "docs"
Requires-Dist: sphinxcontrib-applehelp==1.0.2; extra == "docs"
Requires-Dist: sphinxcontrib-devhelp==1.0.2; extra == "docs"
Requires-Dist: sphinxcontrib-htmlhelp==2.0.0; extra == "docs"
Requires-Dist: sphinxcontrib-jsmath==1.0.1; extra == "docs"
Requires-Dist: sphinxcontrib-qthelp==1.0.3; extra == "docs"
Requires-Dist: sphinxcontrib-serializinghtml==1.1.5; extra == "docs"
Requires-Dist: sphinx-mdinclude==0.5.3; extra == "docs"
Requires-Dist: nbsphinx==0.8.9; extra == "docs"
Requires-Dist: ipykernel==6.16.0; extra == "docs"
Requires-Dist: sphinx-gallery==0.11.1; extra == "docs"

# MetaChat
## Brief introduction
MetaChat is a Python package to screen metabolic cell communication (MCC) from spatial multi-omics data of transcriptomics and metabolomics. 
It contains many intuitive visualization and downstream analysis tools, provides a great practical toolbox for biomedical researchers.

### Metabolic cell communication
Metabolic cell-cell communication (MCC) occurs when sensor proteins in the receiver cells detect metabolites in their environment, activating intracellular signaling events. There are three major potential sensors of metabolites: surface receptors, nuclear receptors, and transporters. Metabolites secreted from cells are either transported over short-range distances (a few cells) via diffusion through extracellular space, or over long-range distances via the bloodstream and the cerebrospinal fluid (CSF).

<img width="600" alt="image" src="https://github.com/SonghaoLuo/MetaChat/assets/138028157/f08f21de-eeae-4626-8fbe-c26a307ec225">

### MetaChatDB
MetaChatDB is a literature-supported database for metabolite-sensor interactions for both human and mouse. All the metabolite-sensor interactions are reported based on peer-reviewed publications. Specifically, we manually build MetaChatDB by integrating three high-quality databases (PDB, HMDB, UniProt) that are being continually updated.

<img width="700" alt="image2" src="https://github.com/user-attachments/assets/1601f7f1-0997-4bdf-96da-5d2ae1fd28a2" />

### Documentation, and Tutorials
For more basic tutorial and real data examples, please see MetaChat documentation that is available through the link https://metachat.readthedocs.io/en/latest/.

### Analysis pipeline

<img width="2000" height="7914" alt="Table2" src="https://github.com/user-attachments/assets/d018be0e-fad2-4c74-b91e-4c0d929851c1" />

## Installation
### System requirements
Recommended operating systems: macOS or Linux. MetaChat was developed and tested on Linux and macOS.
### Python requirements
MetaChat was developed using python 3.9.
### Installation using `pip`
We suggest setting up MetaChat in a separate `mamba` or `conda` environment to prevent conflicts with other software dependencies. Create a new Python environment specifically for MetaChat and install the required libraries within it.

```bash
mamba create -n metachat_env python=3.9 r-base=4.3.2
mamba activate metachat_env
pip install metachat
```
if you use `conda`, `r-base=4.3.2` may not included in the channels. Instead, you can `r-base=4.3.1` in `conda`.



## Reference
Luo S., Almet A.A., Zhao W., He C., Tsai Y.-C., Ozaki H., Sugita B.K., Du K., Shen X., Cao Y., Yang Q., Watanabe M., Nie Q.* Spatial metabolic communication flow of cells.
