This is an old revision of the document!

Using polymake with jupyter

To use polymake with jupyter it is necessary to have jupyter installed. jupyter is provided via the package manager in many linux distributions.

Furthermore you need an installed version of polymake. This means that you need to run

ninja -C build/Opt install

in your polymake source. Then you use the polymake binary from the folder you installed polymake in.

polymake comes with a convenience script to start jupyter with a polymake kernel. You can call it in the following way:

polymake --script jupyter

The script will then ask you whether you want to install a polymake kernel with jupyter, if none is available. Furthermore it will provide you with the url to access jupyter in your browser. It will also prompt you whether it should open the browser for you. The full output may look similar to

This function installs the jupyter-polymake kernel
and the python libpolymake interface JuPyMake for the
current user (into ~/.local).
You need to have a running version of the jupyter
notebook for python3 installed.

Are you sure you want to continue with the installation? [y/N] 
Installation complete.
Do you want to start a jupyter notebook now? [y/N]
[I 12:35:04.597 NotebookApp] Serving notebooks from local directory: /home/lars/repos/cellularSheaves/demo
[I 12:35:04.598 NotebookApp] The Jupyter Notebook is running at:
[I 12:35:04.598 NotebookApp] http://localhost:8888/?token=603b26582273404c145c39657d4262f87e9656913a4e323f
[I 12:35:04.598 NotebookApp]  or
[I 12:35:04.598 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[C 12:35:04.653 NotebookApp] 
    To access the notebook, open this file in a browser:
    Or copy and paste one of these URLs:

Afterwards you will see debug output from jupyter in terminal. You can access jupyter by copying the url from the output into your browser. In many instances it will just automatically open in the browser. Not that you can only access files in the folder that you started jupyter in and its subfolders, but not above.

Sometimes an old jupyter kernel might be broken, then it is necessary to force the polymake command to install a new kernel, in the following way:

polymake --script jupyter --force

If the polymake kernel will not start, but used to start, then please force the installation of a new kernel at startup, with

polymake --script jupyter --force
  • user_guide/howto/jupyter.1608217449.txt.gz
  • Last modified: 2020/12/17 15:04
  • by lkastner