MULT - Multiplier File

Top  Previous  Next  Print

Abbreviation in Name file

MULT

Purpose

The Multiplier File  is used to specify multiplier arrays which can be used to calculate layer variables from parameter values.

Documentation

Supported in

MODFLOW-2000
MODFLOW-2005

Input Instructions

Input to define multiplier arrays is read from the file that is specified with "MULT" as the file type. Multiplier arrays can be used to calculate layer variables from parameter values.

FOR EACH SIMULATION

0.

[#Text]

Item 0 is optional—“#” must be in column 1. Item 0 can be repeated multiple times.

Text—is a character variable (199 characters) that starts in column 2. Any characters can be included in Text. The “#” character must be in column 1. Except for the name file, lines beginning with # are restricted to these first lines of the file. Text is printed when the file is read.

1.

NML—is the number of multiplier arrays to be defined. The maximum number of multiplier arrays is 500.

Repeat items 2-4 for each of the NML multiplier arrays

2.

MLTNAM [ FUNCTION]

MLTNAM—is the name of a multiplier array. This name can consist of 1 to 10 characters and is not case sensitive. That is, any combination of the same characters with different case are equivalent. The name “NONE” should not be used for a multiplier array because it is a reserved word. The optional keyword, FUNCTION, indicates that the multiplier array will be constructed from other multiplier arrays that have already been defined. Construction is by arithmetic combinations of the multipliers; see the explanation below for variable op1, op2, op3 ....

3.

[RMLT(NCOL,NROW)] - U2DREL

If Item 2 does not contain the optional FUNCTION keyword, read Item 3

RMLT—is a multiplier array.

4.

[MLTNAM1 [op1 MLTNAM2] [op2 MLTNAM3] [op3 MLTNAM4] ... ] [IPRN]

Otherwise, if Item 2 contains the optional FUNCTION keyword, read Item 4

MLTNAM1, MLTNAM2, MLTNAM3, ...—are the names of multiplier arrays that have already been defined. op1, op2, op3, ...—are arithmetic operators used to define a multiplier array based on other multiplier arrays. Each operator can be either “+”, “-”, “*”, or “/”. Operations are applied from left to right to each array element. The operators must be separated from the multiplier array names by at least one space.

IPRN is a flag that indicates if the array defined in Item 4 should be printed (written to the listing file) after it has been generated and a code for indicating the format that should be used when it is printed.

If IPRN < 0, printing of the multiplier array is suppressed.

Example Multiplier Array Input Using the FUNCTION Keyword

The following example input illustrates the use of the FUNCTION keyword to construct a multiplier array from other multiplier arrays. In this example, three multiplier arrays are defined. The first two arrays (named M1 and M2) are read using the U2DREL utility array reader (item 3), and the third array (named M3) is defined as the sum of the other two. In this example, a model layer has 5 rows and 4 columns.

 

3

M1

INTERNAL 1.0 (4F6.0) 0

1.0 1.1 1.2 1.3

1.0 1.1 1.2 1.3

2.0 2.2 2.4 2.6

2.0 2.2 2.4 2.6

1.0 1.1 1.2 1.3

M2

INTERNAL 1.0 (4F6.0) 0

5.0 5.1 5.2 5.3

5.0 5.1 5.2 5.3

6.0 6.1 6.2 6.3

6.0 6.1 6.2 6.3

5.0 5.1 5.2 5.3

M3 FUNCTION

M1 + M2

 

The resulting values for multiplier M3 are:

 

6.0 6.2 6.4 6.6

6.0 6.2 6.4 6.6

8.0 8.3 8.6 8.9

8.0 8.3 8.6 8.9

6.0 6.2 6.4 6.6