Structure data file

Structure data file
SPRING-help >> Data structure of a groundwater model >> Basic data >>

Data (geometric or attributes) are stored in the structure data file with their associated easting and northing values (or X and Y coordinates). This data needs to be assigned to elements or nodes during the model creation in SPRING.

The structure data file has the extension "*.str". It begins with three comment rows containing any text, followed by an empty row and any number of structure data records. During model generation in SPRING, the contour data records are stored 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

. . .

 

Blank rows separate the structure data. A structure data record consists of a header row followed by any number of data rows.

The header row has the following format:

KENN | x | @ Display attributes @ text

 

Which means:

  • KENN (4 characters) is the identifier of the structure dataset. It is required to assign the structural data to mesh nodes or elements. In addition to the usual data identifiers, the "DATA" identifier is also provided for geometric or auxiliary structural data.

  • | x | (1 character) is the structure data type:

p Point structure

l Line structure

f surface structure

  • Between the two '@' symbols are the display/plot attributes of the structure, which assists in distinguishing the structures in the SPRING graphics window, e.g. by using different colours or marker types. These are:

For point structures (p):

Colour code, marker type and marker height (in pixels),

For line structures (l):

Colour code, line type and flag for marking the line points,

For surface structures (f):

Colour code, line type and flag for displaying a filled 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 display attributes can also be omitted (including the two '@'). In this case, SPRING uses the default presets to display attributes for the structure.

The info text describes the structure and enables the structure to be identified in the selection list.

The data lines have the format

nr, X, Y, Z

I6,F10,F10,F10

 

Which means:

  • six integer/whole number digits (I6) for consecutive numbering of the data. Any other numbering is always replaced by SPRING with consecutive numbering. There can also be six blank characters.

  • ten digits (F10) for the X-coordinate of the data point, which can include decimals,

  • ten digits (F10) for the Y-coordinate of the data point, which can include decimals and

  • ten digits (F10) for a Z value of the data point, which can include decimals and is evaluated when the structure is assigned to the data identifier of the structure. The Z value can also be missingl.

 

In addition to the project's structure data file, structure data from other *.str files can also be imported into SPRING via Structure Import...

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

 

Format of the structure data file (ASCII)