GWT-MWT

Structure of Blocks

FOR EACH SIMULATION

    BEGIN OPTIONS
      [FLOW_PACKAGE_NAME <flow_package_name>]
      [AUXILIARY <auxiliary(naux)>]
      [FLOW_PACKAGE_AUXILIARY_NAME <flow_package_auxiliary_name>]
      [BOUNDNAMES]
      [PRINT_INPUT]
      [PRINT_CONCENTRATION]
      [PRINT_FLOWS]
      [SAVE_FLOWS]
      [CONCENTRATION FILEOUT <concfile>]
      [BUDGET FILEOUT <budgetfile>]
      [BUDGETCSV FILEOUT <budgetcsvfile>]
      [TS6 FILEIN <ts6_filename>]
      [OBS6 FILEIN <obs6_filename>]
    END OPTIONS

    BEGIN PACKAGEDATA
      <mawno> <strt> [<aux(naux)>] [<boundname>]
      <mawno> <strt> [<aux(naux)>] [<boundname>]
      ...
    END PACKAGEDATA

FOR ANY STRESS PERIOD

    BEGIN PERIOD <iper>
      <mawno> <mwtsetting>
      <mawno> <mwtsetting>
      ...
    END PERIOD

Explanation of Variables

Block: OPTIONS

  • flow_package_name keyword to specify the name of the corresponding flow package. If not specified, then the corresponding flow package must have the same name as this advanced transport package (the name associated with this package in the GWT name file).

  • 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.

  • flow_package_auxiliary_name keyword to specify the name of an auxiliary variable in the corresponding flow package. If specified, then the simulated concentrations from this advanced transport package will be copied into the auxiliary variable specified with this name. Note that the flow package must have an auxiliary variable with this name or the program will terminate with an error. If the flows for this advanced transport package are read from a file, then this option will have no effect.

  • BOUNDNAMES keyword to indicate that boundary names may be provided with the list of well cells.

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

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

  • 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.

  • CONCENTRATION keyword to specify that record corresponds to concentration.

  • concfile name of the binary output file to write concentration information.

  • 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 binary 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.

  • TS6 keyword to specify that record corresponds to a time-series file.

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

  • ts6_filename defines a time-series file defining time series that can be used to assign time-varying values. See the “Time-Variable Input” section for instructions on using the time-series capability.

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

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

Block: PACKAGEDATA

  • mawno integer value that defines the well number associated with the specified PACKAGEDATA data on the line. MAWNO must be greater than zero and less than or equal to NMAWWELLS. Well information must be specified for every well or the program will terminate with an error. The program will also terminate with an error if information for a well is specified more than once.

  • strt real value that defines the starting concentration for the well.

  • aux represents the values of the auxiliary variables for each well. The values of auxiliary variables must be present for each well. The values must be specified in the order of the auxiliary variables specified in the OPTIONS block. If the package supports time series and the Options block includes a TIMESERIESFILE entry (see the “Time-Variable Input” section), values can be obtained from a time series by entering the time-series name in place of a numeric value.

  • boundname name of the well cell. BOUNDNAME is an ASCII character variable that can contain as many as 40 characters. If BOUNDNAME contains spaces in it, then the entire name must be enclosed within single quotes.

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.

  • mawno integer value that defines the well number associated with the specified PERIOD data on the line. MAWNO must be greater than zero and less than or equal to NMAWWELLS.

  • mwtsetting line of information that is parsed into a keyword and values. Keyword values that can be used to start the MWTSETTING string include: STATUS, CONCENTRATION, RAINFALL, EVAPORATION, RUNOFF, and AUXILIARY. These settings are used to assign the concentration of associated with the corresponding flow terms. Concentrations cannot be specified for all flow terms. For example, the Multi-Aquifer Well Package supports a “WITHDRAWAL” flow term. If this withdrawal term is active, then water will be withdrawn from the well at the calculated concentration of the well.

      STATUS <status>
  CONCENTRATION <concentration>
  RATE <rate>
  AUXILIARY <auxname> <auxval>

  • status keyword option to define well status. STATUS can be ACTIVE, INACTIVE, or CONSTANT. By default, STATUS is ACTIVE, which means that concentration will be calculated for the well. If a well is inactive, then there will be no solute mass fluxes into or out of the well and the inactive value will be written for the well concentration. If a well is constant, then the concentration for the well will be fixed at the user specified value.

  • concentration real or character value that defines the concentration for the well. The specified CONCENTRATION is only applied if the well is a constant concentration well. If the Options block includes a TIMESERIESFILE entry (see the “Time-Variable Input” section), values can be obtained from a time series by entering the time-series name in place of a numeric value.

  • rate real or character value that defines the injection solute concentration (ML-3) for the well. If the Options block includes a TIMESERIESFILE entry (see the “Time-Variable Input” section), values can be obtained from a time series by entering the time-series name in place of a numeric value.

  • AUXILIARY keyword for specifying auxiliary variable.

  • auxname name for the auxiliary variable to be assigned AUXVAL. AUXNAME must match one of the auxiliary variable names defined in the OPTIONS block. If AUXNAME does not match one of the auxiliary variable names defined in the OPTIONS block the data are ignored.

  • auxval value for the auxiliary variable. If the Options block includes a TIMESERIESFILE entry (see the “Time-Variable Input” section), values can be obtained from a time series by entering the time-series name in place of a numeric value.

Example Input File

    BEGIN OPTIONS
      AUXILIARY  aux1  aux2
      BOUNDNAMES
      PRINT_INPUT
      PRINT_CONCENTRATION
      PRINT_FLOWS
      SAVE_FLOWS
      CONCENTRATION  FILEOUT  gwt_mwt_02.mwt.bin
      BUDGET  FILEOUT  gwt_mwt_02.mwt.bud
      OBS6  FILEIN  gwt_mwt_02.mwt.obs
    END OPTIONS
    
    BEGIN PACKAGEDATA
    # L             STRT             aux1             aux2    bname
      1       0.00000000      99.00000000     999.00000000  MYWELL1
      2       0.00000000      99.00000000     999.00000000  MYWELL2
      3       0.00000000      99.00000000     999.00000000  MYWELL3
    END PACKAGEDATA
    
    BEGIN PERIOD  1
      1  STATUS  ACTIVE
      2  STATUS  ACTIVE
      3  STATUS  ACTIVE
    END PERIOD  1

Available Observation Types

Stress Package Observation Type ID1 ID2 Description
MWT concentration mawno or boundname -- Well concentration. If boundname is specified, boundname must be unique for each well.
MWT storage mawno or boundname -- Simulated mass storage flow rate for a well or group of wells.
MWT constant mawno or boundname -- Simulated mass constant-flow rate for a well or group of wells.
MWT from-mvr mawno or boundname -- Simulated mass inflow into a well or group of wells from the MVT package. Mass inflow is calculated as the product of provider concentration and the mover flow rate.
MWT mwt mawno or boundname iconn or -- Mass flow rate for a well or group of wells and its aquifer connection(s). If boundname is not specified for ID, then the simulated well-aquifer flow rate at a specific well connection is observed. In this case, ID2 must be specified and is the connection number iconn for well mawno.
MWT rate mawno or boundname -- Simulated mass flow rate for a well or group of wells.
MWT fw-rate mawno or boundname -- Simulated mass flow rate for a flowing well or group of flowing wells.
MWT rate-to-mvr well or boundname -- Simulated mass flow rate that is sent to the MVT Package for a well or group of wells.
MWT fw-rate-to-mvr well or boundname -- Simulated mass flow rate that is sent to the MVT Package from a flowing well or group of flowing wells.

Example Observation Input File

    BEGIN options
      DIGITS  12
      PRINT_INPUT
    END options
    
    BEGIN continuous  FILEOUT  gwt_mwt_02.mwt.obs.csv
      mwt1mwt  MWT  1  1
      mwt2mwt  MWT  2  1
      mwt3mwt  MWT  3  1
      mwt4mwt  MWT  4  1
      mwt1conc  CONCENTRATION  1
      mwt2conc  CONCENTRATION  2
      mwt3conc  CONCENTRATION  3
      mwt4conc  CONCENTRATION  4
      mwt1stor  STORAGE  1
      mwt2stor  STORAGE  2
      mwt3stor  STORAGE  3
      mwt4stor  STORAGE  4
      mwt1cnst  CONSTANT  1
      mwt2cnst  CONSTANT  2
      mwt3cnst  CONSTANT  3
      mwt4cnst  CONSTANT  4
      mwt1fmvr  FROM-MVR  1
      mwt2fmvr  FROM-MVR  2
      mwt3fmvr  FROM-MVR  3
      mwt4fmvr  FROM-MVR  4
      mwt1rate  RATE  1
      mwt2rate  RATE  2
      mwt3rate  RATE  3
      mwt4rate  RATE  4
      mwt1rtmv  RATE-TO-MVR  1
      mwt2rtmv  RATE-TO-MVR  2
      mwt3rtmv  RATE-TO-MVR  3
      mwt4rtmv  RATE-TO-MVR  4
      mwt1fwrt  FW-RATE  1
      mwt2fwrt  FW-RATE  2
      mwt3fwrt  FW-RATE  3
      mwt4fwrt  FW-RATE  4
      mwt1frtm  FW-RATE-TO-MVR  1
      mwt2frtm  FW-RATE-TO-MVR  2
      mwt3frtm  FW-RATE-TO-MVR  3
      mwt4frtm  FW-RATE-TO-MVR  4
    END continuous  FILEOUT  gwt_mwt_02.mwt.obs.csv