<!--
Copyright (C) 2024 Roberto Rossini <roberros@uio.no>
SPDX-License-Identifier: MIT
-->
# StripePy
---
<!-- markdownlint-disable MD033 -->
<table>
<tr>
<td>Paper</td>
<td>
<a href="https://doi.org/10.1093/bioinformatics/btaf351">
<img src="https://img.shields.io/badge/CITE-Bioinformatics%20(2025)-blue" alt="Bioinformatics 2025">
</a>
</td>
</tr>
<tr>
<td>Downloads</td>
<td>
<a href="https://anaconda.org/bioconda/stripepy-hic">
<img src="https://img.shields.io/conda/vn/bioconda/stripepy-hic?label=bioconda&logo=Anaconda" alt="Bioconda">
</a>
 
<a href="https://pypi.org/project/stripepy-hic/">
<img src="https://img.shields.io/pypi/v/stripepy-hic" alt="PyPI">
</a>
 
<a href="https://doi.org/10.5281/zenodo.14394041">
<img src="https://zenodo.org/badge/DOI/10.5281/zenodo.14394042.svg" alt="Zenodo">
</a>
</td>
</tr>
<tr>
<tr>
<td>Documentation</td>
<td>
<a href="https://stripepy.readthedocs.io">
<img src="https://app.readthedocs.org/projects/stripepy/badge/?version=stable&style=flat" alt="Documentation">
</a>
</td>
</tr>
<td>CI</td>
<td>
<a href="https://github.com/paulsengroup/StripePy/actions/workflows/ci.yml">
<img src="https://github.com/paulsengroup/StripePy/actions/workflows/ci.yml/badge.svg" alt="Ubuntu CI Status">
</a>
 
<a href="https://github.com/paulsengroup/StripePy/actions/workflows/build-dockerfile.yml">
<img src="https://github.com/paulsengroup/StripePy/actions/workflows/build-dockerfile.yml/badge.svg" alt="Build Dockerfile Status">
</a>
</td>
</tr>
<tr>
<td>License</td>
<td>
<a href="https://github.com/paulsengroup/StripePy/blob/main/LICENCE">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
</a>
</td>
</tr>
</table>
<!-- markdownlint-enable MD033 -->
---
StripePy is a CLI application written in Python that recognizes architectural stripes found in the interaction matrix files
generated by Chromosome Conformation Capture experiments, such as Hi-C and Micro-C.
StripePy is developed on Linux and macOS and is also tested on Windows. Installing StripePy is quick and easy using pip:
```bash
pip install 'stripepy-hic[all]'
```
For other installation options (conda, source, and Docker or Singularity/Apptainer), and details on ensuring StripePy is in your `PATH`, please refer to the official [documentation](https://stripepy.readthedocs.io).
## Why Choose StripePy?
StripePy stands out with several key features that make it a fast and robust stripe caller:
- **Broad Format Support**: Compatible with major formats: `.hic`, `.cool` and `.mcool`; outputs to `.hdf5` and `BEDPE`.
- **User-Friendly**: Designed with an intuitive command-line interface, making stripe analysis accessible even to less experienced users.
- **Stripe descriptors**: Computes stripe width, height, and generates various statistics for post-processing, e.g., ranking and filtering.
- **Optimized performance**: Outperforms other tools over diverse datasets and a simulated benchmark, StripeBench.
- **Exceptional speed & Low Memory**: Significantly faster than existing tools (2x Chromosight, 66x Stripenn), with much lower memory usage.
## Key Features
StripePy is organized into a few subcommands:
<!-- markdownlint-disable MD059 -->
- `stripepy download`: download a minified sample dataset suitable to quickly test StripePy - [link](https://stripepy.readthedocs.io/en/stable/downloading_sample_datasets.html).
- `stripepy call`: run the stripe detection algorithm and store the identified stripes in a `.hdf5` file - [link](https://stripepy.readthedocs.io/en/stable/detect_stripes.html).
- `stripepy view`: take the `result.hdf5` file generated by `stripepy call` and extract stripes in BEDPE format - [link](https://stripepy.readthedocs.io/en/stable/fetch_stripes.html).
- `stripepy plot`: generate various kinds of plots to inspect the stripes identified by `stripepy call`- [link](https://stripepy.readthedocs.io/en/stable/generate_plots.html).
<!-- markdownlint-enable MD059 -->
For a quick introduction to the tool, refer to the [Quickstart](https://stripepy.readthedocs.io/en/stable/quickstart.html) section in the documentation.
For more information on the subcommands, please run `stripepy --help` and refer to the [documentation](https://stripepy.readthedocs.io/en/stable/cli_reference.html) and the [paper](https://doi.org/10.1093/bioinformatics/btaf351).
## Getting help
For any issues regarding StripePy installation, walkthrough, and output interpretation please open a [discussion](https://github.com/paulsengroup/StripePy/discussions) on GitHub.
If you've found a bug or would like to suggest a new feature, please open a new [issue](https://github.com/paulsengroup/StripePy/issues) instead.
## Citing
If you use StripePy in your research, please cite the following publication:
Andrea Raffo, Roberto Rossini, Jonas Paulsen\
StripePy: fast and robust characterization of architectural stripes\
_Bioinformatics_, Volume 41, Issue 6, June 2025, btaf351\
[https://doi.org/10.1093/bioinformatics/btaf351](https://doi.org/10.1093/bioinformatics/btaf351)
<details>
<summary>BibTex</summary>
```bibtex
@article{stripepy,
author = {Raffo, Andrea and Rossini, Roberto and Paulsen, Jonas},
title = {{StripePy: fast and robust characterization of architectural stripes}},
journal = {Bioinformatics},
volume = {41},
number = {6},
pages = {btaf351},
year = {2025},
month = {06},
issn = {1367-4811},
doi = {10.1093/bioinformatics/btaf351},
url = {https://doi.org/10.1093/bioinformatics/btaf351},
eprint = {https://academic.oup.com/bioinformatics/article-pdf/41/6/btaf351/63484367/btaf351.pdf},
}
```
</details>
Raw data
{
"_id": null,
"home_page": null,
"name": "stripepy-hic",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Andrea Raffo <andrea.raffo@ibv.uio.no>, Roberto Rossini <roberros@uio.no>",
"keywords": "architectural stripe, contact map, cooler, hi-c, hic, stripe, stripe recognition, stripes",
"author": null,
"author_email": "Andrea Raffo <andrea.raffo@ibv.uio.no>, Roberto Rossini <roberros@uio.no>",
"download_url": "https://files.pythonhosted.org/packages/88/59/aa55a10cf89397ebe0ad0485d8fd14daacf61308163a765b30aeb4e9d265/stripepy_hic-1.2.1.tar.gz",
"platform": null,
"description": "<!--\nCopyright (C) 2024 Roberto Rossini <roberros@uio.no>\n\nSPDX-License-Identifier: MIT\n-->\n\n# StripePy\n\n---\n\n<!-- markdownlint-disable MD033 -->\n\n<table>\n <tr>\n <td>Paper</td>\n <td>\n <a href=\"https://doi.org/10.1093/bioinformatics/btaf351\">\n <img src=\"https://img.shields.io/badge/CITE-Bioinformatics%20(2025)-blue\" alt=\"Bioinformatics 2025\">\n </a>\n </td>\n </tr>\n <tr>\n <td>Downloads</td>\n <td>\n <a href=\"https://anaconda.org/bioconda/stripepy-hic\">\n <img src=\"https://img.shields.io/conda/vn/bioconda/stripepy-hic?label=bioconda&logo=Anaconda\" alt=\"Bioconda\">\n </a>\n  \n <a href=\"https://pypi.org/project/stripepy-hic/\">\n <img src=\"https://img.shields.io/pypi/v/stripepy-hic\" alt=\"PyPI\">\n </a>\n  \n <a href=\"https://doi.org/10.5281/zenodo.14394041\">\n <img src=\"https://zenodo.org/badge/DOI/10.5281/zenodo.14394042.svg\" alt=\"Zenodo\">\n </a>\n </td>\n </tr>\n <tr>\n <tr>\n <td>Documentation</td>\n <td>\n <a href=\"https://stripepy.readthedocs.io\">\n <img src=\"https://app.readthedocs.org/projects/stripepy/badge/?version=stable&style=flat\" alt=\"Documentation\">\n </a>\n </td>\n </tr>\n <td>CI</td>\n <td>\n <a href=\"https://github.com/paulsengroup/StripePy/actions/workflows/ci.yml\">\n <img src=\"https://github.com/paulsengroup/StripePy/actions/workflows/ci.yml/badge.svg\" alt=\"Ubuntu CI Status\">\n </a>\n  \n <a href=\"https://github.com/paulsengroup/StripePy/actions/workflows/build-dockerfile.yml\">\n <img src=\"https://github.com/paulsengroup/StripePy/actions/workflows/build-dockerfile.yml/badge.svg\" alt=\"Build Dockerfile Status\">\n </a>\n </td>\n </tr>\n <tr>\n <td>License</td>\n <td>\n <a href=\"https://github.com/paulsengroup/StripePy/blob/main/LICENCE\">\n <img src=\"https://img.shields.io/badge/license-MIT-green\" alt=\"License\">\n </a>\n </td>\n </tr>\n</table>\n\n<!-- markdownlint-enable MD033 -->\n\n---\n\nStripePy is a CLI application written in Python that recognizes architectural stripes found in the interaction matrix files\ngenerated by Chromosome Conformation Capture experiments, such as Hi-C and Micro-C.\n\nStripePy is developed on Linux and macOS and is also tested on Windows. Installing StripePy is quick and easy using pip:\n\n```bash\npip install 'stripepy-hic[all]'\n```\n\nFor other installation options (conda, source, and Docker or Singularity/Apptainer), and details on ensuring StripePy is in your `PATH`, please refer to the official [documentation](https://stripepy.readthedocs.io).\n\n## Why Choose StripePy?\n\nStripePy stands out with several key features that make it a fast and robust stripe caller:\n\n- **Broad Format Support**: Compatible with major formats: `.hic`, `.cool` and `.mcool`; outputs to `.hdf5` and `BEDPE`.\n- **User-Friendly**: Designed with an intuitive command-line interface, making stripe analysis accessible even to less experienced users.\n- **Stripe descriptors**: Computes stripe width, height, and generates various statistics for post-processing, e.g., ranking and filtering.\n- **Optimized performance**: Outperforms other tools over diverse datasets and a simulated benchmark, StripeBench.\n- **Exceptional speed & Low Memory**: Significantly faster than existing tools (2x Chromosight, 66x Stripenn), with much lower memory usage.\n\n## Key Features\n\nStripePy is organized into a few subcommands:\n\n<!-- markdownlint-disable MD059 -->\n\n- `stripepy download`: download a minified sample dataset suitable to quickly test StripePy - [link](https://stripepy.readthedocs.io/en/stable/downloading_sample_datasets.html).\n- `stripepy call`: run the stripe detection algorithm and store the identified stripes in a `.hdf5` file - [link](https://stripepy.readthedocs.io/en/stable/detect_stripes.html).\n- `stripepy view`: take the `result.hdf5` file generated by `stripepy call` and extract stripes in BEDPE format - [link](https://stripepy.readthedocs.io/en/stable/fetch_stripes.html).\n- `stripepy plot`: generate various kinds of plots to inspect the stripes identified by `stripepy call`- [link](https://stripepy.readthedocs.io/en/stable/generate_plots.html).\n\n<!-- markdownlint-enable MD059 -->\n\nFor a quick introduction to the tool, refer to the [Quickstart](https://stripepy.readthedocs.io/en/stable/quickstart.html) section in the documentation.\n\n\n\nFor more information on the subcommands, please run `stripepy --help` and refer to the [documentation](https://stripepy.readthedocs.io/en/stable/cli_reference.html) and the [paper](https://doi.org/10.1093/bioinformatics/btaf351).\n\n## Getting help\n\nFor any issues regarding StripePy installation, walkthrough, and output interpretation please open a [discussion](https://github.com/paulsengroup/StripePy/discussions) on GitHub.\n\nIf you've found a bug or would like to suggest a new feature, please open a new [issue](https://github.com/paulsengroup/StripePy/issues) instead.\n\n## Citing\n\nIf you use StripePy in your research, please cite the following publication:\n\nAndrea Raffo, Roberto Rossini, Jonas Paulsen\\\nStripePy: fast and robust characterization of architectural stripes\\\n_Bioinformatics_, Volume 41, Issue 6, June 2025, btaf351\\\n[https://doi.org/10.1093/bioinformatics/btaf351](https://doi.org/10.1093/bioinformatics/btaf351)\n\n<details>\n<summary>BibTex</summary>\n\n```bibtex\n@article{stripepy,\n author = {Raffo, Andrea and Rossini, Roberto and Paulsen, Jonas},\n title = {{StripePy: fast and robust characterization of architectural stripes}},\n journal = {Bioinformatics},\n volume = {41},\n number = {6},\n pages = {btaf351},\n year = {2025},\n month = {06},\n issn = {1367-4811},\n doi = {10.1093/bioinformatics/btaf351},\n url = {https://doi.org/10.1093/bioinformatics/btaf351},\n eprint = {https://academic.oup.com/bioinformatics/article-pdf/41/6/btaf351/63484367/btaf351.pdf},\n}\n```\n\n</details>\n",
"bugtrack_url": null,
"license": null,
"summary": "StripePy recognizes architectural stripes in 3C and Hi-C contact maps using geometric reasoning",
"version": "1.2.1",
"project_urls": {
"Homepage": "https://github.com/paulsengroup/StripePy",
"Issues": "https://github.com/paulsengroup/StripePy/issues",
"Repository": "https://github.com/paulsengroup/StripePy.git",
"Source": "https://github.com/paulsengroup/StripePy"
},
"split_keywords": [
"architectural stripe",
" contact map",
" cooler",
" hi-c",
" hic",
" stripe",
" stripe recognition",
" stripes"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c40aa79438b608ed9ce24fa673419524532034fe2ff9afcbf0d3e098a1bd798b",
"md5": "6c6460d6756c85372fca745681aed688",
"sha256": "35a0699e0ea08b0c7923155a70ee398b69ff82b4d845fb013513add949a2daaf"
},
"downloads": -1,
"filename": "stripepy_hic-1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6c6460d6756c85372fca745681aed688",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 95459,
"upload_time": "2025-10-28T12:21:33",
"upload_time_iso_8601": "2025-10-28T12:21:33.817481Z",
"url": "https://files.pythonhosted.org/packages/c4/0a/a79438b608ed9ce24fa673419524532034fe2ff9afcbf0d3e098a1bd798b/stripepy_hic-1.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8859aa55a10cf89397ebe0ad0485d8fd14daacf61308163a765b30aeb4e9d265",
"md5": "ae85a6d1c6b30d83f8f94a16fcb8ecaa",
"sha256": "2bb08c21f3c08ce68aee89bf2c7f6354377117a0990ffb95d67c40faec815823"
},
"downloads": -1,
"filename": "stripepy_hic-1.2.1.tar.gz",
"has_sig": false,
"md5_digest": "ae85a6d1c6b30d83f8f94a16fcb8ecaa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 3770636,
"upload_time": "2025-10-28T12:21:35",
"upload_time_iso_8601": "2025-10-28T12:21:35.897664Z",
"url": "https://files.pythonhosted.org/packages/88/59/aa55a10cf89397ebe0ad0485d8fd14daacf61308163a765b30aeb4e9d265/stripepy_hic-1.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-28 12:21:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "paulsengroup",
"github_project": "StripePy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "stripepy-hic"
}
JSON
