Contents Previous Next Subchapters

rtecplot - Reading Tecplot Files
Syntax
dll dll\tecplot.dll, rtecplot
rtecplot(
fileversiontitlevnameznameezonezcolor, ...
     
imaxjmaxkmaxpointelem)
See Also wtecplot , pltgui

Description
The rtecplot function provides low-level capabilities for reading Tecplot .PLT files in O-Matrix. Arguments use the same conventions as in Tecplot. See your Tecplot documentation for details on the structure and content of .PLT files. Trailing blanks are removed from all character data read from the input file. When multiple strings are combined in a single matrix, such as vname, trailing blanks are added so that all rows have the same length as the longest string.

Arguments
The argument file is the only input value and is not changed by rtecplot. The input value of the other variables does not matter.

file
The first argument file is a character row vector specifying the name of the Tecplot file to read.

version
The second argument version is a real scalar representing the version number of Tecplot used to create this plot file. If the forward byte order version number is not between 1 and 100, it is assumed that the byte order of each 4-byte value in the file is reversed.

title
The title argument is a character row vector.

vname
The vname argument is a character matrix with row dimension equal to the number of variables in the file. The i-th row of vname contains the name of the i-th variable left justified and blank filled on the right.

zname
The zname argument is a character matrix with row dimension equal to the number of zones in the Tecplot file. The i-th row of zname contains the name of the i-th zone left justified and blank filled on the right.

ezone
The argument ezone is a logical column vector with row dimension equal to the number of zones in the Tecplot file. If ezone(i) is true, the i-th zone is a finite element block zone.

zcolor
The argument zcolor is character matrix with row dimension equal to the number of zones in the Tecplot file. The column dimension of zcolor is 6. Possible values for a row are "black", "red", "green", "blue", "cyan", "yellow", "purple", "white" and "undef". The color name is right justified within each row and blanks are used to fill out each row to 6 characters.

imax
The argument imax is an integer column vector with row dimension equal to the number of zones in the Tecplot file. If ezone(i) is true, imax(i) specifies the number of rows of point that correspond to zone number i If ezone(i) is false, imax(i) specifies the maximum i index for the i-th zone. In this case imax(i) * jmax(i) * kmax(i) is the number of rows of point that correspond to zone number i

jmax
The argument jmax is an integer column vector with row dimension equal to the number of zones in the Tecplot file. If ezone(i) is true, jmax(i) specifies the number of rows of elem that correspond to zone i. If ezone(i) is false, jmax(i) specifies the maximum j index for the i-th zone.

kmax
The argument kmax is an integer column vector with row dimension equal to the number of zones in the Tecplot file. If ezone(i) is true, kmax(i) specifies the type of the elements in zone i. The value 0 specifies triangles, 1 specifies quadrilaterals, 2 specifies tetrahedrons, and 3 specifies bricks. If ezone(i) is false, kmax(i) specifies the maximum k index for the i-th zone.

point
The argument point is a real matrix with column dimension equal to the number of variables. Each row of point contains the value for all the variables at a single data point. The data is stored in zone order. The data for zone 1 is first, then zone 2, etc. See imax above for how many rows of point correspond to each zone.

elem
The argument elem is an integer matrix with column dimension equal to 8. Each row of elem defines an element for a finite element zone. The elements for the first finite element zone come first, then the elements for the second finite element zone, etc. See jmax above for how many elements are in each zone. The first column of elem specifies the index within the corresponding zone of the first point in the element. The second column specifies the index of the second point and so on. The indices within each zone are numbered starting at one. If an element corresponds to a triangle finite element zone (see kmax), only the first 3 columns of elem are significant for that element. For quadrilaterals and tetrahedrons only the first 4 columns are significant. For bricks, all 8 columns are significant.

Example
See the example in wtecplot for an illustration of creating and reading .PLT files.