# Refine estimates iteratively.

### Description

This is a generic function with currently methods for `SLik`

and `SLikp`

objects (as produced by `MSL`

). Depending on the value of its `newsimuls`

argument, and on whether the function used to generate empirical distributions can be called by R, it (1) defines new parameters points and/or (2) infers their summary likelihood or tail probabilities for each parameter point independently, adds the inferred values results as input for refined inference of likelihood or P-value response surface, and provides new point estimates and confidence intervals.

### Usage

1 2 3 4 5 6 7 8 9 10 11 | ```
## S3 method for class 'SLik'
refine(object,...)
## Default S3 method:
refine(object, surfaceData, maxit = 1, n = NULL,
useEI = list(max=TRUE,profileCI=TRUE,rawCI=FALSE),
newsimuls = NULL, useCI = TRUE, level = 0.95,
verbose = list(most=interactive(),movie=FALSE),
precision = Infusion.getOption("precision"),
method,...)
``` |

### Arguments

`object` |
an |

`surfaceData` |
A data.frame with attributes, usually taken from the |

`maxit` |
Maximum number of iterative refinements (see also |

`n` |
A number of parameter points (excluding replicates and confidence interval points), which likelihood should be computed
(see |

`useEI` |
Cf this argument in |

`newsimuls` |
For the For other methods, a |

`useCI` |
whether to include parameter points near the inferred confidence interval points in the set of points which likelihood should be computed |

`level` |
Intended coverage of confidence intervals |

`verbose` |
A list as shown by the default, or simply a vector of booleans, indicating respectively
whether to display (1) some information about progress and results; (2) a plot of a the likelihood surface, if a one- or two-parameters surface is inferred. |

`precision` |
Requested local precision of surface estimation, in terms of prediction variance of both the maximum summary log-likelihood and the likelihood ratio at any CI bound available. Iterations will stop when either |

`method` |
(A vector of) suggested method(s) for estimation of smoothing parameters (see |

`...` |
further arguments passed to or from other methods. |

### Value

An updated `SLik`

or `SLik_j`

object.

### Examples

1 | ```
## see main documentation page for the package
``` |