It is possible to Import definition of objects defining the Geometry of the transport domain from a text file using a command “Import Geometry from a Text File”. It is possible to import (export) points, curves (polylines, circles, arcs, and splines), surfaces, openings and thickness vectors.

1. Definition of each object starts with the word OBJECT=KEY_WORD, followed by coordinates of points defining given object. Two or three coordinates (for two- and three-dimensional problems; units must be always in meters) of a single point are given on a single line. Numbers can be delimited using a space, a semicolon, or a tabulator.
2. Points associated with higher objects, i.e., lines, openings or surfaces, are listed as part of this object. Similarly, lines associated with higher objects, i.e., openings or surfaces, are listed as part of this object. Only points that are not part of any higher object should thus be listed under the object POINTS, and only lines that are not part of any higher object (e.g., that do not form boundaries of surfaces) should thus be listed under the object LINES.
3. Lines with a semicolon at the beginning are ignored as „Comments". Note that comment lines can appear only between blocks, but not inside of any particular block.
4. It is possible that exported Geometry once imported back into HYDRUS can have different numbering, i.e., the project may not be identical.
5. Below is a list (KEY_WORD) of all possible objects. "POLYLINE" is a single line defined by multiple nodes, while "LINES" is a series of lines (multiple objects). Surfaces or Openings must be defined by a single closed curve, the type of which is given in the name of the object (e.g. SURFACE_CIRCLE). When this rule is not fulfilled (e.g., for a surface with complex boundary), this complex boundary will be saved as a series of lines, i.e., SURFACE_LINES.
6. The THICKNESS_ARR3Z_NLAYERS command allows importing multiple Thickness Vectors to define variable thickness of a Solid. On each Thickness Vector one can define multiple z-coordinates that are used to divide a Solid automatically into Layers with variable thicknesses. The number of Layers is arbitrary (min=1, max=100) and their number is given by the number of columns in the file.

KEY_WORD for Import/Export:

POINTS

LINES

POLYLINE

SPLINE

CIRCLE

ARC

SURFACE_LINES

SURFACE_POLYLINE

SURFACE_SPLINE

SURFACE_CIRCLE

OPENING_LINES

OPENING_POLYLINE

OPENING_SPLINE

OPENING_CIRCLE

THICKNESS

THICKNESS_ARR3Z

THICKNESS_ARR3Z_NLAYERS

Notes on the THICKNESS_ARR3Z_NLAYERS command (the THICKNESS_ARR3Z command has only the first five columns):

Particular columns in the input file have the following meaning:

1. X coordinate (m).
2. Y coordinate (m).
3. Z coordinate (m) of the Definition Point of the Thickness Vector (Anchor Point, see Figure of the User Manual with the Edit Thickness Vector dialog and the point denoted "P"). The Definition (Anchor) Point must lie in the plane of the Base surface. The Z-coordinate in the third column will thus likely be constant for all Thickness Vectors, unless the Base Surface is inclined.
4. Z coordinate (m) of the lower point of the first layer of the Thickness Vector (a point denoted "N1" in Figure of the User Manual). When P=N1, this coordinates is the same as the 3rd coordinate.
5. Z coordinate (m) of the upper point of the first layer of the Thickness Vector.
6. Z coordinate (m) of the upper point of the second layer of the Thickness Vector.
7. …
8. Z coordinate (m) of the upper point of the last layer of the Thickness Vector, i.e., the coordinate of the surface of the solid.

Here is an example of the file for the import of a Solid divided into three Geo-Layers:

OBJECT=THICKNESS_ARR3Z_NLAYERS

 4.500000e+000   4.000000e+000   0.000000e+000   0.000000e+000   1.300000e+000   2.100000e+000   3.300000e+000

 5.500000e+000   2.500000e+000   0.000000e+000   0.000000e+000   1.300000e+000   2.200000e+000   3.400000e+000

 7.000000e+000   4.500000e+000   0.000000e+000   0.000000e+000   1.400000e+000   2.300000e+000   3.000000e+000

 7.000000e+000   2.500000e+000   0.000000e+000   0.000000e+000   1.200000e+000   2.600000e+000   3.500000e+000

 6.500000e+000   9.999999e-001   0.000000e+000   0.000000e+000   1.600000e+000   2.400000e+000   3.600000e+000

 5.000000e+000   2.000000e+000   0.000000e+000   0.000000e+000   1.200000e+000   2.500000e+000   3.700000e+000

 4.500000e+000   2.000000e+000   0.000000e+000   0.000000e+000   1.400000e+000   2.400000e+000   3.400000e+000

 5.000000e+000   9.999999e-001   0.000000e+000   0.000000e+000   1.500000e+000   2.500000e+000   3.300000e+000

 5.500000e+000   9.999999e-001   0.000000e+000   0.000000e+000   1.100000e+000   2.100000e+000   3.200000e+000

;

Other notes:

9. The minimum number of columns is 5 (this corresponds to a single layer).
10. Z coordinates must be entered in the correct sequence, i.e., from the bottom (Base Surface) up towards the end of the Thickness Vector.
11. If layers are to be defined in a different direction than Z (e.g., when the Base Surface lie in the XZ plane), one needs to first carry out the standard import in the Z direction and then to rotate the entire domain using the Rotate function.
12. When the “THICKNESS_ARR3Z_NLAYERS” is used, i.e., the input file includes data of thickness vectors with multiple geo-layers, this key word can be processed fully only if the domain already contains a 3D-Layered Solid. If there is no Solid defined yet, then HYDRUS is not able to create a Solid automatically from imported points because its Base Surface can have a very complex shape. There are two ways how to proceed:
1. Press “OK” to continue. HYDRUS will import first only thickness vectors without geo-layers. Then define a 3D-Layered Solid using imported points and import the same file again. Geo-layers will be added to the Solid during this second import.
2. Press “Cancel” to cancel this import. First define a 3D-Layered Solid and then import this file again. Thickness vectors with layers will be added to the Solid.

Ex  Sample of the text file:

OBJECT=POINTS

1.500000e+000 1.000000e+000 0.000000e+000

2.500000e+000 1.000000e+000 0.000000e+000

3.500000e+000 1.000000e+000 0.000000e+000

4.000000e+000 1.000000e+000 0.000000e+000

4.500000e+000 1.000000e+000 0.000000e+000

2.500000e+000 1.000000e+000 1.000000e+000

3.500000e+000 1.000000e+000 1.000000e+000

4.000000e+000 1.000000e+000 1.000000e+000

0.000000e+000 1.200000e+001 5.000000e+000

0.000000e+000 0.000000e+000 5.000000e+000

4.919253e+000 1.077135e+001 5.000000e+000

4.073954e+000 1.084530e+001 5.000000e+000

4.000000e+000 1.000000e+001 5.000000e+000

2.919253e+000 1.077135e+001 5.000000e+000

2.073954e+000 1.084530e+001 5.000000e+000

2.000000e+000 1.000000e+001 5.000000e+000

1.000000e+000 8.500000e+000 5.000000e+000

2.000000e+000 9.000000e+000 5.000000e+000

3.000000e+000 8.500000e+000 5.000000e+000

4.000000e+000 9.000000e+000 5.000000e+000

5.000000e+000 8.500000e+000 5.000000e+000

6.000000e+000 9.000000e+000 5.000000e+000

7.000000e+000 8.500000e+000 5.000000e+000

8.000000e+000 9.000000e+000 5.000000e+000

9.000000e+000 8.500000e+000 5.000000e+000

8.919253e+000 1.077135e+001 5.000000e+000

8.073954e+000 1.084530e+001 5.000000e+000

8.000000e+000 1.000000e+001 5.000000e+000

6.919253e+000 1.077135e+001 5.000000e+000

6.073954e+000 1.084530e+001 5.000000e+000

6.000000e+000 1.000000e+001 5.000000e+000

1.000000e+001 1.050000e+001 5.000000e+000

1.250000e+001 9.000000e+000 5.000000e+000

1.000000e+001 9.000000e+000 5.000000e+000

1.250000e+001 1.050000e+001 5.000000e+000

1.100000e+001 4.500000e+000 5.000000e+000

1.150000e+001 6.000000e+000 5.000000e+000

1.050000e+001 5.500000e+000 5.000000e+000

1.100000e+001 2.500000e+000 5.000000e+000

1.150000e+001 4.000000e+000 5.000000e+000

1.050000e+001 3.500000e+000 5.000000e+000

;

OBJECT=POLYLINE

3.500000e+000 2.500000e+000 0.000000e+000

5.500000e+000 2.500000e+000 0.000000e+000

;

OBJECT=POLYLINE

5.500000e+000 2.500000e+000 0.000000e+000

8.000000e+000 2.500000e+000 0.000000e+000

;

OBJECT=POLYLINE

8.000000e+000 2.500000e+000 0.000000e+000

8.500000e+000 3.000000e+000 0.000000e+000

;

OBJECT=POLYLINE

8.500000e+000 3.000000e+000 0.000000e+000

8.500000e+000 5.500000e+000 0.000000e+000

;

OBJECT=POLYLINE

8.500000e+000 5.500000e+000 0.000000e+000

7.500000e+000 6.500000e+000 0.000000e+000

;

OBJECT=POLYLINE

7.500000e+000 6.500000e+000 0.000000e+000

4.000000e+000 6.500000e+000 0.000000e+000

;

OBJECT=POLYLINE

4.000000e+000 6.500000e+000 0.000000e+000

1.500000e+000 6.500000e+000 0.000000e+000

;

OBJECT=POLYLINE

1.500000e+000 6.500000e+000 0.000000e+000

5.000000e-001 6.000000e+000 0.000000e+000

;

OBJECT=POLYLINE

5.000000e-001 6.000000e+000 0.000000e+000

5.000000e-001 4.000000e+000 0.000000e+000

;

OBJECT=SPLINE

1.000000e+000 8.500000e+000 0.000000e+000

2.000000e+000 9.000000e+000 0.000000e+000

3.000000e+000 8.500000e+000 0.000000e+000

4.000000e+000 9.000000e+000 0.000000e+000

5.000000e+000 8.500000e+000 0.000000e+000

6.000000e+000 9.000000e+000 0.000000e+000

7.000000e+000 8.500000e+000 0.000000e+000

8.000000e+000 9.000000e+000 0.000000e+000

9.000000e+000 8.500000e+000 0.000000e+000

;

OBJECT=CIRCLE

1.100000e+001 4.500000e+000 0.000000e+000

1.150000e+001 6.000000e+000 0.000000e+000

1.050000e+001 5.500000e+000 0.000000e+000

;

OBJECT=CIRCLE

1.100000e+001 2.500000e+000 0.000000e+000

1.150000e+001 4.000000e+000 0.000000e+000

1.050000e+001 3.500000e+000 0.000000e+000

;

OBJECT=SURFACE_LINES

0.000000e+000 1.200000e+001 0.000000e+000

0.000000e+000 0.000000e+000 0.000000e+000

1.350000e+001 0.000000e+000 0.000000e+000

1.350000e+001 1.200000e+001 0.000000e+000

0.000000e+000 1.200000e+001 0.000000e+000

;

OBJECT=SURFACE_LINES

1.000000e+001 1.050000e+001 0.000000e+000

1.000000e+001 9.000000e+000 0.000000e+000

1.250000e+001 9.000000e+000 0.000000e+000

1.250000e+001 1.050000e+001 0.000000e+000

1.000000e+001 1.050000e+001 0.000000e+000

;

OBJECT=OPENING_LINES

1.500000e+000 4.000000e+000 0.000000e+000

1.500000e+000 5.500000e+000 0.000000e+000

3.000000e+000 5.500000e+000 0.000000e+000

3.000000e+000 4.000000e+000 0.000000e+000

1.500000e+000 4.000000e+000 0.000000e+000

;

OBJECT=OPENING_LINES

3.500000e+000 4.000000e+000 0.000000e+000

3.500000e+000 5.500000e+000 0.000000e+000

5.000000e+000 5.500000e+000 0.000000e+000

5.000000e+000 4.000000e+000 0.000000e+000

3.500000e+000 4.000000e+000 0.000000e+000

;

OBJECT=OPENING_LINES

5.500000e+000 4.000000e+000 0.000000e+000

5.500000e+000 5.500000e+000 0.000000e+000

7.000000e+000 5.500000e+000 0.000000e+000

7.000000e+000 4.000000e+000 0.000000e+000

5.500000e+000 4.000000e+000 0.000000e+000

;

OBJECT=OPENING_LINES

1.500000e+000 2.000000e+000 0.000000e+000

1.500000e+000 3.500000e+000 0.000000e+000

3.000000e+000 3.500000e+000 0.000000e+000

3.000000e+000 2.000000e+000 0.000000e+000

1.500000e+000 2.000000e+000 0.000000e+000

;

OBJECT=OPENING_CIRCLE

4.919253e+000 1.077135e+001 0.000000e+000

4.073954e+000 1.084530e+001 0.000000e+000

4.000000e+000 1.000000e+001 0.000000e+000

;

OBJECT=OPENING_CIRCLE

2.919253e+000 1.077135e+001 0.000000e+000

2.073954e+000 1.084530e+001 0.000000e+000

2.000000e+000 1.000000e+001 0.000000e+000

;

OBJECT=OPENING_CIRCLE

8.919253e+000 1.077135e+001 0.000000e+000

8.073954e+000 1.084530e+001 0.000000e+000

8.000000e+000 1.000000e+001 0.000000e+000

;

OBJECT=OPENING_CIRCLE

6.919253e+000 1.077135e+001 0.000000e+000

6.073954e+000 1.084530e+001 0.000000e+000

6.000000e+000 1.000000e+001 0.000000e+000

;

OBJECT=OPENING_LINES

1.000000e+001 1.050000e+001 0.000000e+000

1.000000e+001 9.000000e+000 0.000000e+000

1.250000e+001 9.000000e+000 0.000000e+000

1.250000e+001 1.050000e+001 0.000000e+000

1.000000e+001 1.050000e+001 0.000000e+000

;

OBJECT=THICKNESS

2.500000e+000 1.000000e+000 0.000000e+000

2.500000e+000 1.000000e+000 1.000000e+000

;

OBJECT=THICKNESS

3.500000e+000 1.000000e+000 0.000000e+000

3.500000e+000 1.000000e+000 1.000000e+000

;

OBJECT=THICKNESS

4.000000e+000 1.000000e+000 0.000000e+000

4.000000e+000 1.000000e+000 1.000000e+000

;

OBJECT=THICKNESS

0.000000e+000 1.200000e+001 0.000000e+000

0.000000e+000 1.200000e+001 5.000000e+000

;

OBJECT=THICKNESS

0.000000e+000 0.000000e+000 0.000000e+000

0.000000e+000 0.000000e+000 5.000000e+000

;

OBJECT=THICKNESS

4.919253e+000 1.077135e+001 0.000000e+000

4.919253e+000 1.077135e+001 5.000000e+000

;

OBJECT=THICKNESS

4.073954e+000 1.084530e+001 0.000000e+000

4.073954e+000 1.084530e+001 5.000000e+000

;

OBJECT=THICKNESS

4.000000e+000 1.000000e+001 0.000000e+000

4.000000e+000 1.000000e+001 5.000000e+000

;

OBJECT=THICKNESS

2.919253e+000 1.077135e+001 0.000000e+000

2.919253e+000 1.077135e+001 5.000000e+000

;

OBJECT=THICKNESS

2.073954e+000 1.084530e+001 0.000000e+000

2.073954e+000 1.084530e+001 5.000000e+000

;

OBJECT=THICKNESS

2.000000e+000 1.000000e+001 0.000000e+000

2.000000e+000 1.000000e+001 5.000000e+000

;

OBJECT=THICKNESS

1.000000e+000 8.500000e+000 0.000000e+000

1.000000e+000 8.500000e+000 5.000000e+000

;

OBJECT=THICKNESS

2.000000e+000 9.000000e+000 0.000000e+000

2.000000e+000 9.000000e+000 5.000000e+000

;

OBJECT=THICKNESS

3.000000e+000 8.500000e+000 0.000000e+000

3.000000e+000 8.500000e+000 5.000000e+000

;

OBJECT=THICKNESS

4.000000e+000 9.000000e+000 0.000000e+000

4.000000e+000 9.000000e+000 5.000000e+000

;

OBJECT=THICKNESS

5.000000e+000 8.500000e+000 0.000000e+000

5.000000e+000 8.500000e+000 5.000000e+000

;

OBJECT=THICKNESS

6.000000e+000 9.000000e+000 0.000000e+000

6.000000e+000 9.000000e+000 5.000000e+000

;

OBJECT=THICKNESS

7.000000e+000 8.500000e+000 0.000000e+000

7.000000e+000 8.500000e+000 5.000000e+000

;

OBJECT=THICKNESS

8.000000e+000 9.000000e+000 0.000000e+000

8.000000e+000 9.000000e+000 5.000000e+000

;

OBJECT=THICKNESS

9.000000e+000 8.500000e+000 0.000000e+000

9.000000e+000 8.500000e+000 5.000000e+000

;

OBJECT=THICKNESS

8.919253e+000 1.077135e+001 0.000000e+000

8.919253e+000 1.077135e+001 5.000000e+000

;

OBJECT=THICKNESS

8.073954e+000 1.084530e+001 0.000000e+000

8.073954e+000 1.084530e+001 5.000000e+000

;

OBJECT=THICKNESS

8.000000e+000 1.000000e+001 0.000000e+000

8.000000e+000 1.000000e+001 5.000000e+000

;

OBJECT=THICKNESS

6.919253e+000 1.077135e+001 0.000000e+000

6.919253e+000 1.077135e+001 5.000000e+000

;

OBJECT=THICKNESS

6.073954e+000 1.084530e+001 0.000000e+000

6.073954e+000 1.084530e+001 5.000000e+000

;

OBJECT=THICKNESS

6.000000e+000 1.000000e+001 0.000000e+000

6.000000e+000 1.000000e+001 5.000000e+000

;

OBJECT=THICKNESS

1.000000e+001 1.050000e+001 0.000000e+000

1.000000e+001 1.050000e+001 5.000000e+000

;

OBJECT=THICKNESS

1.250000e+001 9.000000e+000 0.000000e+000

1.250000e+001 9.000000e+000 5.000000e+000

;

OBJECT=THICKNESS

1.000000e+001 9.000000e+000 0.000000e+000

1.000000e+001 9.000000e+000 5.000000e+000

;

OBJECT=THICKNESS

1.250000e+001 1.050000e+001 0.000000e+000

1.250000e+001 1.050000e+001 5.000000e+000

;

OBJECT=THICKNESS

1.100000e+001 4.500000e+000 0.000000e+000

1.100000e+001 4.500000e+000 5.000000e+000

;

OBJECT=THICKNESS

1.150000e+001 6.000000e+000 0.000000e+000

1.150000e+001 6.000000e+000 5.000000e+000

;

OBJECT=THICKNESS

1.050000e+001 5.500000e+000 0.000000e+000

1.050000e+001 5.500000e+000 5.000000e+000

;

OBJECT=THICKNESS

1.100000e+001 2.500000e+000 0.000000e+000

1.100000e+001 2.500000e+000 5.000000e+000

;

OBJECT=THICKNESS

1.150000e+001 4.000000e+000 0.000000e+000

1.150000e+001 4.000000e+000 5.000000e+000

;

OBJECT=THICKNESS

1.050000e+001 3.500000e+000 0.000000e+000

1.050000e+001 3.500000e+000 5.000000e+000

;

Return to File Menu.