Skip to main content

PILOT [Paper]

GitHub license

Although clinical applications represent the next challenge in single-cell genomics and digital pathology, we still lack computational methods to analyze single-cell or pathomics data to find sample-level trajectories or clusters associated with diseases. This remains challenging as single-cell/pathomics data are multi-scale, i.e., a sample is represented by clusters of cells/structures, and samples cannot be easily compared with each other. Here we propose PatIent Level analysis with Optimal Transport (PILOT). PILOT uses optimal transport to compute the Wasserstein distance between two individual single-cell samples. This allows us to perform unsupervised analysis at the sample level and uncover trajectories or cellular clusters associated with disease progression. We evaluate PILOT and competing approaches in single-cell genomics or pathomics studies involving various human diseases with up to 600 samples/patients and millions of cells or tissue structures. Our results demonstrate that PILOT detects disease-associated samples from large and complex single-cell or pathomics data. Moreover, PILOT provides a statistical approach to find changes in cell populations, gene expression, and tissue structures related to the trajectories or clusters supporting interpretation of predictions.

plot

🆕 What's new in version 2.1.0

Installation

The easiest way to install PILOT and the required packages is using the following way:

pip install pilotpy

Once you've completed these steps, you can proceed to run the tutorials and explore the features of PILOT. When doing so, remember to move to the tutorial folder, as all the work will be performed there:

git clone https://github.com/CostaLab/PILOT.git
cd PILOT/Tutorial

Tutorial&Data sets

There are seven tutorials, one for Myocardial Infarction (single cell data), and the second tutorial for pathomics data, the combination of Kidney IgAN(G) & Kidney IgAN(T), and the third one for Patients sub-group detection and then ranking cells/genes (Pancreas data) and the forth one for evaluation of the presence of batch effects in Trajectory the fifth one for evaluation of the presence of batch effects in detected sub-groups, the sixth one for the settings of the Wasserstein distance, and the last one for splitting the trajectory into branches.

You can access the used data sets by PILOT in Part 1 DOI and Part 2 DOI

Citation

@article{joodaki2024detection,
  title={Detection of PatIent-Level distances from single cell genomics and pathomics data with Optimal Transport (PILOT)},
  author={Joodaki, Mehdi and Shaigan, Mina and Parra, Victor and B{\"u}low, Roman D and Kuppe, Christoph and H{\"o}lscher, David L and Cheng, Mingbo and Nagai, James S and Goedertier, Micha{\"e}l and Bouteldja, Nassim and others},
  journal={Molecular systems biology},
  volume={20},
  number={2},
  pages={57--74},
  year={2024},
  publisher={Nature Publishing Group UK London}
}

Metadata

Release files for pilotpy 2.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pilotpy 2.1.1
File Size Uploaded Provenance Actions
pilotpy-2.1.1.tar.gz 107.9 kB Without provenance Details for pilotpy-2.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pilotpy 2.1.1
File Interpreter ABI Platform Actions
pilotpy-2.1.1-py3-none-any.whl Python 3 none any Details for pilotpy-2.1.1-py3-none-any.whl

Total release size: 218.7 kB

Release files / pilotpy-2.1.1.tar.gz

Download URL pilotpy-2.1.1.tar.gz
Size 107.9 kB
Tags Source
SHA-256 checksum
How to use checksums
3f4183ce43deb36c86440878046cc652309ba67f7b4573acff617eb60a0fd1f3
BLAKE2b-256 checksum
How to use checksums
0b5221d4572a1ed490758053eeb9a84d44632e9e050c3004f4f973b0839c17b7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.18

Release files / pilotpy-2.1.1-py3-none-any.whl

Download URL pilotpy-2.1.1-py3-none-any.whl
Size 110.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
21384eddbf41795ddb5144879aaae732550633dba7795ce7bd974f50436beda3
BLAKE2b-256 checksum
How to use checksums
795b1c93c4a8abf72401c915d77763df8a621809c08fd23d4da24a8e645133b5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.18

Security for pilotpy 2.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page