# **ONTraC**
[](https://pypi.org/project/ONTraC/)
[](https://pypi.org/project/ONTraC/)
[](https://pepy.tech/project/ONTraC)
[](https://pypistats.org/packages/ontrac)
[](https://anaconda.org/gyuanlab/ontrac)
[](https://anaconda.org/gyuanlab/ontrac)
[](https://github.com/gyuanlab/ONTraC)
[](https://github.com/gyuanlab/ONTraC/blob/master/LICENSE)
ONTraC (Ordered Niche Trajectory Construction) is a niche-centered, machine learning
method for constructing spatially continuous trajectories. ONTraC differs from existing tools in
that it treats a niche, rather than an individual cell, as the basic unit for spatial trajectory
analysis. In this context, we define niche as a multicellular, spatially localized region where
different cell types may coexist and interact with each other. ONTraC seamlessly integrates
cell-type composition and spatial information by using the graph neural network modeling
framework. Its output, which is called the niche trajectory, can be viewed as a one dimensional
representation of the tissue microenvironment continuum. By disentangling cell-level and niche-
level properties, niche trajectory analysis provides a coherent framework to study coordinated
responses from all the cells in association with continuous tissue microenvironment variations.
## Installation
```sh
pip install ONTraC
```
For details and alternative approches, please see the [installation tutorial](tutorials/installation.md)
## Tutorial
### Input File
A example input file is provided in `examples/stereo_seq_brain/original_data.csv`.
This file contains all input formation with five columns: Cell_ID, Sample, Cell_Type, x, and y.
| Cell_ID | Sample | Cell_Type | x | y |
| --------------- | -------- | --------- | ------- | ----- |
| E12_E1S3_100034 | E12_E1S3 | Fibro | 15940 | 18584 |
| E12_E1S3_100035 | E12_E1S3 | Fibro | 15942 | 18623 |
| ... | ... | ... | ... | ... |
| E16_E2S7_326412 | E16_E2S7 | Fibro | 32990.5 | 14475 |
For detailed information about input and output file, please see [IO files explanation](tutorials/IO_files.md#input-files).
### Running ONTraC
The required options for running ONTraC are the paths to the input file and the three output directories:
- **preprocessing-dir:** This directory stores preprocessed data and other intermediary datasets for analysis.
- **GNN-dir:** This directory stores output from running the GP (Graph Pooling) algorithm.
- **NTScore-dir:** This directory stores NTScore output.
For detailed description about all parameters, please see [Parameters explanation](tutorials/parameters.md).
```{sh}
ONTraC -d simulated_dataset.csv --preprocessing-dir simulation_preprocessing_dir --GNN-dir simulation_GNN --NTScore-dir simulation_NTScore --hidden-feats 4 -k 6 --modularity-loss-weight 0.3 --purity-loss-weight 300 --regularization-loss-weight 0.1 --beta 0.03 2>&1 | tee simulation.log
```
The input dataset and output files could be downloaded from [Zenodo](https://zenodo.org/records/11186620).
We recommand running `ONTraC` on GPU, it may take much more time on your own laptop with CPU only.
### Output
The intermediate and final results are located in `preprocessing-dir`, `GNN-dir`, and `NTScore-dir` directories. Please see [IO files explanation](tutorials/IO_files.md#output-files) for detailed infromation.
### Visualization
Please see [post analysis tutorial](tutorials/post_analysis.md).
### Interoperability
ONTraC has been incorporated with [Giotto Suite](https://drieslab.github.io/Giotto_website/articles/ontrac.html).
## Citation
**Wang, W.\*, Zheng, S.\*, Shin, C. S. & [Yuan, G. C.](https://labs.icahn.mssm.edu/yuanlab/)$**. [Characterizing Spatially Continuous Variations in Tissue Microenvironment through Niche Trajectory Analysis](https://www.biorxiv.org/content/10.1101/2024.04.23.590827v1). *bioRxiv*, 2024.
Raw data
{
"_id": null,
"home_page": null,
"name": "ONTraC",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": "graph neural network, pytorch, pytorch geometric, trajectory inference, spatial omics",
"author": null,
"author_email": "Wen Wang <wwang.bio@gmail.com>, Shiwei Zheng <swzheng29@gmail.com>, Crystal Shin <sjcshin5040@gmail.com>, Guo-Cheng Yuan <gcyuan@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/25/38/a20399fd0f16a1e571c58c830107516828bd45fd939cf05a9dbb01661020/ontrac-1.0.7.tar.gz",
"platform": null,
"description": "# **ONTraC**\n\n[](https://pypi.org/project/ONTraC/)\n[](https://pypi.org/project/ONTraC/)\n[](https://pepy.tech/project/ONTraC)\n[](https://pypistats.org/packages/ontrac)\n[](https://anaconda.org/gyuanlab/ontrac)\n[](https://anaconda.org/gyuanlab/ontrac)\n[](https://github.com/gyuanlab/ONTraC)\n[](https://github.com/gyuanlab/ONTraC/blob/master/LICENSE)\n\nONTraC (Ordered Niche Trajectory Construction) is a niche-centered, machine learning\nmethod for constructing spatially continuous trajectories. ONTraC differs from existing tools in\nthat it treats a niche, rather than an individual cell, as the basic unit for spatial trajectory\nanalysis. In this context, we define niche as a multicellular, spatially localized region where\ndifferent cell types may coexist and interact with each other. ONTraC seamlessly integrates\ncell-type composition and spatial information by using the graph neural network modeling\nframework. Its output, which is called the niche trajectory, can be viewed as a one dimensional\nrepresentation of the tissue microenvironment continuum. By disentangling cell-level and niche-\nlevel properties, niche trajectory analysis provides a coherent framework to study coordinated\nresponses from all the cells in association with continuous tissue microenvironment variations.\n\n\n\n## Installation\n\n```sh\npip install ONTraC\n```\n\nFor details and alternative approches, please see the [installation tutorial](tutorials/installation.md)\n\n## Tutorial\n\n### Input File\n\nA example input file is provided in `examples/stereo_seq_brain/original_data.csv`.\nThis file contains all input formation with five columns: Cell_ID, Sample, Cell_Type, x, and y.\n\n| Cell_ID | Sample | Cell_Type | x | y |\n| --------------- | -------- | --------- | ------- | ----- |\n| E12_E1S3_100034 | E12_E1S3 | Fibro | 15940 | 18584 |\n| E12_E1S3_100035 | E12_E1S3 | Fibro | 15942 | 18623 |\n| ... | ... | ... | ... | ... |\n| E16_E2S7_326412 | E16_E2S7 | Fibro | 32990.5 | 14475 |\n\nFor detailed information about input and output file, please see [IO files explanation](tutorials/IO_files.md#input-files).\n\n### Running ONTraC\n\nThe required options for running ONTraC are the paths to the input file and the three output directories:\n\n- **preprocessing-dir:** This directory stores preprocessed data and other intermediary datasets for analysis.\n- **GNN-dir:** This directory stores output from running the GP (Graph Pooling) algorithm.\n- **NTScore-dir:** This directory stores NTScore output.\n\nFor detailed description about all parameters, please see [Parameters explanation](tutorials/parameters.md).\n\n```{sh}\nONTraC -d simulated_dataset.csv --preprocessing-dir simulation_preprocessing_dir --GNN-dir simulation_GNN --NTScore-dir simulation_NTScore --hidden-feats 4 -k 6 --modularity-loss-weight 0.3 --purity-loss-weight 300 --regularization-loss-weight 0.1 --beta 0.03 2>&1 | tee simulation.log\n```\n\nThe input dataset and output files could be downloaded from [Zenodo](https://zenodo.org/records/11186620).\n\nWe recommand running `ONTraC` on GPU, it may take much more time on your own laptop with CPU only.\n\n### Output\n\nThe intermediate and final results are located in `preprocessing-dir`, `GNN-dir`, and `NTScore-dir` directories. Please see [IO files explanation](tutorials/IO_files.md#output-files) for detailed infromation.\n\n### Visualization\n\nPlease see [post analysis tutorial](tutorials/post_analysis.md).\n\n### Interoperability\n\nONTraC has been incorporated with [Giotto Suite](https://drieslab.github.io/Giotto_website/articles/ontrac.html).\n\n## Citation\n\n**Wang, W.\\*, Zheng, S.\\*, Shin, C. S. & [Yuan, G. C.](https://labs.icahn.mssm.edu/yuanlab/)$**. [Characterizing Spatially Continuous Variations in Tissue Microenvironment through Niche Trajectory Analysis](https://www.biorxiv.org/content/10.1101/2024.04.23.590827v1). *bioRxiv*, 2024.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A niche-centered, machine learning method for constructing spatially continuous trajectories",
"version": "1.0.7",
"project_urls": {
"Homepage": "https://github.com/gyuanlab/ONTraC",
"Issue Tracker": "https://github.com/gyuanlab/ONTraC/issues",
"Repository": "https://github.com/gyuanlab/ONTraC"
},
"split_keywords": [
"graph neural network",
" pytorch",
" pytorch geometric",
" trajectory inference",
" spatial omics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "91bd64311b830ca6ae4421c084c980e1c5e05a9791eccc9a1972b2f81ae9448f",
"md5": "3e1b41d8e4ff37838dce6b3496acce05",
"sha256": "0d39b7cb2ce3409a17c587b9cccc5ebf46d52f4b249bd20931b2f5fef8239f31"
},
"downloads": -1,
"filename": "ONTraC-1.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3e1b41d8e4ff37838dce6b3496acce05",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 61711,
"upload_time": "2024-10-23T17:40:06",
"upload_time_iso_8601": "2024-10-23T17:40:06.697255Z",
"url": "https://files.pythonhosted.org/packages/91/bd/64311b830ca6ae4421c084c980e1c5e05a9791eccc9a1972b2f81ae9448f/ONTraC-1.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2538a20399fd0f16a1e571c58c830107516828bd45fd939cf05a9dbb01661020",
"md5": "741ccf174bb8a5164c6c448bbf1998db",
"sha256": "e51966ecf72b4cfb49a65fcf3a1ee3b8b9d2319e8fe0509afae82b23fc9c7515"
},
"downloads": -1,
"filename": "ontrac-1.0.7.tar.gz",
"has_sig": false,
"md5_digest": "741ccf174bb8a5164c6c448bbf1998db",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 50118,
"upload_time": "2024-10-23T17:40:07",
"upload_time_iso_8601": "2024-10-23T17:40:07.886885Z",
"url": "https://files.pythonhosted.org/packages/25/38/a20399fd0f16a1e571c58c830107516828bd45fd939cf05a9dbb01661020/ontrac-1.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-23 17:40:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gyuanlab",
"github_project": "ONTraC",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ontrac"
}
JSON
