|
1. INTRODUCTION
"UPFLOOD - Flood Analysis Programs" is a computer program package, written and compiled in Microsoft Visual
Basic version VI. These user friendly programs are valuable and time saving tools which can determine the flood magnitude-frequency relationship utilizing various methods (statistical, deterministic and
empirical). TheUPFLOOD - Flood Analysis Programs supersedes the MS-Basic, Dos versions namely Detflood, Stflood, Regflood, Regplot and Regdata.
The first versions were released in September of 1986. Since that time there have been several releases of these programs with
the conversion to the Windows environment in the year 2000. The big step into the Windows environment has now been
successfully made and this allows the computer programs to be upgraded and enhanced even more. The aim is to provide the end users with an easy to use flood determination tool which will save time and effort.
The UPFLOOD - Flood Analysis Programs package was designed and developed at the Department of Civil and Biosystems
Engineering by Prof WJR Alexander with assistance from colleagues and students during the development period.
The package consists of two sections:
Statistical analysis (REGFLOOD) and Deterministic and Empirical analysis (DETFLOOD).
REGFLOOD:
REGFLOOD for Windows is adapted from the original DOS program that was written in MS Basic. The
conversion from MS Basic to Visual Basic required the input and output routines to be totally re-written and the
program to be re-structured for the Windows environment. The calculation routines were only modified where requirements of the more rigid Visual Basic dictated.
The Windows program allows data for up to 100 stations to be included in a project file instead of the 25 allowed in
the DOS version. The maximum number of peak values for a station has been increased from 90 to 120. The format
of the input data file used for the DOS version has been retained so that input data files may be used with either version of the program, subject to the DOS version limitation of 25 stations in a project file.
The visual examination of the plotted data is the most powerful tool for determining the optimum combination of
probability distribution functions, moment estimators, and plotting positions for determining the design flood peak/frequency relationships. The Windows version of REGFLOOD
is faster and more user friendly, particular for users who are familiar with the Windows environment. The graphs can be printed directly onto the users laser jet or colour printers. The texts
can be sent to a file that can be read into word processor documents. The algorithms for using missing data, censored data, historical data and zero values, and regional analyses still have
to be incorporated into the program. The following methods are recommended for flood probability analysis in South Africa. No significance should be attached to the order in which the methods are listed. Method 1: Direct statistical analysis - single station
Source Flood risk reduction measures (2001) and this users manual. Computer methods are provided for the following distributions. The computer output is in the form of tables with screen print and capture options.
|
Distribution
|
Moment estimators
|
|
N/MM
LN/MM
LP3/MM
LGEV/MM
|
Normal
Log normal
Log Pearson Type 3
Log general extreme value
|
Conventional moments
Conventional moments
Conventional moments
Conventional moments
|
|
Source Flood risk reduction measures (2001) and this users manual.
Only computer implementations are practicable for regional direct statistical analyses. The following distributions are included. The output is in the form of tables with screen and plotter graphics options.
|
Distribution
|
Moment estimators
|
|
|
Untransformed data:
|
|
|
EV1/MM
GEV/MM
GEV/PWM
|
Extreme value Type 1
General extreme value
General extreme value
|
Conventional moments
Conventional moments
Probability weighted moments
|
|
|
Log(10) transformed data:
|
|
|
LN/MM
LP3/MM
LEV1/MM
|
Log normal
Log Pearson Type 3
Log extreme value Type 1
|
Conventional moments
Conventional moments
Conventional moments
|
|
The regional analysis is however still only available in the DOS program REGNEW, but will soon be incorporated in
the REGFLOOD package. The DOS version of the program is however distributed with the UPFLOOD package.
DETFLOOD:
DETFLOOD for Windows is adapted from the original DOS program that was written in MS Basic. The
conversion from MS Basic to Visual Basic required the input and output routines to be totally re-written and the
program to be re-structured for the Windows environment. The calculation routines were only modified where requirements of the more rigid Visual Basic dictated.
With DETFLOOD it is now possible to determine the frequency distribution curves utilizing the following methods:
The following methods are recommended for flood probability analysis in South Africa. No significance should be attached to the order in which the methods are listed. Method 1: Unit hydrograph method - original algorithms Source University of the Witwatersrand Hydrological Research Unit Report No 1/72. (HRU 1/72)
A revised depth-duration-frequency diagram for point rainfall was published in HRU 2/78. The two associated
publications for Namibia are HRU 2/80 on large area storms and HRU 13/81 on design flood determination.
Method 2: Unit hydrograph method - alternative algorithms Source Flood hydrology for southern Africa and this users manual. The basic methodology is the same as that in HRU 1/72, except that alternative algorithms are used for the rainfall
depth-area-duration-frequency (DADF) relationship, and effective rainfall. Method 3: Probable maximum flood - original algorithms
Source HRU 1/72
It follows the HRU 1/72 methodology except that the computer program does not (as yet) make provision for subdivision of the catchment and routing procedures for the resultant hydrographs. The program uses the upper
envelope of maximum rainfalls in South Africa, but the user is given the option of entering alternative values.
Method 4: Rational method - alternative algorithms Source Flood risk reduction measures (2001) and the UPFLOOD users manual. This is a simplified version of the DWA method. The coefficients are the same, but the catchment is treated as a whole and not divided into sub-catchments. The runoff coefficient CT can be adjusted to permit calibration of the
method against the results of the direct statistical analyses. a) DADF algorithms from the original HRU 1/72 method (method 1 above) b) DADF algorithms compatible with the alternative implementation of the HRU 1/72 method (method 2 above).
The inclusion of a calibration algorithm. Method 5: Regional maximum flood Source Department of Water Affairs technical report TR 137 (Kovács, 1989).
The method is based on the original Francou-Rodier equation where the expected maximum flood is a function of
the area of the catchment and a factor K which the user derives from a map on which the regional K-values boundaries are shown.
Method 6: Standard Design Flood analysis Source SDF1 and SDF2 and the UPFLOOD user manual. Computer program DETFLOOD The new Standard Design Flood (SDF)
developed by Prof Alexander has been added to the user’s manual. Two additional papers titled Statistical analysis of extreme floods (SDF1) and The standard design flood - theory and practice (SDF2) were also included on the
UPFLOOD - Flood Analysis Programs discussing the rationale behind this new approach. The SDF method is based on the Rational method but utilizing regional coefficients. The Windows version of DETFLOOD is faster and more user friendly, particular for users who are familiar with the
Windows environment. The results can be sent to a file that can be read into word processor documents or copied directly from the screen.
Further improvements to be incorporated in the not to distant future include graphical comparison between the
various deterministic methods, graphical input selection figures and import and export functions of the input data and results from and to other data formats.
2. SYSTEM REQUIREMENTS
UPFLOOD - Flood Analysis Programs
runs on any personal computer, but requires Windows 95/98/ME/XP, Windows N.T 4.0, or 2000. The program takes up approximately 12 MB of hard disk space and a pointing device (mouse) is a helpful tool.
The software requires in order to access the "Relevant Literature" and "Presentations" sections also distributed with the software
package as well as for the installation of the package, a CD Rom drive (CD-R,CD-RW, DVD).
3. THE PACKAGE
UPFLOOD - Flood Analysis Programs comes on a CD and a user's manual. The distribution CD contain all the files and libraries
necessary to install and run the program, UPFLOOD - Flood Analysis Programs. The user manual is also distributed on the
CD in Adobe Acrobat format. The latest versions of the Adobe Acrobat readers were also included on the CD.
4. INSTALLING THE PROGRAM
You install UPFLOOD using the program setup.exe
. The Setup program installs the software, sample applications and the help files.
To install UPFLOOD:
- insert the distribution CD in the CD-drive
- type "d:setup.exe" (if "d" is the CD drive) or use the windows explorer to start the setup.exe program on the CD.
- Follow the setup instruction on the screen.
The installation program automatically creates a program group called UPFLOOD
. This program group will be listed under the Programs menu, which is under the Start menu. The installation program creates the directory specified by the user and then
copies the necessary files to this directory.
The following files should be in the selected directory:
|
UPFLOOD.exe
|
Detflood\Data\Temp.rtf
|
Regflood\107.inp
|
|
UPFLOOD Registration.exe
|
Detflood\SDF Data\Temp1.rtf
|
Regflood\108.inp
|
|
UPFLOOD.hlp
|
Detflood\SDF Data\SdfTR102.txt
|
Regflood\Gevtable.inp
|
|
UPFLOOD Registration.hlp
|
Detflood\SDF Data\SDFbasincoeffs.txt
|
Regflood\Ndevs.inp
|
|
readme.txt
|
Detflood\SDF Data\SDFparameters.txt
|
Regflood\Htable.inp
|
|
UPFLOOD.set
|
Detflood\Data\Examples
|
Regflood\rpt.inp
|
|
St6unst.log
|
Regflood\Regflood.exe
|
Regflood\Tdata.inp
|
|
Detflood\Detflood.exe
|
Regflood\Regflood.hlp
|
Regflood\Data\All the examples used in the manual
|
|
Detflood\Detflood.hlp
|
Regflood\Regflood.cfg
|
Regnew\REGNEW.exe
|
|
Detflood\Default.cfg
|
Regflood\102.inp
|
Regnew\All the examples used in the manual
|
|
Detflood\History.txt
|
Regflood\104.inp
|
|
|
Detflood\TR102.txt
|
Regflood\106.inp
|
|
The installation program will install all the necessary files in their correct locations and will create shortcut items under the Windows Startup menu.
5. REGISTRATION
UPFLOOD - Flood Analysis Programs
once installed can be used for a 15 day trial period. If the user would like to become a
registered user, a password is available from the Department of Civil and Biosystems Engineering. The benefit of registering is that
regular updates of the program and information on the latest products available will be distributed to all the registered users.
Please print the registration form and fax it to the number below. Registering can also be done by telephone or e-mail. The
developers will provide the password which must be entered to register the program. If registering by phone please remember to provide the "UPFLOOD ID number" generated by the program.
Department of Civil and Biosystems Engineering
Contact person: Mr Marco van Dijk
Tel: 012 420 3176
Fax: 012 362 5218
E-mail: software@sinotechcc.co.za
Copies/passwords of the UPFLOOD software package are available at R800/set/password (excluding VAT). This includes
the installation CD, user's manual and postage. The package can be used for a fifteen day period before registration is required.
This software is sold by the University of Pretoria. Postage costs are included in the above amount.
Remember to keep the password provided by the Department of Civil and Biosystems Engineering for future reference. It may be
required to re-enter the password if the program is updated in the future. Updates will be send to all registered users and will be made available on the internet web site.
6. DISCLAIMER
The computer programs included in this package were developed and applied over a number of years, and further changes and
improvements are anticipated in the future. Exhaustive testing of this product is impossible. The data sets supplied with the package are included for demonstration purposes only.
The software programs were developed for the convenience of its users. Although every reasonable effort has been made to
ensure that the results are correct and accurate, neither the University of Pretoria nor the developers assume any responsibility for
any results, the interpretation thereof or any use made of the results obtained with these programs. These programs are not
presented nor are they intended to be used as a complete study and the use of these software programs or output shall be made
under the direction of trained engineers exercising their independent judgement regarding the obtained results. Any person making use of these programs, does so entirely at his/her own risk.
7. SOFTWARE DOWNLOADS
The latest version available is version 4.0.2 (26 April 2005), see updates for later versions:
Date: 26 April 2005
License: Shareware R850.00 (excluding VAT) (Outside South Africa's borders $190 or Ł95)
Size: 5.4 MB (does not include the user manual)
UPFLOOD - version 4.0.2
Already in UPFLOOD - Version 3.0.1 the new SDF design method has been included
The Standard Design Flood (SDF) is a new method that was developed by Prof WJR Alexander. It can be used too
determine the flood magnitude-frequency relationship for any catchment of any size from 10 km˛ to 40 000 km˛, anywhere in
South Africa. This is a new, simple, but robust, standard design flood estimation method. TheSDF method is based on the
Rational method but utilizing regional coefficients. For a detailed description of this method see Chapter 15 of the UPFLOOD
User's manual (or the SDF user's manual (SDF3)) as well as the Standard Design Flood reports SDF1 and SDF2 titled Statistical analysis of extreme floods, and The standard design flood - theory and practice.
Additional papers can be downloaded below:
The UPFLOOD User manual is not part of the UPFLOOD - version 4.0.0 downloads above. The user manual is only
distributed when a package is purchased. It is distributed as an Adobe Acrobat PDF file and will be available from the
distribution CD. A hard copy of the manual will also be posted to you when you purchase a package.
To obtain your copy contact:
Department of Civil and Biosystems Engineering
Contact person: Mr Marco van Dijk
Tel: 012 420 3176
Fax: 012 362 5218
E-mail: software@sinotechcc.co.za
8. UPDATES/PATCHES
The first windows version released was version 2.0 (August 2001)
The second windows version released was version 3.0 (March 2002)
Version 3.0 was updated to Version 3.0.1 on 18 May 2003
To update from version 3.0 or 3.0.1 to version 4.0.0 click on the update below
UPFLOOD - Update Version 3.0 & 3.0.1 to 4.0.0
(Size: 2.5 MB)
To update from version 4.0.0 & 4.0.1 to version 4.0.2 click on the update below:
UPFLOOD - Update Version 4.0.0 and 4.0.1 to 4.0.2
(Size: 2.5 MB)
The following minor changes were made version 3.0:
- Regflood - Data editing screen
- Detflood and Regflood - General fixing of handling errors
- Detflood - Setting of default data directory
- Detflood - The new Standard Design Flood method
- Updated the help files
- Updated the user manual
The following revisions were made to version 3.0.1:
DETFLOOD
1. The input report now also includes the SDF input data
2. There was an error in the SDF slope calculation that was fixed
3. The SDF method unfortunately always used basin number 1 characteristics to determine the flood peak. This was corrected
4. Some minor spelling mistakes
REGFLOOD
1. Solved the problem with error that occurred stating that Regflood was still running
2. The program now allows the entering of -1 to indicate missing data
General error fixing and the updating of all the help files
The following revisions were made to Version 4.0.0:
DETFLOOD
1. The input report is now all on one screen
2. An electronic copy of the TR102 data has been included with location map
3. Some minor bug fixing
REGFLOOD
1. Frequency distributions can now be plotted together on one graph
2. The program now allows the entering of -1 to indicate missing data
General error fixing and the updating of all the help files
The following revisions were made to Version 4.0.1:
DETFLOOD
1. The fixing of the filename which only allowed 17 characters
2. Fixing the unit hydrograph method S-curve. An error was generated when T/TL was greater than the available data set (Table C3 in users manual), to obtain the Q/Qp curve.
3. Some minor bug fixing
The following revisions were made to Version 4.0.2:
DETFLOOD
1. The fixing of the the TR102 data which resulted in errors when rainfalls more than 1000 mm were read
2. Some minor bug fixing
Note:
Some UPFLOOD users encountered a few problems when they tried to utilize the update file. In REGFLOOD a data editing
screen was added. The data editing screen is in the form of a grid in which you can enter data. This grid however requires the msflxgrid.ocx file to be in the the Windows system directory and it should be registered in the computers registry. In the original
update file this file (msflxgrid.ocx) was included but it created an error for some or other reason and the users could not update
their programs. It was subsequently decided to split the update program into two programs. Follow the following steps to update your version 3.0.0 or 3.0.1 UPFLOOD package:
- Download the "UPFLOOD - Update Version 3.0.0 & 3.0.1 to 4.0.0" file above
- Run the update by double clicking on the file and follow the installation instructions
- Go to UPFLOOD and then to REGFLOOD. Try to create a new project or edit an existing project. If you can do this in
the grid then your update is complete. If not, you will probably get and error relating to the "Msflxgrd.ocx" file.
- If you get the error you have one of two choices:
1. You can download the msflxgrd register.zip file below and update it manually
msflxgrd register.zip
Extract the two support files regsvr32.exe and msflxgrd.ocxwhich are included in the msflxgrd register.zip file
into your Windows System folder. This is usually c:\Windows\System (for Windows 95 and Windows 98 platforms) or c:\Winnt\System32 (for Windows NT 4.0 platform). Note that if either of these files already exist, check they are earlier versions before you overwrite them. It may be
best to copy them elsewhere in case of problems installing these versions. Then run
c:\Windows\System\regsvr32.exe c:\windows\system\msflxgrd.ocx
(Windows 95 or Windows 98 - this should all be on the same line)
or
c:\Winnt\System32\regsvr32.exe c:\winnt\system32\msflxgrd.ocx
(Windows NT 4 - this should all be on the same line)
2. You can download the MSFLXGRID update.exefile below, double click on the downloaded file and follow the installation instructions
MSFLEXGRID update.exe
9. OTHER SUPPORTING INFORMATION
The book Flood Risk Reduction Measures
The book Flood Risk Reduction Measures by Prof WJR Alexander can be obtained by contacting the Department of Civil
and Biosystems Engineering.
Contact person: Mr Marco van Dijk
Tel: 012 420 3176
Fax: 012 362 5218
E-mail: mvd@sinotechcc.co.za
The cost of the book is R460 (excluding VAT and postage cost)
Return to top of page
|