plot_valuesVSit_2D: Create 2D plots of parameters values evolution per iteration...
In SticsRPacks/CroptimizR: A Package to Estimate Parameters of Crop Models

plot_valuesVSit_2D

R Documentation

Create 2D plots of parameters values evolution per iteration or evaluation number

Description

Create 2D plots of parameters values evolution per iteration or evaluation number

Usage

plot_valuesVSit_2D(
  df,
  param_info,
  iter_or_eval = c("eval", "iter"),
  fill = c("crit", "rep"),
  crit_log = TRUE,
  lines = FALSE,
  rep_label = c("begin_end", "begin", "end")
)

Arguments

`df`	Data.frame containing values of parameters (one column per estimated parameter), criterion (crit column), repetition number (rep), iteration number (iter) and evaluation number (eval) (similar to params_and_crit). See Details section for comments about the difference between evaluations and iterations.
`param_info`	Information on the parameters to estimate. Either a list containing: `ub` and `lb`, named vectors of upper and lower bounds (-Inf and Inf can be used if init_values is provided), `init_values`, a data.frame containing initial values to test for the parameters (optional, if not provided, or if less values than number of repetitions of the minimization are provided, the, or part of the, initial values will be randomly generated using LHS sampling within parameter bounds). or a named list containing for each parameter: `sit_list`, list the groups of situations for which the current estimated parameter must take different values (see here for an example), `ub` and `lb`, vectors of upper and lower bounds (one value per group), `init_values`, the list of initial values per group (data.frame, one column per group, optional).
`iter_or_eval`	"iter" for plotting the values for each iteration, "eval" for plotting the values for each evaluation
`fill`	If "crit", colours the points and lines in function of the minimized criterion value, if "rep" colours in function of the repetition number.
`crit_log`	If TRUE, consider criterion values in log scale
`lines`	If TRUE add lines between points of a same repetition
`rep_label`	Indicate if labels for the repetition number must be plotted at both beginning and end of lines ("begin_end"), only at the beginning ("begin") or only at the end ("end")

Details

Evaluation means evaluation of the criterion from proposed values of the parameters by the parameter estimation algorithm. An iteration is reached when an evaluation lead to a better value of the criterion than the previously obtained values. There are thus more evaluations than iterations. The criterion decreases when iteration number increases while it is not the case when evaluation number increases.