DUMP

[Dump] produces a screen dump from a REPLAY of the current picture to a hard-copy
device, if one is attached to the terminal. If a file-name is required, the program will
prompt for it.

DUMP

---------------Advanced PIL command --- -

The syntax is : DUMP(ARRAY[,d1{,<d2,d3>}])

This facility dumps the non-default values of a user-declared array ARRAY to the Q1
stack file on leaving the SATELLITE. Those values will appear in Q1 when Q1 is replaced by
the stack. d1, d2 and d3 are the limits in 1,2, and 3 D to be dumped. If they are omitted,
the whole array is scanned for non-default values. This command works correctly only if
DMPSTK=T and TALK=T; otherwise it is just echoed.

DUMPC

------ Command -----------------------

Not active.

Dumping field variables

DUMPing field variables to files readable by Viewer, PHOTON and AUTOPLOT

Files of field variables can be dumped from EARTH, at selected sweeps and time steps,
for subsequent plotting by Viewer, PHOTON or AUTOPLOT. Once dumped, Viewer can produce
an animated
sequence of images which can be saved as a movie file.

The variables are selected by making the third argument of the OUTPUT command in the Q1
file a Y.

The frequency of dumping can be controlled by the integers: -

IDISPA, IDISPB and IDISPC for sweep-staged or time-step-staged dumping. These are PIL
variables which can be set in the Q1 file, or from the
Main Menu,
Output, Field Dumping panel of the Editor..

For sweep-staged dumping, CSG1 must be set to SW. The files will then carry the names
SW1, SW2, SW3, etc, in sequence. They are used for display purposes, not (unless the user
renames them) for re- starts.

For time-step-staged dumping, CSG1 is set to any character, which will then be used
together with the time step number to create the file names.

In either case, CSG2 can be set to a character used to start the name of the grid file,
for BFC cases.

The selection has no effect on the PHI (or PHIDA) files, which are always dumped at the
end of a run (unless SAVE = F) for re-starting purposes, unless the user renames these
files by setting NSAVE = file-name in Q1.

This is advantageous when the sizes of the dumped files are so inconveniently large
that disk space is insufficient and loading into Viewer takes an excessive time. If it is
desired to inspect only a subset of the fields, dumping only those fields saves time and
space.

If this renaming IS carried out, only those variables with a Y as the third output
argument will be dumped; otherwise the file will contain ALL field variables.

The dumping of sweep- or time-staged files is effected by calls from Group 19 of GREX3
to the EARTH subroutine DMPDSP. The re-start files, by contrast, are created by calls to
EARTH subroutine DUMPS.