momics
momics is both a revolutionary file format for efficient storage of multi-omics data, and a Python package designed to query and manipulate these files. The file format is specifically designed to handle genomic coverage tracks and sequences. The package provides an intuitive command-line interface (CLI) and a Python library for bioinformatics workflows involving genomic data.
Install
You can install momics using pip:
pip install momics
Alternatively, clone this repository and install the package locally:
git clone https://github.com/js2264/momics.git
cd momics
pip install .
Features
- Efficient genomic data storage: Store large genomic coverage tracks and genome reference sequences compactly.
- Multi-Range querying: Query multiple genomic regions simultaneously with high performance.
- Rich Python library: Directly access and manipulate genomic data using Python objects and methods.
- Full-fledged command-line interface (CLI): Perform common tasks such as adding new tracks, querying data, and extracting information directly from the shell.
Usage
CLI Commands
- Add a track:
To ingest a .bw genomic coverage data into a momics repository, you can use the ingest command:
momics ingest tracks -f bw1=path/to/file.bw path/to/momics_repo
- Query genomic coverage:
You can query tracks using either UCSC-style coordinates or a BED file:
momics query tracks --coordinates "chr1:1-1000" path/to/momics_repo
momics query tracks --file path/to/file.bed path/to/momics_repo
Python API
In Python, you can load and query a momics repository like this:
from momics.momics import Momics
# Load a Momics repository
repo = Momics("path/to/momics_repo")
# Query tracks with coordinates
df = repo.query_tracks("chr1:1-1000")
Data Format
momics uses a custom data format that combines genomic sequences and coverage tracks in a compressed and indexed form. The format allows for rapid access to any region of the genome and supports simultaneous querying of multiple genomic regions.
Contributing
Contributions are welcome! Please submit pull requests or issues on the GitHub repository.
This project uses black to format code and ruff for linting. We also support pre-commit to ensure
these have been run. To configure your local environment, please install these development dependencies and set up
the commit hooks.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Metadata
Release files for momics 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| momics-0.4.0.tar.gz | 75.0 kB | Without provenance | Details for momics-0.4.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| momics-0.4.0-py3-none-any.whl | Python 3 | none | any | Details for momics-0.4.0-py3-none-any.whl |
Total release size: 118.9 kB
Release files / momics-0.4.0.tar.gz
| Download URL | momics-0.4.0.tar.gz |
|---|---|
| Size | 75.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1bda04915dd83fb52656d5020afc3a367ab66b4905c0c1322fce6714944b1d7e
|
|
BLAKE2b-256 checksum How to use checksums |
003c8ff1158a308a27a993bf458c7bfc88c1aa9c4441b131735dc40cd665e97a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.12.7
|
Release files / momics-0.4.0-py3-none-any.whl
| Download URL | momics-0.4.0-py3-none-any.whl |
|---|---|
| Size | 43.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4dc90ba4f8ac5031f30b516d420c1cdea86bf2be9f1b3a5053a08c3118a18e3f
|
|
BLAKE2b-256 checksum How to use checksums |
fddcc6314136f83614cc9db87ef533330f53da6256730307b10f942c0c27d7cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.12.7
|
Security for momics 0.4.0
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.