Documentation of PLOT3D Version 3     23 May 1986

PLOT3D sections:
	1.  Commands
		Includes MAIN (dimension for WORK), PLOT3D (command level
		routine), subroutines for handling all commands (definition of
		syntax, setting up of information for execution, and execution
		of most commands).
	3.  2D
		Make 2D plots, including contour lines, line plots, vectors,
		particle traces, and shocks.
		(a)  Grid
			Grid plotting routines, such as walls, grid subsets,
			and hole boundaries.  (Function numbers 0-99.)
		(b)  Scalar variables
			Calculation of variables, calling contour
			routines, plotting contour lines or function surface
			(line) plots.  (Functions 100-199.)
		(c)  Vector variables
			Calculation of variables and plotting of vectors.
			(Functions 200-299.)
		(d)  Particle traces
			Calculation of vector variable, handling of rake start
			and continuation points, saving and plotting of
			particle traces.  (Functions 300-399.)
		(e)  Shock waves
			A "special" category for Euler/Navier-Stokes datasets.
			Calculation of necessary variables, calling special
			version of contour routines.  (Functions 400-499.)
	4.  3D
		Make 3D plots, including contour lines, function surface
		(carpet) plots, vectors, particle traces, and shocks.
		(a)  Grid
			Grid plotting routines, such as walls, grid subsets,
			and hole boundaries.  (Function numbers 0-99.)
		(b)  Scalar variables
			Calculation of variables, calling contour
			routines, plotting contour lines or function surface
			(carpet) plots.  (Functions 100-199.)
		(c)  Vector variables
			Calculation of variables and plotting of vectors.
			(Functions 200-299.)
		(d)  Particle traces
			Calculation of vector variable, handling of rake start
			and continuation points, saving and plotting of
			particle traces.  (Functions 300-399.)
		(e)  Shock waves
			A "special" category for Euler/Navier-Stokes datasets.
			Calculation of necessary variables, calling special
			version of contour routines.  (Functions 400-499.)
	5.  Functions
		All routines for calculating scalar and vector functions for
		Euler/Navier-Stokes datasets.  FUNNAM returns the name
		associated with any function number, and FUNSYM returns its
		symbol.
	6.  Particle tracing
		Routines for finding and tracing particles through an
		arbitrary vector field.
	7.  Shock waves
		Function calculation and special contour routines needed for
		shock wave plotting.
	8.  Contours
		Routines for contour lines on 2D or 3D data planes, or
		surfaces through 3D data.
	9.  Storage
		Routines to handle the initialization, allocation, and cleanup
		of WORK array space.  This includes keeping track of where
		each array in WORK came from, whether they are currently in
		memory, and rereading them from the original input files if
		necessary to free space in WORK.
	10. Parser
		Routines for defining an "interactive environment" (prompt
		string, I/O devices), command syntax (including command
		arguments, qualifiers, and qualifier arguments), translation
		of reals and integers to and from character strings, and
		handling of error, warning, and informational messages.
	11. Utilities
		General-purpose routines for copying or zeroing arrays,
		transposing arrays, computing the gradient of a vector field,
		and various other linear algebra routines (dot and cross
		product, normalize vector, etc.).
	12. IRIS, IRIS2, DISSPLA, or GRAFIX
		All routines dealing with plotting: initialization of graphics
		device, title, contour, and additional text routines,
		definition of veiwing transformation, color changing, and
		point, line, and polygon drawing.  All device-dependent
		routines, such as mouse interpretation snd screen dumping for
		the IRIS.
	13. Unix, VMS, or COS
		Operating system-dependent routines, such as how to interpret
		file names and types (file.DAT, file.PAR), set up keyboard
		attention interrupt handling, execute operating system
		commands, translate symbols, and find out if the program input
		is interactive or batch.


Give calling sequence and a sentence or two on each subroutine.

Identify COMMON blocks and the routines that reference them.

Identify routines CALLED BY each subroutine, and routines CALLING each
subroutine (forward and backward cross-reference).

Define exactly the interface between the sections (e.g. IRIS and the outside
world).

Explanation of philosophy of PLOT3D, input, types of plots available, how to
make them.
