                            AGNPS Version 5.00 Input File (*.DAT) Format Guide 

The data file values arThe e kept in a column format.  There is some indenting and section names to allow for easier editing and reading of the data file.

I.  FILE HEADER
======================================================================================================================================================
The header file is found at the top of the file and it consists of 6 lines.

LINE    VAR  NAME      DESCRIPTION                        FORMAT UNITS RANGE              LOCATION

LINE 1  1.   Version Identification                       Version number of the data file A27     ---  "AGNPS SCS-TR55 format 5.00"

LINE 2  1.   Error log flag       Write Error Log output file flag?    I8                 ---     0 = no output  1 = output file
   2.   Source Accounting flag    Write Source Acctg binary file flag? I8                 ---     0 = no output  1 = output file
   3.   Hydrology file flag       Write Hydrology binary file flag?    I8                 ---     0 = no output  1 = output file
   4.   Sediment file flag        Write Sediment binary file flag?     I8                 ---     0 = no output  1 = output file
   5.   Nutrient file flag        Write Nutrient binary file flag?     I8                 ---     0 = no output  1 = output file
   6.   Pesticide file flag       Write Pesticide binary file flag?    I8                 ---     0 = no output  1 = output file

LINE 3  1.   Watershed name       The name of the watershed      A30   ---                ---     initial data

LINE 4  1.   Description          Watershed Description   A30    ---   ---                initial data

LINE 5  1.   Base cell area       Base area for all cells in watershed F16.2              acres   0.01 - 1000    initial data

   2.   Number base cells         Number of base cells    I8     number                   1 - 30,000 (?)    initial data

   3.   Number of columns         Total number of cells in watershed   I8                 number  1 - 30,000 (?) initial data
             including divided cells

   4.   Hydrology Calculation     Method of peak flow calculation      I8                 ---     0 - 1     initial data
        Indicator                                                      0 = TR55
                                                          1 = CREAMS

   5.   Geomorphic Indicator      Geomorphic calculation indicator     I8                 ---     0 - 1     initial data
                                                          0 = Non-Geomorphic
                                                          1 = use Geomorphic

   6.   k coefficient             Indicator for which way to calculate                    I8      ---  0 or 1    initial data
             the peak of the hydrograph                                0 = calc. using prepeak fraction
                                                          1 = calc. using the k-coef

   7.   k coef value or prepeak % if k coef = 1 this is the k coef value                  F8.2    k coef    ---  initial data
             if k coef = 0 this is the prepeak %                 %
             (See k coef above)

LINE 6  1.   Storm Type           SCS Storm Type          A16    ---   1 - 3,I,Ia,II,III  initial data

   2.   Storm energy intensity    Energy Intensity value for the storm F8.2               ---     0 - 999   initial data

   3.   Storm duration            Duration of storm rainfall     F8.1  hours              0 - 999 initial data

   4.   Storm rainfall            Amount of rainfall during storm      F8.2               inches  0.1 - 999 initial data

   5.   Rainfall nitrogen         Nitrogen concentration in rainfall   F8.2               ppm     0 - 10    initial data


II.  REQUIRED CELL INFORMATION
======================================================================================================================================================
The following data is produced for each cell.  The second and third lines are all indented 8 spaces.  This is done so that the cell number sticks out on each line making it
easy to locate the beginning of each cell.

LINE     VAR       NAME       DESCRIPTION             FORMAT UNITS RANGE              LOCATION

LINE 1   1. Cell number       Base cell number        I8     ---   1 - 30,000 (?)     column data

    2.   Cell division        Cell division number    I8     ---   0 - 444            column data

    3.   Receiving cell number                        Receiving cell base number      I8      ---  1 - 30,000 (?) column data

    4.   Receiving cell division                      Receiving cell division number  I8      ---  0 - 444   column data

    5.   Flow direction       Direction receiving cell is from     I8                 ---     0 - 8     column data
            current cell                                     0 = Sink Hole Cell
                                                             1 = North direction
                                                             2 = NorthEast direction
                                                             3 = East
                                                             4 = SouthEast
                                                             5 = South
                                                             6 = SouthWest
                                                             7 = West
                                                             8 = NorthWest

    6.   Curve number         SCS curve number for the cell  F8.2  ---                0 - 100 management

    7.   Average land slope   Average slope of the land in the cell                   F8.1    %    0 - 99.9  slope data

    8.   Slope shape code     Land slope shape code   I8     ---   1 - 3              slope data
                                                             1 = uniform
                                                             2 = convex slope
                                                             3 = concave slope

LINE 2   1. Slope length      Overland slope length   I16    feet  0 - 999            slope data

    2.   Overland Mannings    Overland mannings roughness coeff.   F8.3               ---     0.001 - 0.990  column data

    3.   Soil erodibility Factor                      Soil erodibility factor (K-factor)      F8.2 ---  0 - 0.99  soil data

    4.   Cropping factor      Cropping factor (C-factor)     F8.4  ---                0.0 - 1.0    management

    5.   Practice factor      Practice factor (P-factor)     F8.2  ---                0 - 1.00     management

    6.   Surface condition constant                   Surface condition constant      F8.2    ---  0 - 1.00  management

    7.   COD factor           Chemical oxygen demand factor  I8    mg/l               0 - 170 management


LINE 3   1. Soil type         Soil type reference code       I16   ---                0 - 4   soil data
                                                             0 = water
                                                             1 = sand
                                                             2 = silt
                                                             3 = clay
                                                             4 = peat

    2.   Fertilizer level     Level of fertilizer applied    I8    ---                0 - 4
                                                             0 = No Application
                                                             1 = Low
                                                             2 = Average
                                                             3 = High
                                                             4 = User supplied amounts

    3.   Pesticide type       Type of the pesticide applied  I8    ---                0 - 6
                                                             0 = None
                                                             1 = Herbicide
                                                             2 = Insecticide
                                                             3 = Fungicide
                                                             4 = Nematicide
                                                             5 = Plant Growth Regulator
                                                             6 = Dessicant or Defoliant

    4.   Number of point sources                      Total number of point sources, both     I8   ---  0 - 9     column data
            feedlots and nonfeedlots
                                                      
    5.   # of Additional Erosion                      Number of Additional erosion sources    I8   ---  0 - 99    sources
         Sources              within the cell

    6.   Number of impoundments                       Number of impoundments within the cell  I8   ---  0 - 13    column data

    7.   Type of channel      Channel Indicator       I8     ---   0 - 8              channel data
                                                             0 = water cell
                                                             1 = no definitive channel
                                                             2 = drainage ditch
                                                             3 = road ditch
                                                             4 = grass waterway
                                                             5 = ephemeral stream
                                                             6 = intermittent stream
                                                             7 = perennial stream
                                                             8 = other type of channel
The following sections contain detailed information for each cell based on the values that are in line 3 of the Cell data.  Each section begins with a section header
describing the type of data.  NOTE:  The channel information will exist for every cell in the watershed!

III.  OPTIONAL SOIL INFORMATION
=====================================================================================================================================================
There are two lines of soil information.  This optional soil line is included for all of the soil types, except water.  In a water cell, we assume that all the values are
zero.  Note that the word "Soil:" precedes the first line.  This is to help the user in editing and reading the data file.

LINE     VAR       NAME       DESCRIPTION             FORMAT UNITS RANGE              LOCATION

LINE 1:  1. Soil Section Header                       Descriptor Header of Soil data  A8      ---  "Soil:"

    2.   Base soil Nitrogen   Nitrogen present in the soil   F8.4  lb N/lb soil       Soil Data

    3.   Base soil Phosphorus Phosphorus present in the soil F8.4  lb P/lb soil       Soil Data

    4.   Pore Nitrogen        Nitrogen present in soil pores F8.2  ppm                        Soil Data

    5.   Pore Phosphorus      Phosphorus present in soil pores     F8.2               ppm          Soil Data

LINE 2:  1. Extraction runoff N                       Nitrogen that is extracted into runoff  F16.3     ---       Soil Data

    2.   Extraction runoff P  Phosphorus extracted into runoff     F8.3               ---          Soil Data

    3.   Extraction leaching N                        Nitrogen that is leached into soil      F8.3 ---       Soil Data

    4.   Extraction leaching P                        Phosphorus that is leached into soil    F8.3 ---       Soil Data

    5.   % Organic Matter in Soil                     % organic matter remaining in the soil  I8   %    0 - 100


IV.  OPTIONAL FERTILIZER INFORMATION
======================================================================================================================================================
The fertilizer line is optional depending if the user has applied fertilizer to this cell.  This is indicated by either a zero or a one for the  fertilizer indicator in
line 3 of the cell data.  A zero means no fertilizer was applied and a 1 indicates that fertilizer was applied in the cell.

LINE 1:  1. Fertilizer Section Header                 Descriptive header of Fertilizer data   A8   ---  "Fert:"

    2.   Nitrogen application rate                    Rate of nitrogen application    I8      lbs/acre       Mgmt Data

    3.   Phosphorus application rate                  Rate of phosphorus application  I8      lbs/acre       Mgmt Data

    4.   N Availability factor                        Available Nitrogen in top half inch     I8   %    0 - 100   Mgmt Data
            of the soil

    5.   P Availability factor                        Available Phosphorus in top half inch   I8   %    0 - 100   Mgmt Data
            of the soil
V.  OPTIONAL PESTICIDE INFORMATION
======================================================================================================================================================
The pesticide data is optional depending if the user has applied a pesticide to this cell.

LINE     VAR       NAME       DESCRIPTION             FORMAT UNITS RANGE              LOCATION

LINE 1:  1. Pesticide Section Header                  Descriptive header of Pesticide data    A8   ---  "Pest:"

    2.   Pesticide Common Name                        Common name of the pesticide applied    A30  ---

    3.   Pesticide Trade Name Trade name of the pesticide applied  A25                ---

LINE 2:  1. Time of application                       Time of application             I16     ---  1 - 3
                                                             1 = Preplant
                                                             2 = Preemergence
                                                             3 = Postemergence

    2.   Time since application                       Time since the pesticide was applied    F8.1 Days

    3.   Application rate     Rate of pesticide application  F8.2  lbs/acre

    4.   Application efficiency                       Efficiency of application       I8      %

    5.   Canopy cover         Canopy cover of cell    I8     %

LINE 3   1. Initial soil residue                      Amount of pesticide on the soil         F16.2     lbs/acre
            surface prior to the event

    2.   Soil residue half life                       Pesticide half Life on residue  F8.1    Days

    3.   Incorporation depth  Depth of incorporation into soil     F8.2               inches

    4.   Incorporation efficiency                     Efficiency of incorporation into soil   I8   %    0 - 100+   ** can be > 100%

    5.   Solubility in water  Pesticide solubility in water  F12.3 ppm

    6.   Organic carbon sorption                      Organic Carbon Sorption Rate (KOC)      F12.3

LINE 4   1. Initial foliar residue                    Amount of pesticide on the soil F16.2   lbs/acre
            surface prior to the the event

    2.   Foliar washoff threshold                     Amount of precipitation required        F8.2 inches
            before the pesticide starts to wash off

    3.   Foliar washoff fraction                      Fraction of the pesticide that will     I8   %    0 - 100
            wash off

    4.   Foliar residue half life                     Pesticide half life on foliage  F8.1    DaysVI.  OPTIONAL NON-FEEDLOT INFORMATION
======================================================================================================================================================
The non-feedlot data exists only if point sources exist and at least one of the point sources is a non-feedlot.  To determine which type of point source, the AGNPS program
reads the point source section header found on the first line of each type of point source data.  A total of 9 point sources (non-feedlot and feedlot) is allowed per cell.

LINE     VAR       NAME       DESCRIPTION             FORMAT UNITS RANGE              LOCATION

LINE 1:  1. NonFeedlot Section Header                 Descriptive header for NonFeedlot data  A8   ---  "NonFdlt:"

    2.   Water discharge      Discharge from the point source      F8.3               cfs

    3.   Total Nitrogen       Nitrogen discharge from the pt source                   F8.2    ppm

    4.   Total Phosphorus     Phosphorus discharge from pt source  F8.2               ppm

    5.   Total COD            COD discharge from the point source  F8.2               ppm

    6.   Location of point source                     Location of point source in the cell:   I8   ---  0 - 1
                                                             1 = top
                                                             0 = bottom


VII.  OPTIONAL FEEDLOT INFORMATION
======================================================================================================================================================

LINE 1:  1. Feedlot Section Header                    Descriptive header of Feedlot data      A8   ---  "Feedlot:"

    2.   Feedlot area         Area of the feedlot     F8.2   acres

    3.   Feedlot curve number Curve number of the feedlot    F8.2  ---                0 - 100

    4.   Roofed area          Roofed area of the feedlot     F8.2  acres

    5.   Feedlot Nitrogen     Nitrogen concentration in the feedlot                   I8      ppm

    6.   Feedlot Phosphorus   Phosphorus conc. in the feedlot      I8                 ppm

    7.   Feedlot COD          COD concentration in the feedlot     I8                 ppm

LINE 2   1. AGNPS buffer calc. ind.                   Buffer calculation indicator    I16     ---  0 - 1
                                                             0 = user enters buffer reduction values
                                                             1 = use AGNPS buffer calculations

    If the user selects to enter their own buffer reduction numbers, they must fill in the values for the following variables.  If the user wants AGNPS to calculate
    these values, then the following values are left as zeroes and the AGNPS model calculates the correct values.

    2.   Decrease N overland  Decrease in Nit. due to overland flow                   F8.1    %

    3.   Decrease P overland  Decrease in Phos. due to overland flow                  F8.1    %

    4.   Decrease COD overland                        Decrease in COD due to overland flow    F8.1 %

    5.   Decrease N grass     Decrease in Nit. due to flow through F8.1               %
            grass buffer strip.

    6.   Decrease P grass     Decrease in Phos. due to flow through                   F8.1    %
            grass buffer strip.

    7.   Decrease COD grass   Decrease in COD due to flow through  F8.1               %
            grass buffer strip.

The following line of data is repeated for each of the feedlot's Area 2 and Area 3's six subareas.  The subareas are used to represent variable characteristics within Area
2 and Area 3.  It is NOT required to use all 6 subareas.

LINES 3-8:  ( "i" represents the subarea 1 - 6 )

    1.   Area 2i's area       Area of tributary 2i    F16.2  acres

    2.   Area 2i's curve number                       Curve number of tributary 2i    F8.2    ---  0 - 100

    3.   Area 3i's area       Area 3i adjacent to the animal feedlot                  F8.2    acres

    4.   Area 3i's curve number                       Curve number of area 3i         I8      ---  0 - 100


The following line of data is repeated for each of the 3 buffer areas in the feedlot.

LINES 9-11:  ( "i" represents the buffer number 1 - 3 )

    1.   Buffer i slope       Slope of the buffer area       F16.2 %                  0 - 100+

    2.   Buffer surface constant                      Surface Condition Constant of buffer i  F8.2 ---  0.0 - 1.0

    3.   Buffer flow length   Flow length of buffer i I8     feet


The following line of data is repeated for each type of animal in the feedlot (only 3 animal types are allowed).

LINES 12-14:  ( "i" represents animal type 1, 2 or 3 )

    1.   Number of type i animals                     Number of type i animals in the feedlot I16

    2.   COD factor           COD factor of type i animals   F8.2

    3.   Animal Phosphorus    Phosphorus of type i animals   F8.2

    4.   Animal Nitrogen      Nitrogen of type i animals     F8.2VIII.  OPTIONAL GULLY INFORMATION
======================================================================================================================================================
The gully information is repeated for each Addtional Erosion Source in the cell.

LINE     VAR       NAME       DESCRIPTION             FORMAT UNITS RANGE              LOCATION

LINE 1:  1. Add'l Erosion Section Header              Descriptive header of Gully data        A8   ---  "Gully:"

    2.   Type of Add'l Erosion                        Type of Additional Erosion indicator    I8   ---  1 - 4
                                                             1 = Gully Source
                                                             2 = Construction
                                                             3 = River Bank
                                                             4 = Other - User supplied name

    3.   Amount of erosion    Amount of erosion from the source    I8                 tons

    4.   Gully Soil Texture   The soil type of the gully soil      I8                 ---     1 - 4
            (same types as for the surface soil)

    5.   Gully Soil Nitrogen  Amount of base nitrogen in gully soil                   F8.4

    6.   Gully Soil Phosphorus                        Amount of phosphorus in gully soil      F8.4

    7.   "Other" Erosion Name User Supplied description of Erosion A21                ** exists ONLY if Type of Additional Erosion = 4!!!
                                                      ** NOTE:  a single space precedes the name in order to separate the name
                                                      from the Amount of Phosphorus!


IX.  OPTIONAL IMPOUNDMENT INFORMATION
======================================================================================================================================================
The impoundment data is repeated for each impoundment in the cell.  A maximum of 13 impoundments is allowed per cell.

LINE 1:  1. Impoundment Section Header                Descriptive header of Impounment data   A8   ---  "Impound:"

    2.   Drainage Area        Impoundment drainage area      F8.1  acres              must be <= cell size!!!

    3.   Pipe diameter        Impoundment pipe diameter      I8    inches             1 - 99

    4.   Infiltration rate    Impoundment infiltration rate  F8.2  in/hr
X.  CHANNEL INFORMATION
======================================================================================================================================================
The channel data exists for each cell, even if the cell is a water cell.

LINE     VAR       NAME       DESCRIPTION             FORMAT UNITS RANGE              LOCATION

LINE 1:  1. Channel Section Header                    Descriptive header of Channel data      A8   ---  "Channel:"

    2.   Channel width        Channel width           F8.2   feet

    3.   Channel width coef.  Geomorphic width coefficient   F8.4

    4.   Channel width exp.   Geomorphic width exponent      F8.4

    5.   Channel depth        Channel depth           F8.2   feet

    6.   Channel depth coef   Geomorphic depth coefficient   F8.4

    7.   Channel depth exp.   Geomorphic depth exponent      F8.4

LINE 2   1. Channel length    Channel Length in the cell     F16.2 feet

    2.   Channel length coef. Geomorphic length coefficient  F8.3

    3.   Channel length exp.  Geomorphic length exponent     F8.4

    4.   Channel slope        Channel slope           F8.2   %     0 - 100+

    5.   Channel side slope   Channel side slope      F8.2   %     0 - 100+

LINE 3   1. Channel Mannings Coef.                    Channel Mannings Coefficient    F16.3   ---  0.001 - 0.990

    2.   AGNPS decay indicator                        Channel flow decay indicator    I8      ---  0 - 1   ( 0 = user supplied  1 = AGNPS )

    3.   Percent nitrogen decay                       % nitrogen decay from channel flow      I8   %    0 - 100

    4.   Percent phosphorus decay                     % phosphorus decay from channel flow    I8   %    0 - 100

    5.   Percent COD decay    % COD decay from channel flow  I8    %                  0 - 100

LINE 4   1. Clay scouring indicator                   Scour clay particles from channel       I16  ---  0 - 1    ( 0 = No Scouring, 1 = Scouring )

    2.   Silt scouring indicator                      Scour silt particles from channel       I8   ---  0 - 1    ( 0 = No Scouring, 1 = Scouring )

    3.   Small Agg. scouring ind.                     Scour small aggregates from the channel I8   ---  0 - 1    ( 0 = No Scouring, 1 = Scouring )

    4.   Large Agg. scouring ind.                     Scour large aggregates from the channel I8   ---  0 - 1    ( 0 = No Scouring, 1 = Scouring )

    5.   Sand scouring Indicator                      Scour sand from the channel     I8      ---  0 - 1    ( 0 = No Scouring, 1 = Scouring )
