Farm Process List Reading Utility Modules

The Farm Processes uses the U2DREL and U2DINT array reading utility modules. They are identified as [1] and [2] respectively. The others [3] - [7] are used only by the Farm process and are described here.

A control record item “a” is read from the FMP1 input file by all utility modules. A keyword signals whether to use a lumped constant value for 2D-arrays or data lists, or whether to read 2D-data arrays and data lists internally from the FMP1 input file or externally from a data file. For 2D-data arrays read by standard MF2K utility modules, a “Multiplier Constant” can be applied to scale any input data array.

For data lists read by FMP-embedded list reading utility modules, a second control record item “b” is optionally read if the use of scale factor multipliers is desired. If item b is included, the respective line must begin with “SFAC.” For internal data lists, this control record item b is read from the next line of the FMP1 input file. For external lists, item b is read from the first line of the external data file.

The read format for the list reading utility modules embedded in the FMP1, [3],[4],[5], [6], and [7] is by standard in free format and therefore not required to be specified. The farm-wells list reading utility module [3] prints the read variables including auxiliary variables to the listing file in integer and scientific notation unless “NOPRINT” is not specified for {option} in item 2. The other, less complex, list reading modules, [4], [5], [6], and [7] do not re-print the read input data to the listing file.

Control-Record Item a

Use one of these four options

The keyword “CONSTANT” indicates that the scalar, which follows the keyword, represents a lumped value for 2D arrays or for data lists with only one attribute. For data lists with multiple attributes, as many constants must be entered after the keyword “CONSTANT,” as fields are attributed to the multi-dimensional variable, while omitting the identifier attribute in the

first field.

Distributed data may be read as 2D arrays or as data lists internally in the FMP1 input file, as indicated by the keyword “INTERNAL.”

External data can be read by using a keyword of “OPEN/CLOSE” and thereafter specifying a filename directly in the FMP1 input file. The obvious advantage of using “OPEN/CLOSE” is that no further referencing of the file name in the Name File is necessary. However, each file will be closed after reading and no further use of that file for future stress periods is possible.

data can be read by using a keyword of “EXTERNAL” and specifying a file unit number, Nunit, in the FMP1 input file that cross-references to a file name contained in the name file and the key term “DATA.” The advantage of using “EXTERNAL” is that the file, from which a respective module reads, will not be closed and data for future stress periods can continuously be read from the same file.

Control-Record Item b

For [5] use one of these three options.

For [3], [4], and [6], use the first option.

SFAC Real ([3],[4]) or Double Precision ([5],[6]) Scalar(s)

SFAC OPEN/CLOSE FILENAME [5]

SFAC EXTERNAL Nunit [5]

Constant Scale Factor:

A scale factor can be applied to all lists read by the utility modules embedded in the FMP1, [3], [4], [5], and [6]. For each item, a constant real or double precision scalar may be multiplied by the parameter value(s) associated with the following respective attribute or range of attributes:

Item	SFAC applies to parameter(s)	Read by module
4	QMAXfact	3
7	OFE	5
9	CapFringe	6
11	ROOT	4
12	FTR,FEP,FEI	5
13	FIESWP, FIESWI	5
14	PSI(1), PSI(2), PSI(3), PSI(4)	5
19	GWcost1, GWcost2, GWcost3, GWcost4, SWcost1, SWcost2, SWcost3, SWcost4	5
22	QMAX	3
24	OFE	5
26	ROOT	4
27	CU	4
28	FTR, FEP, FEI	5
29	FIESWP, FIESWI	5
32	GWcost1, GWcost2, GWcost3, GWcost4, SWcost1, SWcost2, SWcost3, SWcost4	5
36	CALL	5

List of Scale Factors:

A list of scale factors can be applied to parameters of a data list that requires different multipliers for each parameter. This option is available only for lists read by utility module [5]. As before, item b must begin with the first keyword “SFAC.” A second control record keyword indicates whether the file containing the list of scale factors is specified directly by its file name, or by a file unit number, that cross-references to a file name contained in the Name File.

The first column in a list of scale factors contains the attribute or field number of a data list. The second column contains the individual scale factor for each respective attribute. For example, multiple scale factors for the three different attributes (1: WPF-Slope, 2: WPF-Int, 3: Crop-Price) in item 18 could be defined as follows:

Attribute	Scale factor
1	1.0
2	2.0
3	1.0
4	10.0

The first attribute always defines an ID, which is why the scale factor always must be 1.0. Parameters related to any other attribute that is not to be scaled, must also be equipped with a scale factor of one. In the example, the slope of the water-production function was multiplied by 2.0, and the crop market price per unit weight was multiplied by 10.

Help URL: http://www.yourdomain.com/help/?farm_process_list_reading_util.htm