Python bindings for HiGlass
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Project description
higlass-python 🔎
A fresh Python library for higlass built
on top of:
higlass-schema: Pydantic models for HiGlass.higlass-widget: A cross-platform AnyWidget for Jupyter environments.
Installation
pip install higlass-python
Usage
import higlass as hg
# Remote data source (tileset)
tileset1 = hg.remote(
uid="CQMd6V_cRw6iCI_-Unl3PQ",
server="https://higlass.io/api/v1/",
name="Rao et al. (2014) GM12878 MboI (allreps) 1kb",
)
# Local tileset
tileset2 = hg.cooler("../data/dataset.mcool")
# Create a `hg.HeatmapTrack` for each tileset
track1 = tileset1.track("heatmap")
track2 = tileset2.track("heatmap")
# Create two independent `hg.View`s, one for each heatmap
view1 = hg.view(track1, width=6)
view2 = hg.view(track2, width=6)
# Lock zoom & location for each `View`
view_lock = hg.lock(view1, view2)
# Concatenate views horizontally and apply synchronization lock
(view1 | view2).locks(view_lock)
To learn more about the new API, check out the updated documentation.
Upgrade Guide
higlass-python v1.0 is a total rewrite of our prior implementation, aimed to offer a more ergonomic and flexible API. While this might present challenges when upgrading existing code, we've prepared documentation to guide you through the new API usage.
If you find a missing feature, please open an issue – we're committed to supporting your use cases with the new API.
Despite the large changes in v1.0, we will strive to avoid breaking changes going forward. However, because of the complete rewrite, the v1.0 release doesn't strictly adhere to semantic versioning. You can think of it as a pre-1.0 release, with breaking changes and new features included in minor releases, and bug fixes in patch releases.
We will aim for strict semantic versioning with the v2.0 release. Your feedback and understanding are greatly appreciated.
Development
higlass-python uses uses uv for development.
Commands Cheatsheet
All commands are run from the root of the project, from a terminal:
| Command | Action |
|---|---|
uv run ruff check --fix && uv run ruff format |
Lint and apply formatting |
uv run check |
Check linting rules |
uv run ruff format --check |
Check formatting |
uv run pytest |
Run unit tests |
uv run docs/build.py |
Build the documentation in docs/_build/html |
This table now includes only the UV-related commands, with each command in the left column and its corresponding action in the right column. The formatting is clean and easy to read.
Our CI enforces formatting, linting, and tests.
Project details
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file higlass_python-1.1.1.tar.gz.
File metadata
- Download URL: higlass_python-1.1.1.tar.gz
- Upload date:
- Size: 17.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | be3821e9884715f13921715531b5ea876c7c448576c67b7b54fda74359d76267 |
|
| MD5 | a88deaf2acb0c62da2f0e7d6d2337990 |
|
| BLAKE2b-256 | c11d14762ad6ada989cebae04f504f956f91bf8ecb899df2c3853d89abd860e5 |
Provenance
The following attestation bundles were made for higlass_python-1.1.1.tar.gz:
Publisher:
ci.yml on higlass/higlass-python
-
Statement type:
https://in-toto.io/Statement/v1- Predicate type:
https://docs.pypi.org/attestations/publish/v1 - Subject name:
higlass_python-1.1.1.tar.gz - Subject digest:
be3821e9884715f13921715531b5ea876c7c448576c67b7b54fda74359d76267 - Sigstore transparency entry: 147811333
- Sigstore integration time:
- Predicate type:
File details
Details for the file higlass_python-1.1.1-py2.py3-none-any.whl.
File metadata
- Download URL: higlass_python-1.1.1-py2.py3-none-any.whl
- Upload date:
- Size: 21.1 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6eb643158daaeab16879a29fc52cf0451d71bb3c391232369a9b5db63768fbbf |
|
| MD5 | 6ac4a94e6196b3bcbeaa4761461b2394 |
|
| BLAKE2b-256 | 1b210190736fc80013c4f3b45583a36e8f34ae6840c188a891363e3b86fb0bc7 |
Provenance
The following attestation bundles were made for higlass_python-1.1.1-py2.py3-none-any.whl:
Publisher:
ci.yml on higlass/higlass-python
-
Statement type:
https://in-toto.io/Statement/v1- Predicate type:
https://docs.pypi.org/attestations/publish/v1 - Subject name:
higlass_python-1.1.1-py2.py3-none-any.whl - Subject digest:
6eb643158daaeab16879a29fc52cf0451d71bb3c391232369a9b5db63768fbbf - Sigstore transparency entry: 147811335
- Sigstore integration time:
- Predicate type:
