standrm_binomial: Binomial dose-response models with rstan

Description Usage Arguments Details Value Author(s) Examples

Description

Formula interface for fitting dose-response curves with rstan for Nx2 tables with successes and failures

Usage

1
2
standrm_binomial(formula, data, fct, curveid = NULL, random = NULL,
                 priors = standrc_priors(), ...)

Arguments

formula

A two-sided formula with a binomial response matrix (cbind(success, failure)) and dose covariate names

data

A dataframe containing the variables in the model

fct

A drc model function.

curveid

A two-sided formula with parameter names (b + c + d) on the left and a factor name on the right hand side, defining several clusters, modelled as fixed effects

random

A two-sided formula with parameter names (b + c + d) on the left and a factor name on the right hand side, defining several clusters, modelled as random effects

priors

A list with prior definitions, see standrc_priors

...

Additional arguments passed to function stan in ackage rstan

Details

The response is assumed to be Binomial distributed. The parameterization of the drc model functions is changed, modelling the slope and the asymmetry parameter on a logarithmic scale and allowing the lower and upper asymptotes to swap parameters. When not fixed, the asymptotes are modelled on the logit scale assuming normal priors, also adding random effects on the logit scale; samples from the posterior of the asymptotes and predictions are obtained on the probability scale. There might be a problem with three-parameter functions, fixing a specific asymptote by the fixed argument in a more complex model might be a better solution. Random effect parameters can be specified even when the fixed effects counterpart is fixed at a specific value, but might result in convergence problems as asymptote parameters are fixed on the probability scale.

Value

stan_dat

rstan compatible list containing the data

model

A character vector containing the stan model

stan

S4 output of rstan containing the samples from the posterior distributions

pars

Character vector with fixed effects parameter names

random

Character vector with random effects parameter names

Author(s)

Daniel Gerhard

Examples

1
2
3
4
5
6
7
8
9
## Not run: 
data(earthworms)
# fitting a 2 parameter log-logistic model
m <- standrm_binomial(formula=cbind(number, total-number) ~ dose, 
                      data=earthworms, 
                      fct=LL.4(fixed=c(NA, 1, 0, NA)))
plot(m, logx=TRUE)

## End(Not run)

daniel-gerhard/standrc documentation built on May 14, 2019, 3:39 p.m.