COVISE Online Documentation

Overview | All Modules | Tutorial | User's Guide | Programming Guide

COVISE Online Documentation

Module category: IO

RWCoviseASCII

RWCoviseASCII

RWCoviseASCII reads or writes COVISE ASCII files.

RWCoviseASCII is available for COVISE version 5.2.2 and higher.

Parameters

Name Type Description

path Browser ASCII file

new Boolean Create new file

Name Type(s) Description

DataIn Geometry
IntArr
Polygons
Lines
Float
Vec3
UniformGrid
RectilinearGrid
TriangleStrips
StructuredGrid
UnstructuredGrid
Points
Vec3
Float
RGBA_Data
USR_DistFenflossBoco InputObjects

Output Ports

Name Type(s) Description

DataOut IntArr
Polygons
Lines
Float
Vec3
UniformGrid
RectilinearGrid
TriangleStrips
StructuredGrid
UnstructuredGrid
Points
Vec3
Float
RGBA_Data
USR_DistFenflossBoco OutputObjects

Format description COVISE ASCII format

This section describes (with examples) the following types of data objects:

Geometry Data Types
- POINTS (points)
- LINES (lines)
- POLYGN (polygons)
- TRIANG (triangle strips)
Structured Grid Types
- UNIGRD (uniform grid)
- RCTGRD (rectilinear grid)
- STRGRD (structured grid)
Unstructured Grid Types
- UNSGRD (unstructured grid)
Structured Data Types
- STRSDT (structured grid scalar data)
- STRVDT (structured grid vector data)
Unstructured Data Types
- USTSDT (unstructured grid scalar data)
- USTVDT (unstructured grid vector data)
Set of Elements (for timesteps)
- SETELEM (set of elements)

If you need more information about COVISE Data Objects please read COVISE Programming Guide, Chapter 3.

Important Note:
Do not split the first line of the datatype format description!
POLYGN 4 14 8 or STRGRD 2 2 2 etc. has to be written in one line!

Geometry Data Types

POINTS (points)

datatype format example

POINTS <numVertex> { ATTR <name> <value> ATTR ... VERTEX <x> <y> <z> <x> <y> <z> <x> <y> <z> ... }

POINTS 5 { ATTR color white VERTEX 1 0 0 2 4 5 7 6 5 5 6 7 6 7 7 }

Example:

Define 5 points, coordinates of

Point 0: (1,0,0)
Point 1: (2,4,5)
Point 2: (7,6,5)
Point 3: (5,6,7)
Point 4: (6,7,7)

are given in the VERTEX list.

LINES (lines)

datatype format example

LINES <numLines> <numConn> <numVertex> { ATTR <name> <value> ATTR ... VERTEX <x> <y> <z> <x> <y> <z> <x> <y> <z> ... CONN <v1> <v2> <v3> <v4> ... <v1> <v2> ... ... }

LINES 6 19 10 { ATTR color white VERTEX 0 0 0 0 0 1 0 0 2 0 1 0 0 1 1 0 1 2 0 1 3 0 2 0 0 2 1 0 2 2 CONN 0 1 2 3 4 5 6 7 8 9 0 3 7 1 4 8 2 5 6 }

Example:

Define a line grid of 6 lines across 10 points.

The coordinates of these 10 points, P0...P9, are specified in the VERTEX list.

The connectivity list CONN specifies the lines

Line 0: 0-1-2
Line 1: 3-4-5-6
Line 2: 7-8-9
Line 3: 0-3-7
Line 4: 1-4-8
Line 5: 2-5-6

POLYGN (polygons)

datatype format example

POLYGN <numPoly> <numConn> <numVertex> { ATTR <name> <value> ATTR <name> <value> ATTR ... VERTEX <x> <y> <z> <x> <y> <z> <x> <y> <z> ... CONN <v1> <v2> <v3> <v4> ... <v1> <v2> ... ... }

POLYGN 4 14 8 { ATTR vertexOrder 0 ATTR color white VERTEX 0 0 0 0 0 1 0 0 2 0 1 0 0 1 1 0 1 2 0 1 3 0 2 0 CONN 0 1 4 3 1 2 5 4 2 6 5 2 6 7 }

Example:

Define 4 polygons with 8 points.

The points are P0...P7.

The connectivity list defines the polygons, which are automatically closed:

Polygon 0: 0-1-4-3-0
Polygon 1: 1-2-5-4-1
Polygon 2: 2-6-5-2
Polygon 3: 2-6-7-2

TRIANG (triangle strips)

datatype format example

TRIANG <numPoints> <numCorners> <numStrips> { ATTR <name> <value> ATTR ... VERTEX <x> <y> <z> <x> <y> <z> <x> <y> <z> ... CONN <corner1> <corner2> <corner3> <corner1> <corner2> ... ... }

TRIANG 5 7 2 { ATTR color white VERTEX 1 0 0 4 6 7 7 8 4 8 9 0 3 6 7 CONN 1 3 2 4 0 4 3 }

Example:

Defines 2 triangle strips built from 5 points.

The triangle strips in the example contain the following triangles:

Strip 0: Triangles 1-3-2 and 3-2-4
Strip 1: Triangle 0-4-3

(see also Programming Guide, 3.10.5 Triangle Strips)

Structured Grid Types

UNIGRD (uniform grid)

datatype format example

UNIGRD <xSize> <ySize> <zSize> <xMin> <xMax> <yMin> <yMax> <zMin> <zMax>
{ ATTR <name> <value> ATTR ... }

UNIGRD 30 30 30 -0.4 0.6 -0.8 0.5 -0.1 0.2
UNIGRID declaration must be written in 1 line !
{ ATTR STAR_SCALE8 1.000000 ATTR DataObjectName ReadStar_1_OUT_01 }

Example:

Define a uniform grid (Cartesian coordinates, spacing along each axis is uniform)

In the example above

values of x vary between -0.4 and 0.6
values of y vary between -0.8 and 0.5
values of z vary between -0.1 and 0.2
a uniform grid of dimension 30*30*30 is defined within these ranges

RCTGRD (rectilinear grid)

datatype format example

RCTGRD <xSize> <ySize> <zSize> { ATTR <name> <value> ATTR ... VERTEX <x1> <x2> ... <y1> <y2> ... <z1> <z2> ... }

RCTGRD 2 2 2 { ATTR color blue VERTEX 0 0 1 2 3 7 }

Example:

Define a rectilinear grid (Cartesian coordinates, spacing along each axis is nonuniform).

The number of VERTEX entries is xSize + ySize + zSize, in the example above 2+2+2=6.

The vertex list defines

		x1=0
		x2=0
		y1=1
		y2=2
		z1=3
		z2=7

This defines 2 points P1(x1=0,y1=1,z1=3) and P2 (x2=0,y2=2,z2=7) This is sufficient to define a rectilinear grid, because all lines of the grid are parallel to one of the axes.

STRGRD (structured grid)

datatype format example

STRGRD <xSize> <ySize> <zSize> { ATTR <name> <value> ATTR ... VERTEX <x> <y> <z> <x> <y> <z> <x> <y> <z> ... }

STRGRD 2 2 2 { ATTR color blue VERTEX 0 3 4 1 2 3 3 6 7 4 6 7 2 5 6 2 3 4 0 9 8 9 8 7 }

Example:

Define a structured grid, i. e. an arbitrarily deformed hexahedral grid, which still has a primitive structure of i x j x k hexahedra. All vertex coordinates are stored independently, but the connectivity is still implicit. in our example above

The number of vertices is xSize * ySize * zSize, i.e. 2*2*2=8.
Therefore we have one deformed hexahedron (8 points)

Unstructured Grid Types

UNSGRD (unstructured grid)

datatype format example

UNSGRD <numCells> <numConn> <numVertex> { ATTR <name> <value> ATTR ... VERTEX <x> <y> <z> <x> <y> <z> <x> <y> <z> ... CONN <v1> <v2> <v3> <v4> ... <v1> <v2> ... ... }

UNSGRD 3 17 10 { ATTR color white VERTEX 0 0 0 1 0 0 0 1 0 1 1 0 0 0 1 1 0 1 0 1 1 1 1 1 ... ... ... 0.5 0.5 2 CONN HEX 4 6 7 5 0 2 3 1 PYR 4 5 7 6 8 TET 8 5 7 9 }

Example:

Define an unstructured grid consisting of 3 cells using 10 points P0...P9.

first cell is a Hexahedron: 4-6-7-5-0-2-3-1
second cell is a Pyramid: 4-5-7-6-8
third cell is a Tetrahedron: 8-5-7-9

(see also Programming Guide, 3.7 Unstructured Grid Types, Unstructured Grid Base Elements)

Different element types are defined by the following symbols:

Type Symbol

Prism PRI

Tetrahedron TET

Pyramid PYR

Hexahedron HEX

Quad QUA

Triangle TRI

Bar BAR

Point POI

Structured Data Types

STRSDT (structured grid scalar data)

datatype format example

STRSDT <xSize> <zSize> <zSize> { ATTR <name> <value> ATTR ... DATA <value1> <value2> <value3> ... }

STRSDT 2 2 2 { ATTR species te DATA 1 5 7 9 10 3 0 11 }

Example:
Define scalar data on a structured grid. The number of vertices of the structured grid is xSize*ySize*zSize, and there is one data value per vertex. In case of a uniform or rectilinear grid, the order of the points and thus of the corresponding values is such, that you vary first the z, then y, and then z. So in case of our example above

The number of vertices is 2*2*2 = 8

In case of a uniform or rectilinear grid the order of the values is

	    value1= 1 at (x0,y0,z0)
	    value2= 5 at (x0,y0,z1)
	    value3= 7 at (x0,y1,z0)
	    value4= 9 at (x0,y1,z1)
	    value5=10 at (x1,y0,z0)
	    value6= 3 at (x1,y0,z1)
	    value7= 0 at (x1,y1,z0)
	    value8=11 at (x1,y1,z1)

STRVDT (structured grid vector data)

datatype format example

STRVDT <xSize> <ySize> <zSize> { ATTR <name> <value> ATTR ... VERTEX <x> <y> <z> <x> <y> <z> <x> <y> <z> ... }

STRVDT 2 2 2 { ATTR color blue VERTEX 1 2 4 5 6 7 9 8 0 4 6 0 9 8 11 8 9 10 0 0 0 1 1 0 }

Example:

Define vector data on a structured grid. The number of vertices of the grid is xSize*ySize*zSize, and the VERTEX list (actually the list of data vectors per vertex) contains the vector data for the points. So in case of our example above

The number of vertices is 2*2*2 = 8

In case of a uniform or rectilinear grid the order of the values is

	    vector1 = (1, 2, 4) at (x0,y0,z0)
	    vector2 = (5, 6, 7) at (x0,y0,z1)
	    vector3 = (9, 8, 0) at (x0,y1,z0)
	    vector4 = (4, 6, 0) at (x0,y1,z1)
	    vector5 = (9, 8,11) at (x1,y0,z0)
	    vector6 = (8, 9,10) at (x1,y0,z1)
	    vector7 = (0, 0, 0) at (x1,y1,z0)
	    vector8 = (1, 1, 0) at (x1,y1,z1)

Unstructured Data Types

USTSDT (unstructured grid scalar data)

datatype format example

USTSDT <numValues> { ATTR <name> <value> ATTR ... DATA <value1> <value2> <value3> ... }

USTSDT 10 { ATTR color white DATA 0.0 0.1 0.2 0.3 0.4 0.5 0.6 0.7 0.8 0.9 }

Example:

Define scalar data on an unstructured grid.

USTVDT (unstructured grid vector data)

datatype format example

USTVDT <numValues> { ATTR <name> <value> ATTR ... DATA <value11> <value12> <value13> <value21> <value22> <value23> <value31> <value32> <value33> ... }

USTVDT 4 { ATTR color blue DATA 0.854572 0.195090 0.000000 0.854572 0.195090 0.195090 0.854572 0.000000 0.195090 0.854572 0.000000 0.000000 }

Example:

Define vector data on an unstructured grid, i. our example 4 data vectors on a grid of 4 points.

Set of Elements (for timesteps)

SETELEM (set of elements)

datatype format example

SETELEM <numElem> { ATTR <name> <value> ATTR ... ELEM { # elem number 0 TYPE0 { ATTR <name> <value> ATTR ... ... } ... } }

SETELEM 2 { ATTR timestep 1 2 ELEM { # elem number 0 POINTS 3 { ATTR color white VERTEX 1 0 0 2 4 5 5 6 7 } # elem number 1 POINTS 3 { ATTR color white VERTEX 3 5 6 7 8 9 1 0 1 } } }

Example:

Define a set of 2 objects (1 for each of 2 timesteps) of type POINTS, each consisting of 3 points.

Authors: Martin Aumüller, Ruth Lang, Daniela Rainer, Jürgen Schulze-Döbold, Andreas Werner, Peter Wolf, Uwe Wössner

COVISE Version 2021.12

Name	Type	Description
path	Browser	ASCII file
new	Boolean	Create new file

Name	Type(s)	Description
DataIn	Geometry IntArr Polygons Lines Float Vec3 UniformGrid RectilinearGrid TriangleStrips StructuredGrid UnstructuredGrid Points Vec3 Float RGBA_Data USR_DistFenflossBoco	InputObjects

Type	Symbol
Prism	PRI
Tetrahedron	TET
Pyramid	PYR
Hexahedron	HEX
Quad	QUA
Triangle	TRI
Bar	BAR
Point	POI