Online Guide to MODFLOW-2005

MULT - Multiplier File

Hide Navigation Pane

MULT - Multiplier File

Previous topic Next topic No directory for this topic Expand/collapse all hidden text  

MULT - Multiplier File

Previous topic Next topic Topic directory requires JavaScript JavaScript is required for expanding text JavaScript is required for the print function  

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
MODFLOW-LGR
MODFLOW-CFP
MODFLOW-NWT
MODFLOW-OWHM

Other Notes

Multiplier arrays are used in the ADV2 (MODFLOW-2000), ETS, EVT, HUF2, KDEP, LPF, LVDA, RCH, and UPW (MODFLOW-NWT) input files.

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

Data Set 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.

Data Set 1

NML

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

 

Repeat Item 2 with Items 3 or 4 until NML multiplier arrays, vectors, or scalars have been defined.

Data Set 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 ....

is an optional keyword, which indicates that the multiplier array will be constructed from other multiplier arrays, vectors, or scalars that have already been defined. Construction is different from the FUNCTION keyword in that it follows mathematical order of operations with parenthetic support. See explanation for variable Algebraic_Expression.

Data Set 3

[RMLT(NCOL,NROW)] - U2DREL

If Item 2 does not contain the optional FUNCTION key word, read item 3.

RMLT—is a multiplier array.

Data Set 4

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

Item 4 is only read if Item 3 contains the optional FUNCTION key word.

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.

 

[Algebraic_Expression]

Item 5 is only read if Item 3 contains the optional EXPRESSION key word. It is a single mathematical expression composed of previously defined multiplier arrays.

 

Example Multiplier Array Input Using the FUNCTION and EXPRESSION Keywords

The following two example inputs illustrate the use of the FUNCTION and EXPRESSION keywords to construct a multiplier array from other multiplier arrays. In the first example, a model layer that has 5 rows and 4 columns has six multiplier arrays, vectors, or scalars to be defined, and, accordingly, the first line of the file contains “6.” The first two arrays (named M1 and M2) are read using the U2DREL utility array reader (Item 3), the third array (named POW) is a multiplier array set to the number 2. The fourth array (named M4) is defined by using the FUNCTION key word, which follows left to right order of operations. This results in calculating M4 as the sum of M1 and M2, which is then raised to power POW (that is, (M1+M2)POW). The fifth matrix (named M5) is defined by using the EXPRESSION key word, which follows mathematical order of operations and produces an identical multiplier to M4. The sixth matrix (named M6) is defined by using the EXPRESSION key word that calculations M2POW first and then sums the result with M1.

The second example is a more complex application of the EXPRESSION key word that constructs a multiplier matrix composed of a weighted power mean, ExpressionEquation1 and ExpressionEquation2, of two multiplier matrices (n = 2). In this second example there are eight multiplier arrays, vectors, or scalars to be defined, and accordingly the first line of the file contains “8”. The first two multiplier arrays, vectors, or scalars (named X1 and X2) define x1 and x2. The third multiplier array (named POW) defines the power mean power, p, which for this case is –1 to represent a harmonic mean. The fourth multiplier matrix is a matrix composed of all ones. The fifth multiplier (named W1) is the first weight, w1, read from a free formatted external file. The sixth multiplier (named W2) is the second weight, w2 = 1 – w1, which is constructed using the FUNCTION key word (left to right order of operations). The seventh multiplier (named PowerMean1) solves the power mean using W2 with the EXPRESSION key word. The eighth multiplier (named PowerMean2) solves the power mean without using W2 via the EXPRESSION key word.

EXAMPLE 1

7

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

POW

CONSTANT 2.0

M3 FUNCTION

M1+M2

M4 FUNCTION

M1+M2^POW

M5 EXPRESSION

(M1+M2)^POW

M6 EXPRESSION

M1+M2^POW

 

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

 

The resulting values for multiplier M5 are:

 

36.00 38.44 40.96 43.56

36.00 38.44 40.96 43.56

64.00 68.89 73.96 79.21

64.00 68.89 73.96 79.21

36.00 38.44 40.96 43.56

 

The resulting values for multipliers M4 and M6 are:

 

26.00 27.11 28.24 29.39

26.00 27.11 28.24 29.39

38.00 39.41 40.84 42.29

38.00 39.41 40.84 42.29

26.00 27.11 28.24 29.39

 

EXAMPLE 2

8

X1                                                   #FIRST NUMBER X1

CONSTANT 25.

X2                                                   #SECOND NUMBER X2

CONSTANT 0.01

POW                                                  #POWER USED IN POWER MEAN, p

CONSTANT –1.0

ONES                                                 #MATRIX OF ALL ONES

CONSTANT 1.0

W1

OPEN/CLOSE FIRST_WEIGHT.TXT 1.0 (FREE) –1

W2 FUNCTION                                          #CALCULATE SECOND WEIGHT AS

ONES – W1

PowerMean1 EXPRESSION                                #POWER MEAN

(W1*X1^POW + W2*X2^POW)^(ONES/POW)

PowerMean2 EXPRESSION                                #POWER MEAN (DOES NOT REQUIRE W2)

(W1*X1^POW + (ONES-W1)*X2^POW)^(ONES/POW)

KeywordEx EXPRESSION                                 # ExpressionEquation3

3.14 * SQRT( EXP(POW) + LOG(M1) – NEG(M2) + 10^POW )