Iteration Controls Pane

  • Scroll to top of this topic Scroll to Top of Page

  • Print the current topic Print Topic

  • No expanding elements on this page Show/Hide Expanders

The Iteration Controls pane is on the PEST Properties dialog box under Control Data.

The variables specified on the Iteration Controls pane are described in the PEST User Manual, Part I, Section 4.2.9. More extensive descriptions of these variables are in the PEST user manual.

NOPTMAX sets the maximum number of iterations that PEST is allowed to undertake on a particular parameter estimation run.

If NOPTMAX is set to 0, PEST will not estimate parameters, nor even calculate a Jacobian matrix. Instead it will terminate execution after just one model run. This setting can be used to ensure that PEST setup is correct; at the same time, it can be used to compute objective function components and residuals based on initial parameter values provided in the PEST control file.

If NOPTMAX is set to -2 PEST will calculate the Jacobian matrix, store it in a JCO file, and then cease execution immediately. This matrix can then be used for linear analysis, and/or for construction of an SVD-assist input dataset.

Setting NOPTMAX to –1 also instructs PEST to compute the Jacobian matrix. However after doing this, PEST records the same information on its output files as that which it would normally record on completion of an inversion process. This includes composite sensitivities and, if pertinent, post-calibration uncertainty and covariance statistics calculated from parameter sensitivities. It then undertakes a final model run so that model input and output files remaining after PEST execution is complete pertain to parameters values provided in the PEST control file.

PHIREDSTP and NPHISTP If, in the course of the parameter estimation process, there have been NPHISTP optimisation iterations for which

(ϕi - ϕmin )/ϕi ≤ PHIREDSTP

(ϕi being the objective function value at the end of the i’th optimisation iteration and ϕmin being the lowest objective function achieved to date), PEST will consider that the inversion process is at an end.

For many cases 0.005 and 4 are suitable values for PHIREDSTP and NPHISTP respectively.

NPHINORED If PEST has failed to lower the objective function over NPHINORED successive iterations, it will terminate execution. A value of 3 or 4 is often suitable.

RELPARSTP and NRELPAR If the magnitude of the maximum relative parameter change between iterations is less than RELPARSTP over NRELPAR successive iterations, PEST will cease execution. All adjustable parameters, whether they are relative-limited or factor-limited, are involved in the calculation of the maximum relative parameter change. RELPARSTP is a real variable for which a value of 0.005 is often suitable. NRELPAR is an integer variable; a value of 3 or 4 is normally satisfactory.

PHISTOPTHRESH If PHISTOPTHRESH is set to a positive number, PEST will cease execution if the objective function falls below this value at the end of any iteration. Note that this criterion is applied to the measurement objective function if PEST is run in “regularisation” mode (see chapter 9 of the PEST User Manual). Alternatively, if PHISTOPTHRESH is set to zero or a negative number, then it is ignored. ModelMuse aultimatlcally exports PHISTOPTHRESH as zero in “predictive analysis” or “pareto” modes.

LASTRUN If LASTRUN is set to activated, then PEST will undertake a final model run using optimised parameters upon termination of execution. ModelMuse automatically deactivates LASTRUN in “pareto” mode.

PHIABANDON If, at the end of the first model run, and any iteration thereafter, the objective function (or measurement objective function if PEST is run in “regularisation” mode) is greater than PHIABANDON, PEST will terminate execution. Set this to a very high number, or to a non-positive number (or omit it altogether), for it to have no effect.