GWF-MVR

Structure of Blocks

FOR EACH SIMULATION

    BEGIN OPTIONS
      [PRINT_INPUT]
      [PRINT_FLOWS]
      [MODELNAMES]
      [BUDGET FILEOUT <budgetfile>]
      [BUDGETCSV FILEOUT <budgetcsvfile>]
    END OPTIONS
    BEGIN DIMENSIONS
      MAXMVR <maxmvr>
      MAXPACKAGES <maxpackages>
    END DIMENSIONS
    BEGIN PACKAGES
      [<mname>] <pname>
      [<mname>] <pname>
      ...
    END PACKAGES

FOR ANY STRESS PERIOD

    BEGIN PERIOD <iper>
      [<mname1>] <pname1> <id1> [<mname2>] <pname2> <id2> <mvrtype> <value>
      [<mname1>] <pname1> <id1> [<mname2>] <pname2> <id2> <mvrtype> <value>
      ...
    END PERIOD

Explanation of Variables

Block: OPTIONS

  • PRINT_INPUT keyword to indicate that the list of MVR information will be written to the listing file immediately after it is read.

  • PRINT_FLOWS keyword to indicate that the list of MVR flow rates will be printed to the listing file for every stress period time step in which “BUDGET PRINT” is specified in Output Control. If there is no Output Control option and “PRINT_FLOWS” is specified, then flow rates are printed for the last time step of each stress period.

  • MODELNAMES keyword to indicate that all package names will be preceded by the model name for the package. Model names are required when the Mover Package is used with a GWF-GWF Exchange. The MODELNAME keyword should not be used for a Mover Package that is for a single GWF Model.

  • BUDGET keyword to specify that record corresponds to the budget.

  • FILEOUT keyword to specify that an output filename is expected next.

  • budgetfile name of the output file to write budget information.

  • BUDGETCSV keyword to specify that record corresponds to the budget CSV.

  • budgetcsvfile name of the comma-separated value (CSV) output file to write budget summary information. A budget summary record will be written to this file for each time step of the simulation.

Block: DIMENSIONS

  • maxmvr integer value specifying the maximum number of water mover entries that will specified for any stress period.

  • maxpackages integer value specifying the number of unique packages that are included in this water mover input file.

Block: PACKAGES

  • mname name of model containing the package. Model names are assigned by the user in the simulation name file.

  • pname is the name of a package that may be included in a subsequent stress period block. The package name is assigned in the name file for the GWF Model. Package names are optionally provided in the name file. If they are not provided by the user, then packages are assigned a default value, which is the package acronym followed by a hyphen and the package number. For example, the first Drain Package is named DRN-1. The second Drain Package is named DRN-2, and so forth.

Block: PERIOD

  • iper integer value specifying the starting stress period number for which the data specified in the PERIOD block apply. IPER must be less than or equal to NPER in the TDIS Package and greater than zero. The IPER value assigned to a stress period block must be greater than the IPER value assigned for the previous PERIOD block. The information specified in the PERIOD block will continue to apply for all subsequent stress periods, unless the program encounters another PERIOD block.

  • mname1 name of model containing the package, PNAME1.

  • pname1 is the package name for the provider. The package PNAME1 must be designated to provide water through the MVR Package by specifying the keyword “MOVER” in its OPTIONS block.

  • id1 is the identifier for the provider. For the standard boundary packages, the provider identifier is the number of the boundary as it is listed in the package input file. (Note that the order of these boundaries may change by stress period, which must be accounted for in the Mover Package.) So the first well has an identifier of one. The second is two, and so forth. For the advanced packages, the identifier is the reach number (SFR Package), well number (MAW Package), or UZF cell number. For the Lake Package, ID1 is the lake outlet number. Thus, outflows from a single lake can be routed to different streams, for example.

  • mname2 name of model containing the package, PNAME2.

  • pname2 is the package name for the receiver. The package PNAME2 must be designated to receive water from the MVR Package by specifying the keyword “MOVER” in its OPTIONS block.

  • id2 is the identifier for the receiver. The receiver identifier is the reach number (SFR Package), Lake number (LAK Package), well number (MAW Package), or UZF cell number.

  • mvrtype is the character string signifying the method for determining how much water will be moved. Supported values are “FACTOR” “EXCESS” “THRESHOLD” and “UPTO”. These four options determine how the receiver flow rate, Q_R, is calculated. These options mirror the options defined for the cprior variable in the SFR package, with the term “FACTOR” being functionally equivalent to the “FRACTION” option for cprior.

  • value is the value to be used in the equation for calculating the amount of water to move. For the “FACTOR” option, VALUE is the alpha factor. For the remaining options, VALUE is the specified flow rate, Q_S.

Example Input File

    BEGIN OPTIONS
      PRINT_INPUT
      PRINT_FLOWS
    END OPTIONS
    
    BEGIN DIMENSIONS
      MAXMVR 16
      MAXPACKAGES 5
    END DIMENSIONS
    
    BEGIN PACKAGES
      MAW-1
      MAW-2
      SFR-1
      LAK-1
      UZF-1
    END PACKAGES
    
    BEGIN PERIOD 1
    # ***PROVIDER***   ***RECEIVER***  ***FLOW INFO**
    #  PAK1  PAK1RCH    PAK2  PAK2RCH  TYPE     VALUE
      MAW-1        1   MAW-2       21  EXCESS    5.00
      MAW-1       11   SFR-1       77  FACTOR    0.25
      MAW-1       21   UZF-1       93  FACTOR    0.01
      MAW-1       21   LAK-1        3  FACTOR    1.00
    
      SFR-1     1021   MAW-1       21  THRESHOLD 10.0
      SFR-1      441   SFR-1       77  FACTOR    0.10
      SFR-1       56   UZF-1       93  FACTOR    0.10
      SFR-1     4587   LAK-1        3  FACTOR    1.00
    
      UZF-1        4   MAW-1       11  FACTOR    1.00
      UZF-1        5   SFR-1       22  FACTOR    1.00
      UZF-1        6   UZF-1       45  FACTOR    1.00
      UZF-1        7   LAK-1        3  FACTOR    1.00
    
      LAK-1        1   MAW-1       11  EXCESS    1000.
      LAK-1        2   SFR-1       22  UPTO      2000.
      LAK-1        3   UZF-1       45  UPTO      3000.
      LAK-1        4   LAK-1        3  UPTO      3000.
    END PERIOD 1