Fibertree Notebooks

This repository contains various Jupyter notebooks that illustrate the implemention of various sparse (and dense) computations using the fibertree abstraction.

Manual local installation

See the fibertree repository for instructions on installing the fibertree Python package.

Then clone this repository and run the Jupyter notebooks:

cd fibertree-notebooks/notebooks
jupyter notebook .

Browse in the various subdirectories and invoke a notebook. A good place to start is basic/fibertree.ipynb

See FAQ below for addressing some problems.

Python virtual environment installation

Create virtual environment and install required packages

python -m venv <directory-for-venv>
source <directory-for-venv>/bin/activate

python3 -m pip install --upgrade pip
python3 -m pip install git+https://github.com/Fibertree-Project/fibertree

Get the fibertree notebooks

git clone https://github.com/Fibertree-Project/fibertree-notebooks

cd fibertree-notebooks/notebooks
jupyter-notebook .

When done, deactivate the virtual environment

deactivate

Run in a Docker container

The fibertree-docker repository provides a Docker container where one can run the fibertree notebooks without additional local installation.

FAQ

Q: How do I fix font-related errors when displaying graphics?

A: On Ubuntu/Debian systems you can try installing fonts-freefon-ttf with:

sudo apt install fonts-freefont-ttf

If you know where the fonts are on your system then you can set the environment variable FIBERTREE_FONT in Python code you can do this with something like:

   import os

   os.environ['FIBERTREE_FONT'] = 'Pillow/Tests/fonts/FreeMono.ttf'

Q: How can I get the Jupyter widgets to work?

A1: For classic Jupyter notebooks, try the following command:

jupyter nbextension enable --py widgetsnbextension

A2: To get widgets to work in Jupyter lab, try the following:

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.6/install.sh | bash
# restart bash
nvm install node
jupyter labextension install @jupyter-widgets/jupyterlab-manager