Kansas Groundwater Pre-Processor (pumprechv5)



The pumprechv5 program was developed by Kansas to generate pumping and return flow files for the State of Kansas from 2001 on.

During the model development, Kansas estimated pumping and the associated return flows on a county scale, which was then distributed to model cells using the mkgw program based on a well database.

From 2001 onwards, Kansas estimates pumping and recharge at the parcel level based on water use reports. The pumprechv5 program was developed to process this data to model cells.

The pumprechv5 program takes a year as the argument on the command line. It then reads files appropriate to that year from the ../data/ks/gw directory and produces output in the ks subdirectory.

For the year YYYY, the program reads the following input files:

Note that the file ../data/ks/gw/monthlyfactorsbycounty.txt does not change from year to year. The file ../data/ks/40coords.dat also does not change from year to year and is shared with swrechv2.

Irrigation pumping is output in files named ks/YYYY.MM.pmp, where YYYY is the year and MM is the month. M&I pumping is output to ks/YYYY.mi. Return flows from groundwater pumping are output to ks/YYYY.MM.rcg. The groundwater irrigated acreage is saved in ks/YYYY.agw. These files are read by rrpp to produce the MODFLOW-2000 input files.

As the program processes the data, various statistics for quality control and other information such as locations on the edge or outside the model grid are written to files. Two files, ks/checkYYYY.out and ks/outputYYYY.dat contain this information.

In addition, the total pumping, groundwater return for the year and the groundwater acreage for each model cell are written to three files, ks/pumpgridYYYY.dat for pumping, ks/gwretgridYYYY.dat for return flows and ks/gwacresgridYYYY.dat for reported acreage. These files contain the model grid cell x and y coordinate followed by the amount of pumping or return flow in acre feet or the reported acreage in acres. A similar file named ks/YYYYmigrid.dat is output for the M&I net pumping data.

Principles of Operation

Pumping amounts are assigned to model cells based on the coordinates of the point of diversion. As the program processes the pumping data, groundwater return flows and reported acreage are accumulated by overlap group. Groundwater return flows and reported acreage are then assigned to model cells for each overlap group based on the tracts of authorized acreage for the group. The return flows and reported acreage for a given tract of authorized acreage are calculated by prorating the total return flow or acreage for the group by the ratio of the authorized acreage for a particular tract to the total authorized acreage for the group. Groups for which no authorized acreage is provided are noted and the return flows and acreage for these groups are accumulated and reported in an output file. M&I pumping is processed in a manner essentially the same as irrigation pumping except that net pumping is assigned rather than total pumping. The location where the net pumping is assigned is based on the coordinates of the point of diversion.

Input File Descriptions

../data/ks/gw/monthlyfactorsbycounty.txt

Monthly pumping distribution factors by county are read from the file ../data/ks/sw/monthlyfactorsbycounty.txt. This file includes a listing of county numbers followed by factors for months 5 through 10 (May through October). The cell-to-county mapping in ../data0/cty.flg is used to define the counties.

../data/ks/gw/almenapdivsYYYY.txt

Groundwater diversion points within or adjacent to the Almena district and area factor (percentage of groundwater only land within district) are read from the file ../data/ks/gw/almenapdivsYYYY.txt.

The first line defines the number of groundwater diversion points and the groundwater acreage factor. This is followed by a number of lines, each of which contain one of the Almena groundwater diversion point numbers

../data/ks/gw/authacresYYYY.txt

Authorized acreage by overlap group are read from the file ../data/ks/gw/authacresYYYY.txt. Each line in the file defines one overlap group. The values on the line are:
  1. Overlap group number;
  2. Township;
  3. Range;
  4. Section;
  5. 40 acre tract ID (i.e.g quarter-quarter section; numbered 1-16);
  6. Authorized acreage within the 40 acre tract.

../data/ks/gw/pumprechYYYY.txt

Groundwater pumping and irrigated acreage data are read from the file ../data/ks/gw/pumprechYYYY.txt. Each line in the file defines one overlap group. The values on the line are:
  1. Overlap group number;
  2. Point of diversion number (PDIV_ID);
  3. X coordinate;
  4. Y coordinate;
  5. Return flow percentage;
  6. County number;
  7. Pumping amount in acre feet;
  8. Groundwater return amount in acre feet;
  9. Reported acreage in acres.

../data/ks/gw/YYYYmi.txt

M&I net pumping data is read from the file ../data/ks/gw/YYYYmi.txt. Each file defines one location. The values on the line are:
  1. Overlap group number;
  2. Point of diversion number;
  3. X coordinate;
  4. Y coordinate;
  5. Return flow percentage;
  6. Pumping in acre feet;
  7. Groundwater return in acre feet;
  8. Net pumping in acre feet.

../data/ks/sw/40coords.dat

The coordinates for 40-acre tracts (in model coordinates) are read from the file ../data/ks/40coords.dat. Each line in the file defines one 40-acre tract. The values on the line are.
  1. Township
  2. Range
  3. Section
  4. 40 Acre tract ID
  5. X coordinate
  6. Y coordinate

Home | Index | Previous | Next

Model Units
Directory Structure
Programs
Static Files
Precipitation Data Entry
Colorado Data Entry
ET Data Entry
Stream Data Entry
Kansas Data Entry
Nebraska Data Entry
Running the Model