GWF-WELG

Structure of Blocks

FOR EACH SIMULATION

    BEGIN OPTIONS
      READARRAYGRID
      [AUXILIARY <auxiliary>]
      [AUXMULTNAME <auxmultname>]
      [PRINT_INPUT]
      [PRINT_FLOWS]
      [SAVE_FLOWS]
      [AUTO_FLOW_REDUCE <auto_flow_reduce>]
      [AUTO_FLOW_REDUCE_CSV FILEOUT <afrcsvfile>]
      [FLOW_REDUCTION_LENGTH]
      [OBS6 FILEIN <obs6_filename>]
      [MOVER]
      [EXPORT_ARRAY_NETCDF]
    END OPTIONS

    BEGIN DIMENSIONS
      [MAXBOUND <maxbound>]
    END DIMENSIONS

FOR ANY STRESS PERIOD

    BEGIN PERIOD <iper>
      Q [LAYERED] [NETCDF]
            <q(nodes)> -- READARRAY
      [AUX [LAYERED] [NETCDF]
            <aux(nodes)> -- READARRAY]
    END PERIOD

Explanation of Variables

Block: OPTIONS

  • READARRAYGRID indicates that array-based grid input will be used for the well boundary package. This keyword must be specified to use array-based grid input. When READARRAYGRID is specified, values must be provided for every cell within a model grid, even those cells that have an IDOMAIN value less than one. Values assigned to cells with IDOMAIN values less than one are not used and have no effect on simulation results. No data cells should contain the value DNODATA (3.0E+30).

  • auxiliary defines an array of one or more auxiliary variable names. There is no limit on the number of auxiliary variables that can be provided on this line; however, lists of information provided in subsequent blocks must have a column of data for each auxiliary variable name defined here. The number of auxiliary variables detected on this line determines the value for naux. Comments cannot be provided anywhere on this line as they will be interpreted as auxiliary variable names. Auxiliary variables may not be used by the package, but they will be available for use by other parts of the program. The program will terminate with an error if auxiliary variables are specified on more than one line in the options block.

  • auxmultname name of auxiliary variable to be used as multiplier of well flow rate.

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

  • PRINT_FLOWS keyword to indicate that the list of well 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.

  • SAVE_FLOWS keyword to indicate that well flow terms will be written to the file specified with “BUDGET FILEOUT” in Output Control.

  • auto_flow_reduce keyword and real value that defines the fraction of the cell thickness used as an interval for smoothly adjusting negative pumping rates to 0 in cells with head values less than or equal to the bottom of the cell. Negative pumping rates are adjusted to 0 or a smaller negative value when the head in the cell is equal to or less than the calculated interval above the cell bottom. AUTO_FLOW_REDUCE is set to 0.1 if the specified value is less than or equal to zero. By default, negative pumping rates are not reduced during a simulation. This AUTO_FLOW_REDUCE option only applies to wells in model cells that are marked as “convertible” (ICELLTYPE /= 0) in the Node Property Flow (NPF) input file. Reduction in flow will not occur for wells in cells marked as confined (ICELLTYPE = 0).

  • AUTO_FLOW_REDUCE_CSV keyword to specify that record corresponds to the AUTO_FLOW_REDUCE output option in which a new record is written for each well and for each time step in which the user-requested extraction rate is reduced by the program.

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

  • afrcsvfile name of the comma-separated value (CSV) output file to write information about well extraction rates that have been reduced by the program. Entries are only written if the extraction rates are reduced.

  • FLOW_REDUCTION_LENGTH keyword that indicates the AUTO_FLOW_REDUCE value is a length instead of a fraction of the cell thickness. A warning will be issued if the FLOW_REDUCTION_LENGTH option is specified but the AUTO_FLOW_REDUCE option is not specified in the options block. The program will terminate with an error if the FLOW_REDUCTION_LENGTH option is specified and the AUTO_FLOW_REDUCE value specified in the options block is less than or equal to zero.

  • FILEIN keyword to specify that an input filename is expected next.

  • OBS6 keyword to specify that record corresponds to an observations file.

  • obs6_filename name of input file to define observations for the WEL package. See the “Observation utility” section for instructions for preparing observation input files. Table ref{table:gwf-obstypetable} lists observation type(s) supported by the WEL package.

  • MOVER keyword to indicate that this instance of the Well Package can be used with the Water Mover (MVR) Package. When the MOVER option is specified, additional memory is allocated within the package to store the available, provided, and received water.

  • EXPORT_ARRAY_NETCDF keyword that specifies input gridded arrays should be written to the model output NetCDF file with attributes that support using the generated file as a MODFLOW 6 simulation input. This option only has an effect when an output model NetCDF file is configured and the simulation is run in VALIDATE mode, otherwise it is ignored.

Block: DIMENSIONS

  • maxbound integer value specifying the maximum number of wells cells that will be specified for use during any stress period.

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.

  • q is the volumetric well rate. A positive value indicates recharge (injection) and a negative value indicates discharge (extraction).

  • aux is an array of values for auxiliary variable aux(iaux), where iaux is a value from 1 to naux, and aux(iaux) must be listed as part of the auxiliary variables. A separate array can be specified for each auxiliary variable. If the value specified here for the auxiliary variable is the same as auxmultname, then the well rate array will be multiplied by this array.