Skip to main content

Fast visualization of genomic data

Project description

GitHub release PyPI version genomeshader

Genomeshader is a Rust-backed Python library for rapid visualization of read-level data spanning variants across huge numbers of samples. It is intended for use within Jupyter notebooks.

Documentation for the API can be found on the documentation page.

Prerequisites

Genomeshader is designed to access local files or data in Google Cloud Storage (GCS). Within certain cloud-computing environments (i.e. Terra, All of Us Researcher Workbench), access to GCS is already configured. For accessing files in GCS on your local machine, you will also need to install the Google Cloud CLI. Then, configure your Application Default Credentials (ADC).

Installation

pip is recommended for installation.

pip install genomeshader

Building from source

To build from source (particularly for those interested in contributing to the code), follow the procedure below.

# Clone repository.
git clone https://github.com/broadinstitute/genomeshader.git
cd genomeshader

# Create a Python virtual environment and install Maturin, the tool that
# will compile the Rust and Python code into a complete library.
# For more information on Maturin, visit https://github.com/PyO3/maturin .
python -mvenv venv
. venv/bin/activate
pip install maturin

# Build the library (with release optimizations) and install it in
# the currently active virtual environment.
maturin develop --release

Supported platforms

Genomeshader is compiled for Linux and MacOSX. Windows is not currently supported.

Getting help

If you encounter bugs or have questions/comments/concerns, please file an issue on our Github page.

Developers’ guide

For information on contributing to Genomeshader development, visit our developer documentation.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

genomeshader-0.1.75.tar.gz (231.6 kB view hashes)

Uploaded Source

Built Distributions

genomeshader-0.1.75-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (19.4 MB view hashes)

Uploaded CPython 3.7+ manylinux: glibc 2.17+ x86-64

genomeshader-0.1.75-cp37-abi3-macosx_11_0_arm64.whl (15.3 MB view hashes)

Uploaded CPython 3.7+ macOS 11.0+ ARM64

genomeshader-0.1.75-cp37-abi3-macosx_10_12_x86_64.whl (15.9 MB view hashes)

Uploaded CPython 3.7+ macOS 10.12+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page