<?
xml version=
"1.0" encoding=
"UTF-8"?>
<!-- This is an automatically generated file. -->
<Chapter Label=
"Chapter_Limitations">
<Heading>Limitations</Heading>
<P/>
When this package is being used in a Jupyter Notebook, it has the
following limitations.
<P/>
<List>
<Item>
If this package is used in <Code>PlotDisplayMethod_Jupyter</Code>
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
<Code>PlotDisplayMethod := PlotDisplayMethod_JupyterSimple</Code>,
but this increases the size of your notebook by embedding all the
JavaScript needed by the visualizations in the notebook itself.
Note that <Code>PlotDisplayMethod_Jupyter</Code> is the default
mode in the notebook.
</Item>
<Item>
The <Code>nbconvert</Code> tool, which converts <File>.ipynb</File>
files into other formats, will not
include the visualizations, because
<Code>nbconvert</Code> is not a browser that can evaluate the
JavaScript code that generates the visualizations.
</Item>
<Item>
When using the <Code>PlotDisplayMethod_Jupyter</Code> mode, most
visualizations load a JavaScript library from a CDN, which thus
requires a working Internet connection to function.
</Item>
</List>
<P/>
When it is being used from the command line, it has the following
limitations.
<P/>
<List>
<Item>
The JavaScript function <Code>runGAP</Code> introduced in Section
<Ref Sect=
"Section_plainhtml"/> 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.
</Item>
<Item>
Each new call to <Ref Func=
"Plot"/>, <Ref Func=
"PlotGraph"/>, or
<Ref Func=
"CreateVisualization"/> 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.
</Item>
</List>
<P/>
</Chapter>
