AVS Modules						read ucd points
US EPA Visualization Center				  July 23, 1992

NAME
	 read ucd points -  read scattered points from an ASCII file

SUMMARY
	Name	read ucd points
	Type	Data
	Inputs	NONE
	Outputs	Field Output	ucd
	Parameters
		Name		Type	Default	Range
		Filename	string

DESCRIPTION

	Read observation locations and variable values from an ASCII
	file. From these observations build a ucd structure field with 
	one node for each observation.  The cells of the structure are
	of type UCD_POINT.

	The first line of the file should contain two integers : the
	first gives the number of spatial dimensions, the second gives
	the number of variables per observation. Each line after that
	contains one observation, first the coordinates, then the variable
	values. Each number on the line can be either an integer or a 
	float. For example,
		3 4
		1 1 1 4 5 6 7
		1 2 7 3 2 9 8
		....
	describes observations in 3-space with 4 variable values at 
	each point. The first point is located at (0, 0, 0) with
	values 4, 5, 6, 7 for the first, second, third, and fourth
	variables, respectively. Another example,
		2 3
		1 1 1 4 5 
		1 2 7 3 2
		....
	describes observations in 2-space with 3 variable values at
	each point. The first point is located at (1, 1) with values
	1, 4, 5 for the first, second, and third variables, respectively.


PARAMETERS
	Filename
	This parameter specifies the name of the file containing 
	the point data.

OUTPUTS
	Field Output -- ucd

EXAMPLE NETWORKS
	This network reads in scattered observations and displays 
	the samples as colormapped primitives at the sample locations.

	generate colormap	 read ucd points
		|		     |
		|__________     _____|
			   |   |
			ucd to prim
			     |
		      geometry viewer

	This network reads in scattered observations and generates
	a colormapped surface from them.

				     read ucd points
	generate colormap		   |	   
		|		           |
	   ucd legend			   |
		|			   |
		|______________________	   |
				       |   |
				    ucd to geom
	        			 |
			      		 |
				  geometry viewer


RELATED MODULES
	Modules which process the ucd output:
		ucd to geom
		ucd iso
		ucd to prim

SEE ALSO
	read points 

AUTHOR
	Penny Rheingans, US EPA Scientific Visualization Center