DVread_seq_ascii

Synopsis

Reads a sequence of numbers from a ascii file into a uniform field.

module DVread_seq_ascii {
string+Iparam filename; /* name of file to read */
string+Iparam delimiter = " ";
int+Iparam skip_lines = 0;
int+Iparam ndim = 3;
int+Iparam dims[ndim];
int+Iparam ncomp = 1;
DVread_seq_var comps[ncomp] {
veclen = 1;
data_type = 12; // 12 = DTYPE_UNDEF
};
Mesh_Unif+Node_Data+Oparam out;
omethod+notify_val+notify_inst read_update<status=1> =
"DVread_seq_ascii_update";
};

Description

DVread_seq_ascii reads an ascii file which contains one or more "raw" arrays (a simple sequence of numbers). The reader does not make any assumptions about the structure (dimensions) or data type of the input data. All information about the structure and the data type must be specified as inputs to this module. One exception is that if data_type is undefined, then the reader will attempt to guess between integer and double (floating point). The raw arrays are read into a uniform field.

Input

filename

A string. Names the input file to be read. The string can be either the complete absolute pathname, or a relative pathname. If it is relative, it will be interpreted relative to the user's working directory when AVS/Express was started.

delimiter

string. The separator between elements in the file

skip_lines

integer. The number of lines to skip at the beginning of the file

ndim.

integer. The dimensionality, number of dimensions, of the new field

dims

integer. The dimensions of the new field

ncomp

integer. the number of variables

comps

DVread_seq_var. The veclen and data type (byte, float, integer, etc.) of each variable. Use the defines from include/avs/dtype.h for the datatype

Output

out

The output is a new Uniform Field.

Example

Not Available.

File

v/dv.v

See also

DVgrid_read

DVread_seq_binary

DVtable_read