Limitations

When this package is being used in a Jupyter Notebook, it has the following limitations.

If this package is used in `PlotDisplayMethod_Jupyter` mode in a Jupyter notebook, and visualizations are created by this package, then the notebook is saved and later reloaded, the visualizations will not persist. They will be replaced by an error message instructing the user to re-run the cell that created the visualization. You can get around this by setting `PlotDisplayMethod := PlotDisplayMethod_JupyterSimple`, but this increases the size of your notebook by embedding all the JavaScript needed by the visualizations in the notebook itself. Note that `PlotDisplayMethod_Jupyter` is the default mode in the notebook. The `nbconvert` tool, which converts .ipynb files into other formats, will not include the visualizations, because `nbconvert` is not a browser that can evaluate the JavaScript code that generates the visualizations. When using the `PlotDisplayMethod_Jupyter` mode, most visualizations load a JavaScript library from a CDN, which thus requires a working Internet connection to function.

When it is being used from the command line, it has the following limitations.

The JavaScript function `runGAP` introduced in Section is not available. That function depends upon the ability to ask the Jupyter Kernel to run &GAP; code, and thus when there is no Jupyter Kernel, that function cannot work. Each new call to , , or will be stored in a new temporary file on the user's filesystem and thus shown in a new tab or window in the user's browser. That is, one does not iteratively improve a single visualization, but is forced to open a new window or tab for each call.