Python bindings for the HiGlass viewer
Project description
HiGlass Python
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 & < 1.0
- ipywidgets <= 7.4.2
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
--symlinkoption, the assets inhiglass/staticare 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
- If you are running JupyterLab
v1.xand ipywidgetsv7.5and the HiGlass widget is not being displayed! Then you might have an incompatible widget installed that makes all other widgets fail. Try to deinstall all other widgets to test HiGlass separately before submitting a ticket. For more information see https://github.com/jupyter-widgets/ipywidgets/issues/2483#issuecomment-508643088
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.2.1.tar.gz.
File metadata
- Download URL: higlass-python-0.2.1.tar.gz
- Upload date:
- Size: 3.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 1fd8af4d4e100c25863fb55f4d0df5703b68ac3ef0799c4e756bc59e068063d7 |
|
| MD5 | 3149183206af040887f0e8fb0e4123f4 |
|
| BLAKE2b-256 | fda9d946609423dcb876a7c199682539eec741d15a4a6ac94d0490ab1c1ff71c |
