Notes for PLOT3D class, July 10, 1986

PLOT3D - what it's supposed to do!  (CFD results, make plots)
	2D or 3D, steady
	Types of plots - grid, contour, vector, particle traces, shocks

Overall
	structure of course
		basics & 2D plots (1/2 hr)
		3D plots (1/2 hr)
		break
		advanced stuff & more examples
	(some) Help file locations
	(some) executable locations
	more detailed documentation

BASICS:

Using PLOT3D

	Basic command lines
		command/qualifier=(qual_arg,qual_arg) command_arg,command_arg -
			!comment
		will prompt for arguments if not entered on command line

	Batch vs. interactive

	Reading in the data - READ command
		filename conventions - .BIN, .DAT, .FMT
		file formats
		/NOCHECK

2D plots

	Simple example - 2D Mach number contour plot
		{example 1}

	Meaning of WALLS, SUBSETS
		start,end,inc prompt
		keywords FIRST,LAST,ALL
		multiple start,end,inc sets
		add WALLS to example
			{example 2}

	CONTOUR command
		options (AUTO/INC/MAN)
		SHOW FUNCTION
		attributes
			lines/color/grid/surfaces/points
			color map
			plane orientations
		change contours in example (highlight Mach 1)
			{example 3}

	Vector plots - VECTOR command
		options and attributes
		example - velocity colored by pressure
			{example 4}
		example - only vectors between Mach 1 and 1.4
			{example 5}

	Line plots - example - Cp (use SHOW FUNCTION)
		{example 6}

	PLOT command
		other output devices (PLOT/DIP) - filenames

	2D plots of 3D data - VIEW command

More about command lines - special characters

	"character strings"
	'symbols' (at least on VAX/VMS)
	@file - command files
	EOF - end-of-file (or ^Z on VAX/VMS)
	keyboard interrupts - ^C, (or <BREAK> on Unix)
		use CLEAR command
	$command - system commands

3D plots

	No filled polygons in 3D for DISSPLA (2D only in V3.5)

	Program dimensions
		WORK array
		number of variables to fit in WORK
		MAP command

	VPOINT command
		/XYZ or /ANGLES, looking at center of MINMAX box
		difference in behavior of VPOINT/MINMAX on IRIS vs. DISSPLA

	Contours in 3D subset
		Lines - plane orientations (comments on V3.5)
			{example 7}
			{example 8}
			{example 9}
		Surfaces (slow!)
			{example 10}

	Particle traces
		Starting points - RAKE command
			like SUBSET
			XYZ or IJK
			{example 11}
		Restricting particle traces - oil flow
		/MAXPOINTS=number of points in the trace
			{example 12}
		+-time
		/READ=file/WRITE=file - .par files (format)
			{example 13}
		particle tracing method
			Second-order Runge-Kutta
			3 steps per computational cell
			trilinear interpolation in computational space

	Shock wave plots
		basically what's being plotted (Mach number component in
			grad p direction decreasing through 1)
		1st contour level determines attributes (color)
		associated functions (PRESSURE GRADIENT, SHOCK FUNCTION)
		pressure gradient cutoff (where?)
		each line/polygon - velocity decreasing
		{example 14}

	Carpet plots - like 2D line plots
		which 2 spatial axes vs. function (or 1 axis for 2D plots)
			- VIEW command
		MINMAX box, FSURFACE/SCALE_FACTOR
		CONTOUR command controls color, whether lines or shaded surface
		{example 15}
		grid lines or contour lines (constant-f lines) via
			FSURFACE/GRID or /CONTOUR
		location of walls - FSURFACE/WALLS_ORIGIN
		"up"-axis - PLOT/UP=axis
		{example 16}


ADVANCED TOPICS:

IRIS use

	generally no hidden surfaces (use WALLS, SUBSET ordering)
	mouse manipulation
	light source (from VPOINT)
	hidden surfaces (z-buffering, MINMAX)
	arrowheads (MINMAX,VPOINT)
	binary files - from FORTRAN or C
	transparency
	PLOT/SCRIPT
	generating .GRA files for GAS
		PLOT3X - ARCGraph GRAFIX version

Multiple grids

	READ file formats (see HELP)
	WALLS,SUBSETS/GRID=n
	IBLANK array - for particle tracing

Miscellaneous commands and options

	TEXT
	SHOW
	MINMAX/xSCALE - relative axis scaling
	PLOT/FIGURE - "figure-quality" plots from DISSPLA
	PLOT/LABELS - contour labels for 2D DISSPLA plots (mention bug)

Useful pieces of code

	contour lines (CON2L,CON3L)
	C I/O from FORTRAN (IRIS/Unix)
	system utilities from FORTRAN
		keyboard interrupt
		calling the system
		symbol translating
		condition handling
	character string manipulation
		trim leading/trailing blanks, nulls, & tabs (TRIM,LTRIM)
		convert integer or real to character string with no leading
			blanks (INTCHA,REACHA)
		convert string to upper or lower case (UPCASE,LOCASE)
		find if a string matches any in a given list; if so, how many
			(MATCH)
	machine-independent HELP utility using FORTRAN direct-access files

Other versions of PLOT3D

	TURB3D, REAL3D (locations of Help files)
		Modification involves:
			changing Q file format for READ (READQ)
			more/different info in Q header record (READQH and
				added COMMON block
			different functions (SCAFUN,VECFUN,FUNNAM,FUNSYM
				+ functions)
			different info on right-hand side of plot
				(ADXPLT,QHXPLT)

Additional information

	Available on what machines
	Installation notes
		VAX
			page file quota (set from $RUN AUTHORIZE)
		IRIS
			swap space on disk
