Metadata-Version: 2.4
Name: grassp
Version: 0.7.0
Summary: A python package to facilitate Organellar profiling
License-Expression: BSD-3-Clause
Project-URL: homepage, https://github.com/czbiohub-sf/grassp
Project-URL: documentation, https://czbiohub-sf.github.io/grassp/
Project-URL: repository, https://github.com/czbiohub-sf/grassp
Project-URL: changelog, https://github.com/czbiohub-sf/grassp/blob/main/CHANGELOG.md
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: <4.0,>=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: adjustText
Requires-Dist: anndata
Requires-Dist: markov_clustering
Requires-Dist: matplotlib
Requires-Dist: networkx
Requires-Dist: numba
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: protdata
Requires-Dist: pysankeybeta
Requires-Dist: requests
Requires-Dist: scanpy[leiden]>=1.10
Requires-Dist: scikit-learn
Requires-Dist: scipy
Requires-Dist: seaborn
Requires-Dist: umap-learn<0.6
Provides-Extra: dev
Requires-Dist: black~=26.10; extra == "dev"
Requires-Dist: flake8~=7.0; extra == "dev"
Requires-Dist: isort~=9.0; extra == "dev"
Requires-Dist: pre-commit~=4.0; extra == "dev"
Requires-Dist: pylint~=4.0; extra == "dev"
Requires-Dist: pytest~=8.0; extra == "dev"
Requires-Dist: xlrd; extra == "dev"
Requires-Dist: gseapy; extra == "dev"
Requires-Dist: mpltern; extra == "dev"
Requires-Dist: rdata; extra == "dev"
Requires-Dist: alphapepttools; extra == "dev"
Provides-Extra: notebook
Requires-Dist: jupyter; extra == "notebook"
Requires-Dist: matplotlib; extra == "notebook"
Requires-Dist: jupytext; extra == "notebook"
Provides-Extra: ccompass
Requires-Dist: ccompass; extra == "ccompass"
Requires-Dist: tensorboard; extra == "ccompass"
Provides-Extra: proloc
Requires-Dist: rdata; extra == "proloc"
Provides-Extra: build
Requires-Dist: twine; extra == "build"
Requires-Dist: build; extra == "build"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
Requires-Dist: scanpydoc[theme,typehints]>=0.15.1; extra == "docs"
Requires-Dist: sphinx-book-theme; extra == "docs"
Requires-Dist: myst_parser; extra == "docs"
Requires-Dist: myst-nb; extra == "docs"
Requires-Dist: jupytext; extra == "docs"
Requires-Dist: gseapy; extra == "docs"
Requires-Dist: mpltern; extra == "docs"
Requires-Dist: rdata; extra == "docs"
Requires-Dist: alphapepttools; extra == "docs"
Dynamic: license-file

[![PyPI - Version](https://img.shields.io/pypi/v/grassp)](https://pypi.org/project/grassp/)
[![CI](https://github.com/czbiohub-sf/grassp/actions/workflows/CI.yaml/badge.svg)](https://github.com/czbiohub-sf/grassp/actions/workflows/CI.yaml)
[![docs online](https://img.shields.io/badge/docs-online-blue)](https://czbiohub-sf.github.io/grassp/)


[anndata]: https://anndata.readthedocs.io
[scanpy]: https://scanpy.readthedocs.io
[protdata]: https://protdata.sf.czbiohub.org
[alphapepttools]: https://mannlabs.github.io/alphapepttools/
[documentation]: https://czbiohub-sf.github.io/grassp/


<p align="center">
  <img src="https://raw.githubusercontent.com/czbiohub-sf/grassp/refs/heads/main/docs/source/_static/img/logo.svg" alt="grassp logo" width="300"/>
</p>

The **grassp** (**GR**aph-based **A**nalysis of **S**ubcellular/**S**patial **P**roteomics) python module enables fast, flexible and scalable analysis of subcellular proteomics datasets.

It uses the [anndata][] format to store mass-spec data and analysis results and [scanpy][] for many of the dimensionality reduction and visualization functions.

**grassp** enables

- Reading the ouput format of most mass-spectrometry search engines (using [protdata][] or [alphapepttools][])
- Calculating subcellular enrichment profiles of proteins for different experimental protocols
- Annotating the subcellular location of proteins in an unsupervised and semi-supervised manner
- Combining multiple subcellular proteomics datasets
- Finding the optimal experimental design for future experiments based on simulations
- Detecting proteins at the interface of organelles
- Assessing subcellular resolution
- Detecting re-localizing proteins between conditions (work in progress)
- Detecting multi-localizing proteins (work in progress)
- Integration of multiple modalities (e.g. Lipidomics) (work in progress)

Please refer to the [documentation] for reference to individual functions and [tutorials](https://czbiohub-sf.github.io/grassp/tutorials/index.html).

## Installation

grassp can be installed via [pip](https://pypi.org/project/pip/) from [PyPI](https://pypi.org/project/grassp/) with:
```
pip install grassp
```
For details on installation, please see the [install section of the documentation](https://czbiohub-sf.github.io/grassp/installation.html).

## Changelog

See the [CHANGELOG.md](https://github.com/czbiohub-sf/grassp/blob/main/CHANGELOG.md) for a detailed history of changes, updates, and version releases.

## Contributing

If you'd like to contribute to **grassp** please feel free to look at our [contribution guide](https://czbiohub-sf.github.io/grassp/contributing.html) and open a [Pull request](https://github.com/czbiohub-sf/grassp/pulls).

## Authors

**grassp** is created and maintained by the [Leonetti Group](https://biohub.org/leonetti/) at the [Biohub San Francisco](https://biohub.org/). For details, see the [Contributors page](https://czbiohub-sf.github.io/grassp/contributors.html).

To get in touch please use the [GihHub issues](https://github.com/czbiohub-sf/grassp/issues) page.
