PeakFQ Annual Flood Frequency Analysis Using Bulletin 17B Guidelines Version 5.2 2007/11/01 ---> ---> NOTICE: Compiled for Windows XP. ---> ---> Most people seem to be successful installing under Windows 7 32-bit ---> Installation under Windows 64-bit and under some Windows 7-32 bit ---> will require a Windows XP emulator. You may have success with the ---> virtual PC from Microsoft, see ---> ---> http://www.microsoft.com/windows/virtual-pc/download.aspx ---> ---> New, PeakFQ Version 7 coming soon (no version 6 distribution) ---> For assistance, enhancement requests, or to report bugs, contact the Office of Surface Water by sending e-mail to h2osoft@usgs.gov. A. Quick Start 1. If you have previously installed version 5.0 or later of PEAKFQ or PKFQWin use the "Add/Remove Programs" under the "Settings-Control Panel" Window to uninstall all of them before installing the new versions. (Note: if you have peakfq4.1 or earlier installed, it is not necessary to remove it, you may have both versions of the program on your computer.) 2. From http://water.usgs.gov/usgs/software/peakfq.html, download PKFQWin_5.2.exe 3. To launch the installation, double click on the downloaded PKFQWin_5.0.exe If you accept all defaults during the installation process, PeakFQ will be installed in C:\Program Files\PKFQWin, a PKFQWin icon will be placed on your desktop, and PKFQWin will be added under USGS under Start/Programs. 4. PKFQWin (the interacive interface) is launched by a. clicking on the desktop PKFQWin icon or b. selecting PKFQWin from Start / Programs / USGS 5. The user's manual is available as a Windows help document and a pdf file. It can be accessed by a. selecting PKFQWin Help under the Help pull down in PKFQWin b. opening C:\Program Files\PKFQWin\doc\Peakfq.chm. c. opening C:\Program Files\PKFQWin\doc\UsersManual_tm4b4.pdf 6. Bulletin 17B is available as a PDF file and can be found at a. C:\Program Files\PKFQWin\doc\Bulletin17B.pdf b. http://water.usgs.gov/osw/bulletin17b/bulletin_17B.html. B. Input Files PeakFQ recognizes 3 input data file formats, information on these file formats can be found in the user's manual (see A.5 above). 1. WATSTORE standard format 2. Watershed Data Management (WDM) file 3. Program Specification File (psf) Annual peak flows are available in the WATSTORE standard format from NWIS-Web, see http://nwis.waterdata.usgs.gov/usa/nwis/peak. (Note: the PeakFQ program CANNOT read the Tab-separated format.) C. Test Data Files and Expected Results Test data is provided as an example and to test the program. Assuming a default installation, see: Program Files\PKFQWin\test - batch files Program Files\PKFQWin\test\Data_in - input files Program Files\PKFQWin\test\Expected - expected results The tests are described in the table below, where 'test' is the test number, 'program' is the program used to run the test, and the 'usage' column indicates how a file is used, with i for input, o for output, and i/o for both input and output. The 3 tests can be run by double clicking on the test.bat file in the test folder. Alternatively, open a DOS Command Prompt window and type: test [begin [end]] where begin is the beginning test number, default is 1 end is the ending test number, default is 3 examples: test test 1 2 test 3 Differences between the expected results and the actual results will be reported in the file check.log. Expect to see differences in the dates. test program description of test and files file name & usage ---- ------- ------------------------------------- ------------------ 1 PeakFQ flood frequency analysis with data from text file, has I records specification file test1.psf i peak flow input file test1.inp i output file test1.prt o additional output, Watstore format test1.bcd o processing & error file test1.err o plot files PKFQ-[1-10].WMF o 2 PeakFQ flood frequency analysis with data from text file, no I records specification file test2.psf i peak flow input file test2.inp i output file test2.prt o additional output, table format test2.bcd o processing & error file test2.err o 3 -- If the wdm file does not exist in the peakfq data directory, iowdm is run to build the file. If it does exist, the iowdm step is skipped. iowdm build WDM file When the iowdm program opens up, type: @build.log command file build.log i peak flows test2.inp i data management file test.wdm o summary of processed data test3.era o PeakFQ flood frequency analysis with data from WDM file specification file test3.psf i peak flow input file test.wdm i/o output file test3.prt o additional output, table format test3.bcd o processing & error file test3.err o plot files PKFQ-[1-10].BMP o 4 annie archive data sets from test.wdm When the annie program opens up, type: @archive.log command file archive.log i peak flow data file test.wdm i/o archived data sets test4.exp o processing & error file test4.err o