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 4.3 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 Plot (7.1-1), PlotGraph (7.1-3), or CreateVisualization (7.2-5) 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.
generated by GAPDoc2HTML