Data Set 0

[#Text]
Item 0 is optional and can include as many lines as desired. Each line needs to begin with
the “#” character in the first column.
Text—is a character string (maximum of 79 characters) that starts in column 2. Any characters can be included in Text. The “#” character needs to be in column 1. Text is printed when the file is read and provides an opportunity for the user to include information about the model both in the input file and the associated output file.


Data Set 1

MAXITER MAXCHANGE TOL SOSC (free format)
Item 1 includes variables that are most often changed by the user.
MAXITER—is the maximum number of parameterestimation iterations. If MAXITER = 0, the program calculates the variancecovariance matrix on parameters and related statistics (the parameter correlation coefficients generally are of most interest) using the starting parameter values from the Sensitivity Process input file, and parameter estimation stops after one iteration.

MAXCHANGE—is the maximum fractional change for parameter values in one iteration (Hill, 1998, eq. 5, p. 9). MAXCHANGE commonly equals 2.0, or less if parameter values are unstable during parameterestimation iterations.

TOL—is the parameterestimation closure criteria, as a fractional change in parameter values (Hill, 1998, eq. 7, p.12). TOL commonly equals 0.01. Larger values often are used during preliminary calibration efforts; values as small as 0.001 may be used for theoretical work.

SOSC—is the second convergence criterion discussed in Hill (1998, p. 12). If SOSC ≠ 0.0, parameter estimation will converge if the leastsquares objective function does not decrease by more than SOSC*100 percent over two parameterestimation iterations. SOSC usually equals 0.0. Typical nonzero values of SOSC are 0.01 and 0.05.



Data Set 2

IBEFLG IYCFLG IOSTAR NOPT NFIT SOSR RMAR RMARM IAP (free format)
Item 2 includes variables that control the modified GaussNewton calculations and are sometimes changed by the user.
IBEFLG—is a flag that controls the generation of files to be used as input to the postprocessing program BEALE2000, which tests model linearity.
•IBEFLG = 0, no file for BEALE2000 is produced.
•IBEFLG = 1, the _b1 file of tables 5 and 12 is produced.
•IBEFLG = 2, the _b2 file of tables 5 and 13 is produced. Production of this file may require MODFLOW2000 input files that differ from the files used for model calibration, as discussed in chapter 7. 
•IYCFLG—is a flag that controls the generation of files to be used as input to the postprocessing program YCINT2000, which calculates confidence and prediction intervals on simulated equivalents to observations.
•IYCFLG = 0, The _y0 file of tables 5 and 9 is produced. Production of this file may require MODFLOW2000 input files that differ from the files used for model calibration.
•IYCFLG = 1, The _y1 file of tables 5 and 10 is produced. Production of this file may require MODFLOW2000 input files that differ from the files used for model calibration, as discussed in chapter 7. Sensitivities for the predicted quantities are calculated, but the calculations related to nonlinear regression and the variancecovariance matrix on parameters are not made.
•IYCFLG = 2, The _y2 file of tables 5 and 11 is produced. This file is needed if confidence and prediction intervals on differences (eq. 7) are to be calculated. Production of this file may require MODFLOW2000 input files that differ from the files used for model calibration, as discussed in chapter 7. Sensitivities for the predicted quantities are calculated, but the calculations related to nonlinear regression and the variancecovariance matrix on parameters are not made. 
IOSTAR—is a flag that controls printing to the screen. If IOSTAR equals one, printing to the screen is suppressed. Usually IOSTAR=0.

NOPT—is a flag identifying whether or not to include matrix R of equation (B1) in equation (4a), as described in Hill (1998, p. 8, 78). Regression may converge in fewer iterations with NOPT = 1 for problems with large residuals and a large degree of nonlinearity.

NFIT—is the number of GaussNewton iterations (when NOPT equals 1) after which matrix R of equation (B1) is included in equation (4a) of Hill (1998, p. 8, 79).

SOSR—is a criterion for using R of equation (B1) in equation (4a) of Hill (1998, p. 8,78). Matrix R is used if the percentage change in the sum of squared, weighted residuals does not exceed SOSR*100 in two parameterestimation iterations. Usually SOSR equals 0.0.

RMAR—is used along with RMARM to calculate the Marquardt parameter, if its use is indicated based on CSA of item 4. The calculation of the Marquardt parameter described by Hill (1998, p. 9) is expressed as mrnew= RMARM*mrold+ RMAR. Typically, RMAR = 0.001.

RMARM—is used along with RMAR to calculate the Marquardt parameter, if its use is indicated based on CSA of item 4. The calculation of the Marquardt parameter described by Hill (1998, p. 9) is expressed as mrnew= RMARM*mrold+ RMAR. Typically, RMARM = 1.5.

IAP—is a flag identifying whether, for logtransformed parameters, MAXCHANGE applies to the native parameter value or to the log transform of the parameter value. Generally, IAP = 0.
•IAP = 0, MAXCHANGE applies to the native parameter value.
•IAP = 1, MAXCHANGE applies to the log transform of the parameter value. 


Data Set 3

IPRCOV IPRINT LPRINT (free format)
Item 3 includes variables that control printing.
IPRCOV—is a format code for printing of variancecovariance and correlation matrices. Permissible values of IPRCOV and corresponding formats are:
IPRCOV

FORMAT

1

11G10.3

2

10G11.4

3

9G12.5

4

8G13.6

5

8G14.7

6

6G10.3

7

5G11.4

8

5G12.5

9

4G13.6

10

4G14.7


IPRINT—is a flag that controls printing of various statistics computed for each parameterestimation iteration, including simulated equivalents, unweighted and weighted residuals, observation sensitivities, summary statistics for residuals by observation type, scaled leastsquares matrix of the GaussNewton method, and scaled gradient vector of the objective function.
•IPRINT = 0, the statistics are printed at the first and last parameterestimation iterations.
•IPRINT > 0, the statistics are printed at each iteration. Also, a summary of parameter values and statistics for all parameterestimation iterations is printed in theGLOBAL output file. 
LPRINT—is a flag that controls printing of eigenvalues and eigenvectors.
•LPRINT = 0, eigenvalues and eigenvectors are not printed.
•LPRINT > 0, if parameter estimation converges, eigenvalues and eigenvectors are printed. 


Data Set 4

CSA FCONV LASTX (free format)
Item 4 includes variables that control the modified GaussNewton calculations and are rarely changed by the user.
CSA—is the searchdirection adjustment parameter used in the Marquardt procedure. Usually equals 0.08.

FCONV—is a flag and a value used to allow coarser solver convergence criteria for early parameterestimation iterations. If FCONV equals zero, coarser convergence criteria are not used. Commonly, FCONV = 0.0; typical nonzero values would be 5.0 or 10.0, and these can produce much smaller execution times in some circumstances.

LASTX—is a flag that controls calculation of the sensitivities used to calculate the parameter variancecovariance matrix when parameter estimation converges.
•LASTX = 0, sensitivities from the last parameterestimation iteration are used to calculate the variancecovariance matrix. The program proceeds as in figure 1.
•LASTX > 0, sensitivities are recalculated using the final parameter estimates and are used to calculate the variancecovariance matrix. 


Data Set 5

NPNG IPR MPR (free format)
Item 5 includes variables that indicate whether additional items need to be read. The additional possible items are as follows.
NPNG—is the number of parameters of type HK, VK, VANI, VKCB, SS, SY, EVT, or ETS that can have negative values. This is useful for some interpolation methods in which, for example, deviations from a base value are calculated, where the deviations can be positive or negative. An example of such a method is described by Keidser and Rosbjerg (1991). If NPNG is greater than zero, item 6 is read.

IPR—is the number of parameters included in the full variancecovariance matrix used to weight the prior information.

MPR—is the number of priorinformation equations to be used in the regression.



Data Set 6

If NPNG is greater than zero, read item 6 once.
PARNEG(1), PARNEG(2), . . . , PARNEG(NPNG) (free format)
PARNEG—is an array of NPNG names of parameters of type HK, VK, VANI, VKCB, SS, SY, EVT, or ETS that can have negative values. This may be the case when the second kriging method discussed in Hill (1992, p. 125) is used.


Data Set 7

If IPR is greater than zero, read item IPR repetitions of item 7. Parameters that appear in item 7 may not appear in item 10.
NIPRNAM BPRI PLOTSYMBOL (free format)
NIPRNAM—is the name of one of the IPR parameters for which a variancecovariance matrix for prior parameter estimates is to be read.

BPRI—is the prior estimate for parameter NIPRNAM.

PLOTSYMBOL—is an integer that will be written to output files intended for graphical analysis to allow control of the symbols used when plotting data related to the prior information.



If IPR is greater than zero, read items 8 and 9 once. The size of item 9 depends on IPR

Data Set 8

IWTP (free format)
IWTP—is a flag identifying how the weight matrix for correlated prior information is to be calculated using the values in array WTP specified in item 9.
•IWTP = 0, WTP is a variancecovariance matrix. The diagonal terms of this matrix are the variances of the prior information, the offdiagonals are the covariances. Diagonal term WTP(I,I) is the variance for the parameter designated by NIPRNAM(I); offdiagonal term WTP(I,J) is the covariance for the parameters designated by NIPRNAM(I) and NIPRNAM(J). For parameters specified as being logtransformed in the Sensitivity Process input file, the corresponding WTP elements are interpreted as being relative to the logtransformed value (using log base 10). The weight matrix is calculated by taking the inverse of the array specified in item 9.
•IWTP = 1, WTP is a matrix of coefficients of variation (the standard deviation divided by the prior information value) and correlation coefficients. The diagonal terms are the coefficients of variation of the prior information; offdiagonals are the correlation coefficients and vary in value from –1.0 to +1.0. Diagonal term WTP(I,I) is the coefficients of variation for the parameter designated by NIPRNAM(I); offdiagonal term WTP(I,J) is the correlation coefficients for the parameters designated by NIPRNAM(I) and NIPRNAM(J). For parameters specified as being logtransformed in the Sensitivity Process input file, the corresponding WTP elements are interpreted as being relative to the logtransformed value (using log base 10). The weight matrix is calculated by in two steps. First, the coefficients of variation and correlation coefficients are used to calculate variances and covariances, and then the inverse of the variancecovariance matrix is calculated. In calculating variances, the coefficients of variation are multiplied by the prior information values specified in item 7, or the log10 of that value for logtransformed parameters; if the value equals zero, 1.0 is used instead. 

Data Set 9

WTP(1,1), WTP(1,2), ..., WTP(1,IPR) (free format)
WTP(2,1), WTP(2,2), ..., WTP(2,IPR) (new line; free format)
...
WTP(IPR,1), WTP(IPR,2), ..., WTP(IPR,IPR) (new line; free format)
WTP—is an IPR by IPR array containing statistics used to calculate the weight matrix for correlated prior information. The statistics specified depends on the value of IWTP. Note that the matrix is symmetric, but the entire matrix (upper and lower parts) must be entered.


Data Set 10

If MPR is greater than zero, read MPR repetitions of item 10. Examples are shown after the next section. Parameters that appear in item 7 may not appear in item 10.
EQNAM PRM "=" [SIGN] [COEF "*"] PNAM [SIGN [COEF "*"] PNAM [SIGN…]] "STAT" STATP STATFLAG PLOTSYMBOL (free format: maximum of 200 characters; one or more spaces must separate all words, numbers, and symbols)
EQNAM—is a usersupplied name (up to 10 nonblank characters) for a priorinformation equation.

PRM—is the prior estimate for priorinformation equation EQNAM. PRM always needs to be specified as a native, untransformed value. That is, even if the parameter is specified as being logtransformed in the Sensitivity Process input file, here PRM needs to be the untransformed value. The program will calculate the logtransformed value.

"=" indicates that an equal sign (without quotes) must be entered literally.

SIGN—is either "+" or "" (entered without quotes). The SIGN before the first PARNAM is assumed to be “+” unless otherwise indicated.

COEF—is the coefficient for the parameter following the "*" in priorinformation equation EQNAM. COEF can be specified with or without a decimal point and can be specified in scientific notation.

"*"—indicates that an asterisk (without quotes) must be entered literally if a value for COEF is entered.

PNAM—is a parameter name (up to 10 nonblank characters) as specified in the SEN file. If the parameter is designated in the Sensitivity Process input file as being logtransformed (LN greater than 0), the priorinformation equation may contain only one parameter name. If a priorinformation equation contains no logtransformed parameters, the equation may contain any number of terms, where each term is defined by the sequence: SIGN [COEF "*"] PNAM.

"STAT"—indicates that the word “STAT” (without quotes) must be entered literally, although it may be in any combination of upper and lowercase letters.

STATP—is the value from which the weight for priorinformation equation EQNAM is calculated, as determined using STATFLAG. If a parameter is specified as being logtransformed in the Sensitivity Process input file, STATP may be specified relative either to the native value or to the logtransformed value (using log base 10), depending on the value of STATFLAG.

STATFLAG—is a flag identifying how the weight for priorinformation equation EQNAM is to be calculated. This depends both on whether the user chooses to specify the variance, standard deviation, or coefficient of variation, and whether, for logtransformed parameters, the user chooses to specify the statistic related to the native, untransformed parameter, or to the transformed parameter.
•STATFLAG = 0, STATP is the variance associated with PRM, and is related to the native prior value. Weight = 1/STATP unless the parameter is defined as logtransformed in the Sensitivity Process input file, in which case equation 27 is used to convert STATP (which equals σ2b of equation 27) to σ2ln b, and weight = 1/σ2ln b.
•STATFLAG = 1, STATP is the standard deviation associated with PRM, and is related to the native prior value. Weight = 1/STATP2 unless the parameter value is defined as logtransformed in the Sensitivity Process input file, in which case equation 27 is used to convert STATP (which equals σb of equation 27) to σ2ln b, and weight = 1/σ2ln b.
•STATFLAG = 2, STATP is the coefficient of variation associated with PRM, and is related to the native prior value. Weight = 1/(STATP * PRM)2 unless the parameter is defined as logtransformed in the Sensitivity Process input file, in which case equation 27 is used to convert STATP (which equals σb/b of equation 27), to σ2ln b, and weight = 1/σ2ln b.
•STATFLAG = 10, STATP is the variance associated with the log (base 10) transform of PRM; weight = 1/[STATP * 2.30262].
•STATFLAG = 11, STATP is the standard deviation associated with the log (base 10) transform of PRM; weight = 1/[STATP2* 2.30262].
•STATFLAG = 12, STATP is the coefficient of variation associated with the log (base 10) transform of PRM; weight = 1/[(STATP * log 10 (PRM))2* 2.30262]. 
PLOTSYMBOL—is an integer that will be written to output files intended for graphical analysis to allow control of the symbols used when plotting data related to the prior information.


