nlraa (version 0.98)

summary_simulate: Summarize a matrix of simulations by their mean (median), sd (mad), and quantiles

Description

Utility function to summarize the output from ‘simulate’ functions in this package

Usage

summary_simulate(
  object,
  probs = c(0.025, 0.975),
  robust = FALSE,
  data,
  by,
  ...
)

Arguments

object

nobs x nsim matrix where nobs are the number of observations in the dataset and nsim are the number of simulations

probs

the percentiles to be computed by the quantile function

robust

If FALSE (the default) the mean is used as the measure of central tendency and the standard deviation as the measure of variability. If TRUE, the median and the median absolute deviation (MAD) are applied instead.

data

the original data.frame used to fit the model. A data.frame will be returned instead of a matrix in this case.

by

opionally aggregate the results by some factor in the data.frame. It will be coarced to a formula. If robust is FALSE, the mean will be used. Otherwise, the median.

...

additional arguments to be passed. (none used at the moment)

Value

By default it returns a matrix unless the data argument is present and then it will return a data.frame

Examples

# NOT RUN {
data(barley, package = "nlraa")
fit <- nls(yield ~ SSlinp(NF, a, b, xs), data = barley)
sim <- simulate_nls(fit, nsim = 100)
sims <- summary_simulate(sim)

## If we want to combine the data.frame
simd <- summary_simulate(sim, data = barley)
## If we also want to aggregate by nitrogen rate
simda <- summary_simulate(sim, data = barley, by = "NF")

# }
# NOT RUN {
# }