Unit tests

GenomicRanges

Container class to represent genomic locations and support genomic analysis in Python similar to Bioconductor's GenomicRanges.

Install

Package is published to PyPI

pip install genomicranges

Usage

The package provide several ways to represent genomic annotations and intervals.

Initialize a `GenomicRanges` object

From UCSC or GTF file

Methods are available to easily access UCSC genomes or load a genome annotation from GTF

import genomicranges

gr = genomicranges.from_gtf(<PATH TO GTF>)
# OR
gr = genomicranges.from_ucsc(genome="hg19")

Pandas DataFrame

A common representation in Python is a pandas DataFrame for all tabular datasets. One can convert this into GenomicRanges. Intervals are inclusive on both ends.

Note: DataFrame must contain columns seqnames, starts and ends to represent genomic coordinates.

import genomicranges
import pandas as pd

df = pd.DataFrame(
    {
        "seqnames": ["chr1", "chr2", "chr1", "chr3", "chr2"],
        "starts": [101, 102, 103, 104, 109],
        "ends": [112, 103, 128, 134, 111],
        "strand": ["*", "-", "*", "+", "-"],
        "score": range(0, 5),
        "GC": [random() for _ in range(5)],
    }
)

gr = genomicranges.from_pandas(df)

Interval Operations

Currently supports most commonly used interval based operations.

subject = genomicranges.from_ucsc(genome="hg38")

query = genomicranges.from_pandas(
    pd.DataFrame(
        {
            "seqnames": ["chr1", "chr2", "chr3"],
            "starts": [100, 115, 119],
            "ends": [103, 116, 120],
        }
    )
)

hits = subject.nearest(query)
print(hits)

Checkout the documentation for more usecases.

Note

This project has been set up using PyScaffold 4.1.1. For details and usage information on PyScaffold see https://pyscaffold.org/.

Release files for genomicranges 0.3.2

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

Source distribution (sdist)

Source distribution for genomicranges 0.3.2
File	Size	Uploaded
GenomicRanges-0.3.2.tar.gz	52.3 kB	Sep 1, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for genomicranges 0.3.2
File	Interpreter	ABI	Platform	Reset
GenomicRanges-0.3.2-py3-none-any.whl 30.5 kB Sep 1, 2023	Python 3	none	any	Details

Total release size: 82.8 kB

Release files / GenomicRanges-0.3.2.tar.gz

Download URL	GenomicRanges-0.3.2.tar.gz
Size	52.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`7eac9deca8059209475377f9e5255231ad128d89425461854f3285f48b8a41d3`
BLAKE2b-256 checksum How to use checksums	`fad68b790f3dc507b17748ab089d273fb4eba39fc6f43f22a07b2558779b25ef`
Upload date	Sep 1, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.9.18`

Release files / GenomicRanges-0.3.2-py3-none-any.whl

Download URL	GenomicRanges-0.3.2-py3-none-any.whl
Size	30.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a9df9fd9f60079603c95484870761415921750aa54e379e93d8fa15e96826358`
BLAKE2b-256 checksum How to use checksums	`c9955f08f98c839d60966fdd4e7f8b926fd9a05bf75ba7f53c34ae1cb52878b8`
Upload date	Sep 1, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.9.18`