user_guide:howto:jupyter

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
user_guide:howto:jupyter [2020/12/17 20:50] – [Prerequisites] Add some samples on how to install jupyter on linux lkastneruser_guide:howto:jupyter [2021/06/15 09:02] (current) – [jupyter] Try other browser lkastner
Line 9: Line 9:
 ninja -C build/Opt install ninja -C build/Opt install
 </code> </code>
-in your polymake source. Then please use the polymake binary from the folder you installed polymake in.+if working with the polymake source. Then please use the polymake binary from the folder you installed polymake in
 + 
 +If you use a version of polymake installed via your package manager, make sure you have the ''polymake-config'' binary. Try running 
 +<code> 
 +polymake-config --version 
 +</code> 
 +in a terminal. For example for Ubuntu it is not enough to have the ''polymake'' package installed, you will also need ''libpolymake-dev''.
  
 ===== Setup ===== ===== Setup =====
Line 56: Line 62:
  
 ===== Troubleshooting ===== ===== Troubleshooting =====
 +If the polymake kernel does not start for you, look at the output of jupyter in the terminal and search for any error messages.
 +
 +If you experience issues it makes sense to try a different browser.
 +
 +==== JuPyMake.PolymakeError: polymake::Main - /usr/lib/polymake/shared is not a symlink ====
 +This error sometimes appears with polymake installed by the package manager. It can be fixed by manually setting the symlink
 +<code>
 +cd /usr/lib/polymake
 +sudo ln -s ../../share/polymake shared
 +</code>
 +
 +
 +==== polymake configuration ====
 +The default configuration used by the jupyter kernel is the one in ''$HOME/.polymake''. If you need to reconfigure a rules file, it is easiest to reconfigure it outside of jupyter. Note that the configuration is only saved to ''$HOME/.polymake'' once polymake gets closed using ''exit;''.
 +
 +Advance users can use a different configuration folder in the following way:
 +<code>
 +alias jupymake="env POLYMAKE_USER_DIR=$HOME/.polymake-jupyter jupyter notebook --notebook-dir=$HOME/jupyter-notebooks"
 +</code>
  
 ==== polymake kernel does not start ==== ==== polymake kernel does not start ====
  • user_guide/howto/jupyter.txt
  • Last modified: 2021/06/15 09:02
  • by lkastner