15.1.10 Dump_XMGrace_Multi_Mesh Procedure

The Dump_XMGrace_Multi_Mesh procedure writes an XMGrace plotting file for a mesh and any listed variables to the specified filename. On a parallel run, or unless the mesh is numbered very specifically, the points will be output in a somewhat random order. These can be plotted with a scatter plot, or the numbers can be sorted by an editor or a Unix sort command.

Calling syntax:

call Dump_XMGrace (Filename, Mesh, Coordinate, Xmin, Xmax, Ymin, Ymax, Zmin, Zmax, Variable1_MV, ..., VariableN_MV, Variable1_DV, ..., VariableN_DV, status)

Input variables:

	Filename		The filename for XMGrace dump output.
	Mesh		The Multi_Mesh object to be output to the XMGrace dump file.
	Coordinate		A single-character variable expressing which axis to output, either ``X'', ``Y'', or ``Z''.
	Xmin, Xmax		Limits of the output variable set in the X-direction.
	Ymin, Ymax		Limits of the output variable set in the Y-direction.
	Zmin, Zmax		Limits of the output variable set in the Z-direction.
	Variable#_MV		Mathematical vectors to be output along with the mesh. The pound sign may be replaced with a number from 1 to REP_NUMBER.
	Variable#_DV		Distributed vectors to be output along with the mesh. The pound sign may be replaced with a number from 1 to REP_NUMBER.

Output variable:

status

If present, the status variable is set to either 'File Error', `Memory Error', `Multiple Error' or 'Success' depending on program execution. If not present, the procedure aborts if unsuccessful when the DEBUG_LEVEL is set high enough.

The Dump_XMGrace_Multi_Mesh code listing contains additional documentation.