Python bindings for the HiGlass viewer
Project description
# HiGlass Python
[![HiGlass](https://img.shields.io/badge/higlass-👍-red.svg?colorB=45afe5)](http://higlass.io) [![Docs](https://img.shields.io/badge/docs-🎉-red.svg?colorB=6680ff)](https://higlass.io/docs/python_api.html) [![Python](https://img.shields.io/badge/python-😍-red.svg?colorB=af80ff)](https://higlass.io/docs/python_api.html)
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
### Requirements
Python >= 3.7
[FUSE](https://github.com/libfuse/libfuse) or [MacFuse](https://osxfuse.github.io/)
Jupyter Notebook >= 5.7
Jupyter Lab >= 0.35
### Installation
First install higlass-python via pip:
`bash pip install higlass-python `
#### Jupyter notebook integration
Open a terminal and execute the following code to activate the integration:
`bash # 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 notebook integration
Open a terminal and execute the following code to activate the integration:
`bash # 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](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).
`bash 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.)
`bash 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
`bash jupyter nbextension uninstall --py --sys-prefix higlass `
Experimental: install the Jupyter Lab Extension
`bash cd js && jupyter labextension link . `
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file higlass-python-0.1.5.tar.gz
.
File metadata
- Download URL: higlass-python-0.1.5.tar.gz
- Upload date:
- Size: 3.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: Python-urllib/3.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7d31f702ea2a1230d850cf27f4cc986e0a1d823feb53e3cfc13adaf573cc573b |
|
MD5 | 72d3b51ddcf69807881e5d16629a44a7 |
|
BLAKE2b-256 | 4283a6c78df1c8fafcf9891b8e5f58f1f998e4be2f620bd9f65e7031a6b5a76a |