Structure and format of the structure data file


In the structure data file, data (geometric or attributes) are stored with their respective X- and Y-coordinates. These data has to be assigned to the nodes or elements during the modelling in SPRING.

The structure data file has the name "name.str”. It begins with three comment lines with any text, followed by a blank line and any number of structural data sets. During the modelling in SPRING the contour data blocks are stored later in the project's *. str file. As this is done automatically, the contour data should NOT be edited manually by the user.

 

Example:

Project XY

Structure file 01.01.2010

SPRING Version 4.0

 

DATA | l | @ 3 1 0 @ Model boundary

1 607.2647 1460.3211

2 257.1429 1220.7641

3 259.4463 718.6157

. . .

 

FLAE | f | @ 7 2 0 @ groundwater recharge

1 402.2591 1172.3920 0.0000

2 393.0454 813.0565

. . .

 

VORF | l | @ 2 1 0 @ water course

1 922.8350 1285.2602

2 904.4075 1197.7298 22.0100

3 913.6213 1100.9851

. . .

 

The structural data are separated by blank lines. A structural data set consists of a header line followed by any number of rows of data.

The header line has the format:

KENN | x | @ plot parameters @ text

That means:

KENN (4 characters) represents the identifier of the structural dataset. It is required to assign the data to nodes or elements of the mesh. You can use the usual data identifiers and the identifier "DATA" for geometric structural data.

| x | (1 character) describes the structure data type:

p Point structure
l Line structure
f Flat structure

Between the two '@' symbols, you will find the plot parameters of the structural dataset. These will help you distinguish the various characteristics in the graphic window of SPRING by using different colours, markings and line types. These are:

In case of point structures (p):
Colour number, marking type and marking height (pixel),,
In case of line structures (l):
Colour number, line type and flag for markings at intermediate points,
In case of flat structures (f):
Colour number, line type and flag for filling the polygon.

The definition of plot parameters including the '@' is optional. If they are not specified, SPRING will use default plot parameters for the structural data.

The text gives a short description on the structural dataset. Using this, you can identify the different datasets in the selection list.

 

The data line have the format:

nr, X, Y, Z

I6,F10,F10,F10

 

That means:

6 columns for numbering the data. By default, SPRING transfers the numbering into serial numbering. It can also be 6 spaces.

10 columns for the x-coordinate of the point,

10 columns for the y-coordinate of the point and

10 columns for the z-value which is evaluated for the structural-characteristic dataset is assigned to nodes or elements. The z-value is optional.

 

In addition to the project's structure data file structural data from other *. str files can be read in with Structure Import… in SPRING.

The meaning of the identifiers is defined in the file xsusi.kenn. This is described in detail in the appendix .

 

Format of the structure data file (ASCII)