AVS Modules
Lawrence Berkeley Laboratory

NAME
	read_uniform

SUMMARY
	Name	read_uniform
	Type	data
	Inputs	none
	Output	field
	Parameters	Name		Type
			File Name	Browser

DESCRIPTION
	This module reads data in ascii format into a "uniform
	field" data structure.

	The disk file is structured to contain information about
	the field at the beginning of the file, followed by the
	data.

	Specifically, the file format this module expects is:
	
	Number of coordinate dimensions:	n
	Dimension 1:				length of dimension 1
	Dimension 2:				length of dimension 2
	   .
	   .
	   .
        Dimension n:				length of dimension n
	Number of data dimensions		j
	data

	Each of the specification values, number of coordinate
	dimensions, length of dimension, number of data dimensions,
	are integers separated by whitespace.  

	The data is organized such that the first item is at the
	origin of the coordinate system, with dimension 1 varying
	the fastest and dimension n varying the slowest.  Additionally,
	all dimensions of multi-dimensional data are contiguous
	(separated by whitespace).   Thus, for a three dimensional
	data field in a two dimensional coordinate system, the
	first three data items form the vector of data at the
	origin; the next three form the vector at the next
	coordinate position in dimension 1, and so on.

INPUTS	

PARAMETERS

	This module accepts as a parameter a file name.  The user
	is provided a file browser.

OUTPUTS
	"Field", any-dimension, uniform.

EXAMPLE

LIMITATIONS
	
	Inserting comments into your ascii file will result in errors.

NOTES