Read_Text_Sequence (Rd_Txt_Sequence)

Synopsis

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

Input Port

parent

UIconnection

Parameters

Filename	UIfileSB	name of the file to read
skip lines	UIfield	number of lines to skip
number of dimensions	UIfield	dimensionality of the field to be read in.
dimension 1 dimension 2 dimension 3	UIfield	dimensionality of the field to be read in.
separator	UIoptionMenu	selects the column separator
number of variables	UIfield	selects the number of variables to be read
vector length	UIfield	veclen for each variable
data type	UIoptionMenu	selects the data type for each variable
label (optional)	UIfield	label for nodedata per variable
units (optional)	UIfield	units for the nodedata per variable
Read File	UIbutton	causes file to be read

Output Port

field

Mesh_Unif+Node_Data

Description

Read_Text_Sequence (the Network Editor name is shortened to Rd_Txt_Sequence) reads in one or more arrays from an ascii file that contains only the contents of the array with no extra information such as array dimensions, data types, etc. into a uniform field. The reader does not make any assumptions about the structure (dimensions) or the data type of the input data. All information about the structure and the data type must be specified. One exception is that if data type is undefined. The reader will attempt to guess between integer and double (floating point). Each array in the input file is mapped to a separate node data component. The UI uses the term "variables," which corresponds both to the number of arrays in the original data file and the number of components in the resulting field.

Input

parent

The UI parent, of type UIconnection.

Parameters

Filename

A file dialog box in which you select the file to read.

skip lines

An integer that specifies the number of lines in the file to skip. The default is_0.

number of dimensions

A typein box that is used to specify the dimensionality of the field to be read.

dimension1 dimension2 dimension3

A typein box that is used to specify the dimensionality of the field to be read.

separator

A string that specifies a character or sequence of characters to be used as column separator. This parameter is relevant only if you have also selected "user" in the column_separator parameter.

number of variables

int. The number of variables that are to be set.

vector length

A typein box used to sepecify the length of the vector

data type

Radio box items that specify the type of the output data. The allowed values are byte, short, int, float, double, and string.

label

A string used for the node data label

units

A string used for the node data units.

Read File

A button to activate the module.

Output Port

field

Mesh_Unif+Node_data. The output is a new Uniform Field.

Example

Not available

File

v/modules.v

See also related modules

table_to_scattered_field

table_to_uniform_field