2.3 Invoking makeBoundary

The makeBoundary program creates boundary condition files for the FullSWOF solver. The command-line syntax is:

./makeBoundary boundary

where boundary is one of top, bottom, left and right.

There are five types of boundary condition that are recognised by the solver:

case 1

imposed height condition

case 2

wall condition

case 3

Neumann condition

case 4

periodic condition

case 5

imposed discharge condition

Cases 1 and 5 are implemented in makeBoundary. A height value and a discharge value are calculated for each cell along the boundary. At grid cells where the calculated values are zero the wall boundary condition, case 2, is applied.

Each time makeBoundary runs it reads two input files and produces one output file. The first input file, named topography.txt, provides the height data. This file is also used by FullSWOF to define the domain topography. The file may be saved in the current working directory or, alternatively, a symbolic link to a file in an external directory may be created. To create such a link use a command of the form:

ln -s /path/to/topography/file topography.txt

The second input file is the boundary definition file. This file specifies the boundary type, the global discharge across the boundary and the local gradient. Extra control parameters allow the global discharge to be split across separate regions. Surface roughness may be defined for the each region individually. See Boundary Definition File for details of the input parameters and the file format.

makeBoundary generates an output file in the format required by the FullSWOF solver. Depending on the value of the boundary command-line option, the filename of the output file is one of BCTop.txt, BCBottom.txt, BCLeft.txt or BCRight.txt.