Flownet Manual
Flownet Manual
Flownet Manual
version 5.12
U S E R 'S M A N U A L
page
PROGRAM IDENTIFICATION
USER LICENSE
The FLOWNET program is the property of the authors. The purchaser is licensed to use
his copy of the program.
The conditions for use follow those of the IGWMC software. All files on the
FLOWNET diskette may be copied for backup purposes and use within the purchasing
organization only. The authors do not allow copying for commercial purposes and/or
passing the software on to individuals in other organizations. FLOWNET is not
warranted to be completely coincident with this manual.
The FLOWNET program has been used and tested for years now. No software is
completely free of errors, however. If you should encounter a bug, the authors will
immediately work on it and supply you with a corrected version at no charge. The
authors disclaim all other warranties. It is the user's responsibility to make sure that the
interpretations derived from the use of this software are correct. The author does not
assume any responsibility for results obtained by using this software.
3
The FLOWNET program has been developed for IBM PC, IBM XT, IBM AT, IBM
PS/2 models and all other fully IBM compatible microcomputers with graphics
capability. The computer must have at least 256Kbytes of main memory (RAM) and an
IBM CGA, EGA, VGA, Hercules or ATT400 (Olivetti) graphics adaptor. The Operation
System (DOS) must be version 2.0 or later. An 80(x)87 mathematical coprocessor is
recommended to speed up calculations. Plots of generated flownets can be made on an
HP or compatible plotter.
FLOWNET is multilingual and one of the few programs that respect decimal notation
characteristic of a language. Currently, FNINST can generate Dutch, English, French
and German FLOWNET.TXT files. Just type FNINST at the MS-DOS prompt and
choose one of the possibilities offered. When FNINST has run, type FLOWNET and
you will see that its language is the one you chose. Please feel free to write if you have
any remarks or suggestions on grammar, spelling etc.
4
The complete program is supplied on a single diskette and contains the following files:
C.J. Hemker
Elandsgracht 83
1016 TR Amsterdam
HOLLAND
The demonstration version of FLOWNET is free to be used and copied, but its
application is limited to 200 cells. Applicants should enclose DFl. 25 (US$ 15) for
disk, manual, mailing and handling.
Major revisions of the program will be distributed as versions 5.3, 5.4, etc. Users of
version 5.1 and older will receive update notices describing the (major) changes and
instructions about how to obtain a new version.
USER INSTRUCTIONS
While you are working with the program, model results are presented as graphical
output to the monitor. Graphs and related water balance data can be directed to a matrix
printer by means of a single keystroke if some additional program has been run (loaded)
before FLOWNET is started. If your computer uses a CGA graphics card (a low-
resolution screen with 640*200 pixels) or Olivetti (ATT400) graphics (640*400), the
first thing to be done is to run a program called GRAPHICS.COM (supplied on your
DOS disk).
Type: GRAPHICS <return>.
If, however, you are working with an EGA (640*350) or VGA (640*480) graphics card,
the graphics program will probably not work. In that case you can try the FEMDMP
program, supplied on the FLOWNET disk.
Type: FEMDMP <return>.
If this still does not result in a proper screendump, you can think of selecting another
screentype from the main menu (see next section), look for another screendump
program or try another matrix printer.
7
Starting FLOWNET
Note that when you start FLOWNET, the FLOWNET.TXT file and a suitable BGI file
should be present in the current directory.
FLOWNET detects your graphics hardware and adjusts screen scale etc. to it.
If a VGA screen is detected, the program will run in EGA mode.
If autodetection fails, CGA hires graphics will be default.
In case your PC does have higher resolution graphics than detected, for instance your PC
has a EGA adapter but the program produces CGA resolution graphics, it is possible to
override autodetection. Just add a graphics card number when you start FLOWNET
from the MS-DOS prompt:
The aforementioned method enables one to see CGA and EGA graphics on an Olivetti
M240 where ATT400 graphics is autodetected. Unfortunately, Hercules graphics cards
seem to have a problem with mixed text and graphics. Therefore, no texts are shown
when flownet drawings are made on Hercules screens. Also, flow rate calculations
cannot be performed on Hercules screens1.
8
FLOWNET is designed not to crash on error or nonsense user input that put most
programs back to DOS or worse.
Although the program is not warranted to be completely armed against malevolent users
(they are hereby challenged to try and crash it), FLOWNET has reached a high degree of
security against error input and you need not be worried about hitting a wrong key at all.
If a runtime error should nevertheless occur, please report the current state of the
program (page number, current item or activity), a model description or file and the
runtime number to us in any form such that the error is replicable.
Main program control keys are PG UP and PG DN. The program is, like a booklet,
subdivided into several (7) pages. The PG UP and PG DN keys are used to switch
between these pages.
PG DN moves program control to the next page from 1 to 7.
PG UP moves program control one page back.
Of the function keys, only F1 plays a role during data entry. F1 is used for special
functions like storage and retrieval of model data files, printout, function evaluation etc.
as indicated on the lines at the bottom of the screen.
The bottom line or bottom two lines of each page contain further directions for use.
Often, these change with the position of the cursor on the screen. If you are not familiar
with FLOWNET, read them carefully and soon you will no longer need to read them.
9
Data entry
Pages 2 through 6 use alphanumeric keys for data entry, while BACKSPACE, INS,
DEL, HOME, END and arrow keys function as in regular text editors.
If a string or number is input, HOME takes the cursor to the beginning of the item. END
takes the cursor to the end of the input string. If END is pressed again, program control
will be moved (see above).
INS toggles between Insert and Overwrite modes. Insert mode is default. Overwrite
mode is indicated in the lower right corner of the screen.
BACKSPACE deletes the character to the left of the cursor.
DEL deletes the character at the location of the cursor.
The left and right arrow keys move the cursor across the item.
In addition, the left and right arrow keys are used as toggle switches to change
statements from, for example, "upper side is open" to "upper side is closed" and vice
versa.
If the input item consists of data entry as well as a switch (e.g. equipotential lines on
page 6 ), the cursor must be at the end of the input string before toggling is effective.
Any time numerical data are input, a formula can be input instead of numbers only. For
instance, type 1/3 for 0.333.
Except for the heads formula evaluation on page 4, where x serves as the column or row
index, x as well as y represent the present value of the input item. See "hydraulic head
data entry" for more details.
10
- model name :
- model code :
Any two text strings up to 40 characters each can be input here.
- number of columns is
A maximum of 400, depending on the number of rows.
- number of rows is
A maximum of 400, depending on the number of columns.
The number of model cells equals the number of columns multiplied by the number of
rows.
These items can be toggled using the left and right arrow keys. A configuration with all
four sides closed, or with two opposite sides open and the other two closed is not
allowed.
12
hydraulic head, one can usually distinguish so-called saddle points in the flownet
drawing. These are points where no flow occurs, and recognizable because their
surroundings look empty in an average drawing of the flownet. The degree of
coincidence of the saddle points for the flowlines and the equipotential lines patterns
respectively is a good indication for the consistency of FLOWNET's solution for a
specific problem.
Here a schematic map consisting of keyboard symbols represents the model and each
symbol represents a model cell. The default model map consists of the symbol x only. A
blinking cursor can be moved across this map to indicate individual cells. The cursor
position (column 1, row 1 upon entry) is displayed at the top and right side the map:
1
1 xxxxxxxxxxxxx
xxxxxxxxxxxxx etc.
Wherever you move the cursor, it keeps its position so when you enter page 5 again, you
will find the cursor where you left it.
At the left side of the screen, the symbol, conductivities and effective porosity of the
cursor model cell are displayed:
- symbol
- conductivity (m/day)
horizontal =
vertical =
effective porosity =
- symbol list:
The default model's list consists of an x only.
Note: the above item appears only if the calculations are not yet made.
Note: the above item appears only if the calculations are not yet made.
- vertical/horizontal scale is
- scale is fixed
Often, models are elongated and their images need vertical exaggeration. Use the right
arrow key to fix the scale of the drawing. If the scale is fixed, however, and the number
of model cells on display is increased such that the drawing would become too big for
18
the screen, FLOWNET switches fixed scale off automatically and adjusts display scale
to screen size.
Note: the above item appears only after the model calculations are made.
Note: the above item appears only after the model calculations are made.
Note: If you do not want isochrones or time steps animated, increase the number of user
screens to ( A + B ) or 10 even if you do not want to store images.
points. Therefore, the statement "Each dot represents an equivalent area" only holds
approximately true in regular parts of the model.
For models with a complex "geology" or subtle head differences, another consequence
of this linear interpolation is that FLOWNET might not draw time steps along all flow
lines successfully, and within some cells the number of time steps might be incorrect.
Often, isochrone points (time steps) along different flowlines move further apart in
time.This number specifies the maximum distance between isochrone points to be
connected with a line in the drawing.
First, the equipotential lines equations are built and solved, then the flowlines equations.
These equations each yield a matrix equation Ax=b which is solved with the ICCG(0)
iterative method.
- condition code
Before calculations start, the matrix equation is examined and the condition code
calculated. If this code is high, ICCG(0) will have a tough time. If this code is higher
than a certain level determined by the "iteration stop" (page 6) a warning will be given:
- note: iteration stop too low
- (erroneous output ?)
Output might be not according to the input data. If this code is higher than a certain
level depending on numerical precision, calculations will be aborted and messages
displayed:
- * * CALCULATION ABORTED : * *
- ** CELLS ARE TOO ELONGATED **
or
- ** CONDUCTIVITIES TOO EXTREME **
Then, FLOWNET will switch to page 3 or 5 after some seconds or when a key is
pressed.
If "information and stop after iteration" is chosen, the number of the iteration is output,
and the current error level, and the program will halt after calculations until a key is
pressed. Thereafter, the drawing will be made according to the specifications of page 6.
23
First, the drawing is made. Wait until the flow rate calculations messages appear:
Drawing of Isochrones
For isochrones, an array with coordinates needs to be stored in memory by the program.
If the number of isochrone links to be kept is too big (larger than 8000) FLOWNET
might not be capable of finishing the isochrones pattern correctly. A warning is output
on the bottom of the screen if this occurs:
- * isochrones memory overflow *
To prevent this type of error, you might either change the number of isochrone flowlines
or increase the time step.
Animation
If the difference between number of user screens and total number of screens is three or
larger, and time steps and/or isochrones are drawn, FLOWNET will animate flow
behaviour. In this case, wait until this message appears:
When a set of data has been entered or modified, it can be saved as a datafile.
Select page 3 and set line 2 to 'save model to disk'. Enter path and filename at line 3 and
press F1 to start the saving procedure. If the input of data has not been completed it
cannot be saved.
A file can be read by setting line 2 to 'read model from disk', entering the required path
and filename at line 3 and pressing F1. There is no option to produce a list of all
FlowNet files in a directory at the screen.