Skip to main content

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: The 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.0

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.0
File Size Uploaded
GenomicRanges-0.3.0.tar.gz 49.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for genomicranges 0.3.0
File Interpreter ABI Platform
GenomicRanges-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 77.6 kB

Release files / GenomicRanges-0.3.0.tar.gz

Download URL GenomicRanges-0.3.0.tar.gz
Size 49.2 kB
Tags Source
SHA-256 checksum
How to use checksums
d400cc3d5da65f5f13b1304d5dadc376b886b447b88ca2d3e259466508a2c4c9
BLAKE2b-256 checksum
How to use checksums
948b4f95086864b17703d769ed5a4cb5e657eba954b1abd28eac07baee93e428
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.17

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

Download URL GenomicRanges-0.3.0-py3-none-any.whl
Size 28.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a750a652cbab1d5276b709e34e33610984255275696bce4ae62bf1f0064ac6fd
BLAKE2b-256 checksum
How to use checksums
b451821a6875d5cd622750039b59a1135ae161c77e05f8f308614f2dc26caa08
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.17

Release history Release notifications | RSS feed

0.9.0

2 release files

0.8.5

2 release files

0.8.4

2 release files

0.8.3

2 release files

0.8.2

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.3

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.34

2 release files

0.4.33

2 release files

0.4.32

2 release files

0.4.30

2 release files

0.4.29

2 release files

0.4.28

2 release files

0.4.27

2 release files

0.4.26

2 release files

0.4.25

2 release files

0.4.23

2 release files

0.4.22

2 release files

0.4.21

2 release files

0.4.20

2 release files

0.4.19

2 release files

0.4.18

2 release files

0.4.17

2 release files

0.4.16

2 release files

0.4.15

2 release files

0.4.14

2 release files

0.4.13

2 release files

0.4.12

2 release files

0.4.11

2 release files

0.4.10

2 release files

0.4.9

2 release files

0.4.8

2 release files

0.4.7

2 release files

0.4.6

2 release files

0.4.5

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.9

2 release files

0.3.8

2 release files

0.3.7

2 release files

0.3.6

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

This release

0.3.0 This release

2 release files

0.2.11

2 release files

0.2.10

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2

2 release files

0.1.1

2 release files

0.1

2 release files

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