Skip to main content

CenPlot

PyPI - Version CI docs

A Python library for producing centromere figures.

CDR plot.
HOR plot.
Combined plot.
Identity plots.

Getting Started

Install the package from pypi.

pip install cenplot

CLI

Generating a split HOR tracks using the cenplot draw command and an input layout.

# examples/example_cli.sh
cenplot draw \
-t examples/tracks_hor.toml \
-c "chm13_chr10:38568472-42561808" \
-p 4 \
-d plots \
-o "plot/merged_image.png"

Python API

The same HOR track can be created with a few lines of code.

# examples/example_api.py
from cenplot import plot_tracks, read_tracks

chrom = "chm13_chr10:38568472-42561808"
track_list, settings = read_tracks("examples/tracks_hor.toml", chrom=chrom)
fig, axes, _ = plot_tracks(track_list.tracks, settings)

Development

Requires Python >= 3.12 and Git LFS to pull test files.

Create a venv, build cenplot, and install it. Also, generate the docs.

which python3.12 pip
git lfs install && git lfs pull
make dev && make build && make install
pdoc ./cenplot -o docs/

The generated venv will have the cenplot script.

# source venv/bin/activate
venv/bin/cenplot -h

To run tests.

make test

Documentation

Read the documentation here.

Cite

Gao S, Oshima KK, Chuang SC, Loftus M, Montanari A, Gordon DS, Human Genome Structural Variation Consortium, Human Pangenome Reference Consortium, Hsieh P, Konkel MK, Ventura M, Logsdon GA. A global view of human centromere variation and evolution. bioRxiv. 2025. p. 2025.12.09.693231. doi:10.64898/2025.12.09.693231

Metadata

Release files for cenplot 0.1.6

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

Source distribution (sdist)

Source distribution for cenplot 0.1.6
File Size Uploaded Provenance Actions
cenplot-0.1.6.tar.gz 32.9 kB Without provenance Details for cenplot-0.1.6.tar.gz

Built distribution (wheel)

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

Total release size: 75.1 kB

Release files / cenplot-0.1.6.tar.gz

Download URL cenplot-0.1.6.tar.gz
Size 32.9 kB
Tags Source
SHA-256 checksum
How to use checksums
cf86b7e05e93acef8a8b4088bd6968fd1052dd9f38439f240c664f20a7ee2240
BLAKE2b-256 checksum
How to use checksums
05e7c9aed73447edcdd2fd1ec228c5ef7d0b99336173eda19970be0cf6834507
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Release files / cenplot-0.1.6-py3-none-any.whl

Download URL cenplot-0.1.6-py3-none-any.whl
Size 42.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6c8b240dfbe4ebe283c3ff6fca5cfc392881ca02ea9449205f0e07342a9d177f
BLAKE2b-256 checksum
How to use checksums
6e07e15e091478703e705fce480c84b347009b4dea3f9d5011a79a31ef02d21e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Security for cenplot 0.1.6

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