@Section
   @Title { Errors }
   @Tag { grerrors }
@Begin
@PP
Lout normally produces output that will print without mishap on
graphs. @RawIndex { graphs (statistical) }
graphs.errors @SubIndex { errors }
errors. @RawIndex { errors }
errors.in.graphs @SubIndex { in graphs }
any PostScript device.  However, some of the options of @Code "@Graph"
and all of the data and labels are passed through Lout without
checking.  Any errors in this material will not be detected
until the file is printed.
@PP
The most likely errors are @I { rangecheck errors}, for example if
an attempt is made to divide by zero or take the square root of a
negative number, and @I { undefined errors }, arising from symbols
misspelt, use of @Code "x" outside an {@Code "xloop"}, etc.  Less commonly,
everything may be correct but the graph is too large in some
way:  too much data, expression too deeply nested, and so on.
@PP
When an error is detected, @Code "@Graph" arranges for the offending page
to be printed up to where the error occurred, with a message describing
the error.  Printing of the document is then aborted.  The problem is
usually easy to locate since it lies in whatever should have been printed
next.
@PP
If you see @Code VMerror in an error message, it means that the printer
has run out of memory.  All the data is stored in the printer while the
graph is being printed, and it remains there until the end of the current
page, when it is discarded and all memory consumed by the graph is
reclaimed.  If you do run out of memory, one option is to try
graphs. @RawIndex { graphs (statistical) }
graphs.save @SubIndex { @Code save option }
save. @RawIndex { @Code "save" option }
save.in.graphs @SubIndex { in graphs }
@ID @OneRow @Code @Verbatim {
@Graph
    save { yes }
...
}
This causes the memory used by the graph to be reclaimed as soon as
the graph is printed, which might solve your problem if you have
several graphs on one page.  However, if the graph is inside some
other major package, notably {@Code "@Diag"}, this could cause
PostScript errors in that package.
@End @Section
