transform_xyz
US Geological Survey						Dec. 1993


NAME
	transform_xyz

SUMMARY
	Name	transform_xyz
	Type	data
	Inputs	none
	Output	geom
	Parameters	
	Name		Type		Default	     Min     Max
	Filename	string		NULL         none    none
	Close Region	boolean		true           none    none
	Scale X		float  		1.0            none    none
           	Offset X  	float  		0.0            none    none
            Scale Y   	float	  	1.0            none    none
            Offset Y  	float  		0.0            none    none
           	Scale Z   	float  		1.0            none    none
            Offset Z  	float  		0.0            none    none


DESCRIPTION

	This module reads an ASCII file consisting of lists of
	x,y,z points, performs a scale and  offset  on each  
            dimension and constructs a polyline geometry object
	using the points in the file as vertices.


	The file format this module expects is as follows:

	num_vertices		(integer)
	x y z			(floating point values)
	x y z
	  .
	  .
	x y z
	num_vertices		(integer)
	x y z
	x y z
	  .
	  .
	x y z
	<eof>


PARAMETERS

	Filename
		A file browser is supplied allowing the user to specify
		a filename for plot_xyz to read.

	Close Region
		A boolean flag which, if true, indicates that a line 
		segment will inserted between the first and last vertices.
		The value of this flag is applied to each set of vertices
		in the file.

	Scale x
		Specifies the scaling factor for the X axis.

    	Offset x
            	Specifies the distance to translate  X  axis  coordi-
           		nates.

     	Scale y
		Specifies the scaling factor for the Y axis.  Has  no
            	effect on 1D input fields.

     	Offset y
            	Specifies  the   distance   to   translate   Y   axis
		coordinates.  Has no effect on 1D input fields.

     	Scale z
		Specifies the scaling factor for the Z axis.  Has  no
            	effect on 1D or 2D input fields.

     	Offset z
            	Specifies the distance to translate  Z  axis  coordi-
            	nates.  Has no effect on 1D or 2D input fields.


OUTPUTS

	A GEOMedit_list which contains a polyline connecting the vertices
	of each group of vertices specified by the user.

EXAMPLE

	PLOT XYZ
	    |
	GEOMETRY VIEWER     

LIMITATIONS
	Limited error checking is performed.