Skip to main content

Python bindings for the HiGlass viewer

Project description

HiGlass Python

HiGlass Docs Python Build Status

Python bindings to the HiGlass for tile serving, view config generation, and Jupyter Notebook + Lab integration.

This package provide access to:

  • server: a lightweight flask server
  • tilesets: tileset API
  • client: an API for generating view configs
  • viewer: an API for launching HiGlass in Jupyter Notebook or Lab

Installation

Requirements

  • Python >= 3.7
  • FUSE or MacFuse
  • Jupyter Notebook >= 5.7
  • Jupyter Lab >= 0.35

Install package

First install higlass-python via pip:

pip install higlass-python

Jupyter Notebook integration

Open a terminal and execute the following code to activate the integration:

# The following is only required if you have not enabled the ipywidgets nbextension yet
jupyter nbextension enable --py --sys-prefix widgetsnbextension
jupyter nbextension install --py --sys-prefix higlass
jupyter nbextension enable --py --sys-prefix higlass

Jupyter Lab integration

Open a terminal and execute the following code to activate the integration:

# The following is only required if you have not enabled the jupyterlab manager yet
jupyter labextension install @jupyter-widgets/jupyterlab-manager
jupyter labextension install higlass-jupyter

Getting started

Take a look at notebooks/Examples.ipynb on how to get started.

Development

  • Install the package in editable mode. (The module will be imported from the development directory, rather than copied to site-packages).

    pip install -e .
    
  • Build and enable the Jupyter Notebook Extension. (With the --symlink option, the assets in higlass/static are linked to the extension registry rather than copied.)

    python setup.py jsdeps
    jupyter nbextension enable --py --sys-prefix widgetsnbextension
    jupyter nbextension install --py --symlink --sys-prefix higlass
    jupyter nbextension enable --py --sys-prefix higlass
    
  • Uninstall the Jupyter Notebook Extension

    jupyter nbextension uninstall --py --sys-prefix higlass
    
  • Experimental: install the Jupyter Lab Extension

    cd js && jupyter labextension link .
    

Troubleshooting

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

higlass-python-0.4.3.tar.gz (5.8 MB view details)

Uploaded Source

Built Distribution

higlass_python-0.4.3-py3.7.egg (4.0 MB view details)

Uploaded Source

File details

Details for the file higlass-python-0.4.3.tar.gz.

File metadata

  • Download URL: higlass-python-0.4.3.tar.gz
  • Upload date:
  • Size: 5.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.7

File hashes

Hashes for higlass-python-0.4.3.tar.gz
Algorithm Hash digest
SHA256 bcded89fdbe8844d1803849b3520bb8481e4cf156bc75d2a35039fea53a673d4
MD5 4960a4e3dc8d4ca60a51aba214b7b10f
BLAKE2b-256 ca19f699e47db5f8bb3e167c1770ca87e4b4d975d7ae73add3c9612b2029a76e

See more details on using hashes here.

File details

Details for the file higlass_python-0.4.3-py3.7.egg.

File metadata

  • Download URL: higlass_python-0.4.3-py3.7.egg
  • Upload date:
  • Size: 4.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.7

File hashes

Hashes for higlass_python-0.4.3-py3.7.egg
Algorithm Hash digest
SHA256 3ad28ca2044afdd1211edec8b52339027ae1230d4f5171f9f466bb2254170461
MD5 4a35f9d6f06df3d087a26ecde9997287
BLAKE2b-256 d0e24691d3b970f07f2ff8f9bcb0c8e617a6d4c00e15b973940318f0d71cd6e2

See more details on using hashes here.

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