Overview | All Modules | Tutorial | User's Guide | Programming Guide |
Module category: IO
RWCoviseASCII reads or writes COVISE ASCII files.
RWCoviseASCII is available for COVISE version 5.2.2 and higher.
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 |
Name | Type(s) | Description |
DataOut | IntArr
Polygons Lines Float Vec3 UniformGrid RectilinearGrid TriangleStrips StructuredGrid UnstructuredGrid Points Vec3 Float RGBA_Data USR_DistFenflossBoco | OutputObjects |
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! |
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
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
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:
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:
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.2UNIGRID 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
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).
x1=0 x2=0 y1=1 y2=2 z1=3 z2=7
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
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.
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 |
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
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)
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
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)
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.
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.
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 |
Copyright © 1993-2022 HLRS, 2004-2014 RRZK, 2005-2014 Visenso |
COVISE Version 2021.12
|