A widget enabling interactive graph visualization with cytoscape.js in JupyterLab and the Jupyter notebook.
Try it out using binder: or install and try out the examples.
py2neoavailable that's compatible with
ipycytoscape. As a provisory solution to this problem you can use the package offered by
pypiand install it with the following line:
pip install -e ".[neo4j]"
mamba install -c conda-forge ipycytoscape
conda install -c conda-forge ipycytoscape
pip install ipycytoscape
If you are using JupyterLab 1.x or 2.x then you will also need to install
nodejs and the
jupyterlab-manager extension. You can do this like so:
# installing nodejs conda install -c conda-forge nodejs # install jupyterlab-manager extension jupyter labextension install @firstname.lastname@example.org --no-build # if you have previously installed the manager you still to run jupyter lab build jupyter lab build
You may also need to manually enable the nbextension:
jupyter nbextension enable --py [--sys-prefix|--user|--system] ipycytoscape
While not required, we recommend creating a conda environment to work in:
conda create -n ipycytoscape -c conda-forge jupyterlab nodejs>13 networkx conda activate ipycytoscape # clone repo git clone https://github.com/QuantStack/ipycytoscape.git cd ipycytoscape
This will also run npm install and npm run build
pip install jupyter_packaging==0.7.9 pip install -e ".[test, doc]" jupyter labextension develop . --overwrite
Or for classic notebook, you can run:
jupyter nbextension install --sys-prefix --symlink --overwrite --py ipycytoscape jupyter nbextension enable --sys-prefix --py ipycytoscape
Note that the
--symlink flag doesn't work on Windows, so you will here have to run
install command every time that you rebuild your extension. For certain installations
you might also need another flag instead of
--sys-prefix, but we won't cover the meaning
of those flags here.
To continuously monitor the project for changes and automatically trigger a rebuild, start watching the ipycytoscape code:
npm run watch
And in a separate terminal start JupyterLab normally:
once the webpack rebuild finishes refresh the JupyterLab page to have your changes take effect.
If you make a change to the python code then you need to restart the notebook kernel to have it take effect.
Install necessary dependencies with pip:
pip install -e .[test]
Or with mamba:
mamba -c conda-forge install networkx pandas nbval pytest
Or with conda:
conda -c conda-forge install networkx pandas nbval pytest
conda env update --file doc_environment.yml
And build them:
The ipycytoscape project was started by Mariana Meireles at QuantStack. This initial development was funded as part of the PLASMA project, which is led by Claire Vandiedonck, Pierre Poulain, and Sandrine Caburet.
We use a shared copyright model that enables all contributors to maintain the copyright on their contributions.
This software is licensed under the BSD-3-Clause license. See the LICENSE file for details.