Metadata-Version: 2.4
Name: grassp
Version: 0.1.0
Summary: A python package to facilitate Organellar profiling
License: BSD 3-Clause License
Project-URL: homepage, https://github.com/czbiohub/some-package
Project-URL: documentation, https://github.com/czbiohub/some-package
Project-URL: repository, https://github.com/czbiohub/some-package
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: <4.0,>=3.7
Description-Content-Type: text/markdown
Requires-Dist: anndata
Requires-Dist: markov_clustering
Requires-Dist: matplotlib
Requires-Dist: networkx
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
Provides-Extra: dev
Requires-Dist: black~=25.1; extra == "dev"
Requires-Dist: flake8~=7.0; extra == "dev"
Requires-Dist: isort~=5.0; extra == "dev"
Requires-Dist: pre-commit~=4.0; extra == "dev"
Requires-Dist: pylint~=3.0; extra == "dev"
Requires-Dist: pytest~=8.0; extra == "dev"
Requires-Dist: xlrd; extra == "dev"
Provides-Extra: notebook
Requires-Dist: jupyter; extra == "notebook"
Requires-Dist: matplotlib; extra == "notebook"
Requires-Dist: jupytext; extra == "notebook"
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"

[![PyPI - Version](https://img.shields.io/pypi/v/grassp)](https://img.shields.io/pypi/v/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://public.czbiohub.org/comp.bio/grassp/)


[anndata]: https://anndata.readthedocs.io
[scanpy]: https://scanpy.readthedocs.io
[protdata]: https://protdata.sf.czbiohub.org
[documentation]: https://public.czbiohub.org/comp.bio/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][])
- Calculating subcellular enrichment profiles of proteins for different experimental protocols
- Annotating the subcellular location of proteins in an unsupervised and semi-supervised manner
- Detecting proteins at the interface of organelles
- Detecting multi-localizing proteins (work in progress)
- Detecting re-localizing proteins between conditions (work in progress)
- Combining multiple subcellular proteomics datasets
- Assessing subcellular resolution
- Finding the optimal experimental design for future experiments based on simulations
- Integration of multiple modalities (e.g. Lipidomics) (work in progress)

Please refer to the [documentation] for reference to individual functions and [tutorials](https://public.czbiohub.org/comp.bio/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://public.czbiohub.org/comp.bio/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://public.czbiohub.org/comp.bio/grassp/contributing.html) and open a [Pull request](https://github.com/czbiohub-sf/grassp/pulls).

## Authors

**grassp** is created and maintained by the [Computational Biology Platform](https://www.czbiohub.org/comp-biology/) at the [Chan Zuckerberg Biohub San Francisco](https://www.czbiohub.org/sf/). For details, see the [Contributors page](https://public.czbiohub.org/comp.bio/grassp/contributors.html).

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