To run the installation program, insert the Disk marked GFlowSim into drive a: and from C:\ prompt, type in:
Where C:\ is the target drive on which the program will be installed. If the program is to be insta lled onto D:\users, then you should first move yourself to D:\users\ directory and from D:\users\ prompt, type in:A:GMSETUP D:\USERSUnder default situation, GMSETUP program will copy the files onto C:\ drive and put all the project related files/coverages into C:\GFMAP directory. If the directory does not exist, the setup program will create the directory. Upon a successful installation, the setup program will clean up all the unnecessary files it creates. If the programs are installed into C:\GFMAP, a user can immediatly start ArcView to load the project GFMAP.APR that contains the map-based groundwater flow simulation model. If the model programs are installed into a directory other than C:\GFMAP,e.g. D:\USERS\GFMAP, the user will need to load START.APR project. START.APR will prompt for the user to enter the path to the directory where GFMAP.APR project is located. START.APR will then correct the path for GFMAP.APR and load the project. The START.APR is acquired from ESRI with some minor modification to fit the project needs.
Listed below are the tasks this map-based simulation model is designed to accomplish:
Simulate groundwater flow for confined and phreatic aquifers to compute mass exchange between the cells (flow rates) and estimate water levels on the cells
Simulate groundwater flow for both steady and unsteady states
Plot flow vectors on the cell boundaries for each time step as simulation proceeds
Plot water level on the cell for each time step as simulation proceeds
Integrate with the map-based surface flow model to simulate surface/subsurface flow interaction.
Allow a user to modify the modelling conditions directly from the map
To verify the concept and ensure the programming correctness, this map-based model is applied to solve the problem of groundwater flow in a phreatic aquifer with accretion [bear, 1979] and the model results match those of theoretical solution. The problem assumes two parallel rivers of 50 km apart, cuts into a phreatic aquifer and can act as line sources/sinks of the aquifer. The river levels and quifer water level are initially at 50 m elevation. The aquifer has impermeable boundaries on north and south sides. It has also an impermeable bed at elevation 0 m.(See Figure 1.) This problem is used as the example problem on the application submited. This groundwater model has been tested on Unix SunOS, Alpha-Machines, Windows3.1, and Windows 95 under both ArcView 2.1 and ArcView 3.0 Beta, and the model has worked properly under all the situations tested.
Figure 1. The view containing the map-based groundwater simulation model
GFMAP.PLY - Polygon coverage representing roundwater cells. The cells are used as the base unit to compute mass balance
GFMAP.LIN - Line coverage representing the cell boundaries. The cell boundaries are used to compute mass exchange between groundwater cells.
GFMAP.LBL - Point coverage representing the centroid of a groundwater cell, which is used to compute the head gradients and flow directions between the cells.
The graphical interface of the simulation model (GFlowSim) is designed to facilitate a userŐs access of the model and model related programs. A user can use these graphical interfaces to activate the simulation model, modify the model conditions, display and analyze modeling results. This section describes the functions and programs assoicated with each user interface.
One menu section, GFwModel is added to the standard view menu GUI provided by the ArcView. GFwModel menu is created to run the groundwater flow simulation model and its related programs. GFwModel contains seven menu items and these items are divided into the simulation model and preprocessor sections. The functions of the menu items contained in each section are described below, with the title of the program it activates put in [ ].
1. GFlowSim - [GFlowSim.prc] activates the map-based groundwater simulation model.
2. SetTables - [Rinifld.utl] initializes the fields of a table. When this item is selected, a pop-up menu with 4 choices will be presented to the user and Rinifld.utl will call one of the four programs based on the selection.These four programs and their functions are:
(1) Iniflds.utl which sets selected records of a user selected field to a single or multiple values.
(2) Iniflda.utl which sets all records of a user selected field to a single or multiple values.
(3) Initbl.utl which sets all records of whole table or multiple user selected fields to a single value.
(4) Inifdfd.utl which initializes a field of a table with the values of a field of another table based on the user selected key fields on both tables. These two key fields can have different field name, but their values need to have one-to-one relation.
3. ChkTable - [Rchktbl.utl] displays the data structure of a value attribute table or a feature attribute table. When this item is selected, a pop-up menu with 2 choices will be presented to the user and the program [Rchktbl.utl] will call one of the two programs based on the user choice. These for programs and their functions are:
(1) [Chktbl.utl] which checks and displays the data structure of a value attribute table.
(2) [Chkftab.utl] which checks and displays the data structure and the shape type of a feature attribute table.
4. AddingRec - [tbaddrec.utl] appends a number of records to a time series table.
5. GFmdfld (pre-1) - [GFmdfld.pre] appends fields to polygon and polygon-boundary-line attribute tables to make cell and cell boundary objects for the map-based groundwater simulation model.
6. Setplyfld (pre-2) - [GFplyfld.pre] computes and fills in the states of the existing cell objects for the groundwater simulation model.
7. Setlnefld (pre-3) - [GFlnefld.pre] computes and fills in the states of the cell-boundary-line objects for the groundwater simulation model.
One button is added to the standard view button bar GUI provided by the ArcView. The function and programs associated with this button are explained below.- Pen, writes selected or all the scripts contained in the project's SEd to a designated location of a disk [wrtfiles.utl].
Two buttons are added to the standard view button bar GUI provided by the ArcView. The functions and programs associated with these buttons are explained below.
- Execute, runs all the programs available to SEd of the project [Main.utl - associated with apply event]. When the tool is selected, the program, Main.utl is loaded and activated when mouse is clicked at the cursor sensitive area of the active view. The last program run by the Main.utl is the default program to be run. If the user wants to run other programs, select NO option, and a pop-up menu will appear with a list of programs for the user to choice. The selected program will then run. with the cursor position taken into consideration.
- AlingBottom, plots flow vectors on groundwater simulation cell's boundaries or plot time series of head(t), dh(t), spr(t), pmp(t), etc., of a cell at a user selected location. Programs associated with click and apply events are described below.
CLICK - [GFsetplt.pst] provides options for a user to select which type of flow curves to plot and passed on the selection through the tool's object-tag to [GFRplot.pst]
APPLY - [GFRplot.pst] runs one of the two programs, [GFptflx.pst] or [GFpthead.pst], based on the value of the object-tag passed on to it from [GFsetplt.pst].
[GFptflx.pst] - plots flux, water level distributions, or both for the groundwater flow simulation model. Under steady state, it plots flux, water level distributions based on the final results of simulation run and under steady state, it plots the above values at a user designated time step.
[GFpthead.pst] - plots water level (head(t)), spring flow (spr(t)), water level variations (dh(t)) on a user selected location.
This map-based surface flow simulation model contains a total of 25 programs. Some of these programs are the essential programs for model construction and model simulation, and some of these programs are written to speed up routine spatial data processing. The descriptions of these programs are given in Section 2.4. of readme file of SFlowSim model.
This section gives a brief description of the procedures to perform tasks using GFlowSim, the map-based ground flow simulation model.
The procedure activate GFLOWSIM to simulate groundwater flow is, from ViewMenuBar, GFwModel -> GFlowSim . After the program started, you will be presented with a a multiple input table containing the model control parameters. These parameters are
(1) FluxPlot=A proportion used to scale the flux value so that the plot fits the screen.
(2) BndFact=A fraction number accounting for effects of boundaries.
(3) Sctrl=Storativity adjusting factor.
(4) YesColor=5, plot the flux and water level as simulation proceeds; =0, do not plot.
(5) IsSteady=true, simulate steady state, =False, simulate unsteady state
To plot the model simulation results, click from the ViewToolBar, and follow the instructions given by the program.2.5.3. Chang Modeling Conditions One of the advantage of using map-based groundwater simulation model is that it is easy to modify the model simulation conditions. This section describe how, in general, this could be done. Tables 1, and 2 show the attributes of line and polygon objects used for the groundwater flow simulation model. The modeling conditions can be modified by changing the values of the attribute assoicated with the line and polygon attributes. Both the utility programs contained in this simulation model and ArcView's database management programs can be used for this purpose.