detfct.fit: Fit detection function using key-adjustment functions
In mrds: Mark-Recapture Distance Sampling

detfct.fit

R Documentation

Fit detection function using key-adjustment functions

Description

Fit detection function to observed distances using the key-adjustment function approach. If adjustment functions are included it will alternate between fitting parameters of key and adjustment functions and then all parameters much like the approach in the CDS and MCDS Distance FORTRAN code. To do so it calls detfct.fit.opt which uses the R optim function which does not allow non-linear constraints so inclusion of adjustments does allow the detection function to be non-monotone.

Usage

detfct.fit(ddfobj, optim.options, bounds, misc.options)

Arguments

`ddfobj`	detection function object
`optim.options`	control options for optim
`bounds`	bounds for the parameters
`misc.options`	miscellaneous options

Value

fitted detection function model object with the following list structure

`par`	final parameter vector
`value`	final negative log likelihood value
`counts`	number of function evaluations
`convergence`	see codes in optim
`message`	string about convergence
`hessian`	hessian evaluated at final parameter values
`aux`	a list with 20 elements maxit: maximum number of iterations allowed for optimization lower: lower bound values for parameters upper: upper bound values for parameters setlower: TRUE if they are user set bounds setupper: TRUE if they are user set bounds point: TRUE if point counts and FALSE if line transect int.range: integration range values showit: integer value that determines information printed during iteration silent: option to silence errors from detfct.fit.opt integral.numeric if TRUE compute logistic integrals numerically breaks: breaks in distance for defined fixed bins for analysis maxiter: maximum iterations used refit: if TRUE, detection function will be fitted more than once if parameters are at a boundary or when convergence is not achieved nrefits: number of refittings mono: if TRUE monotonicity will be enforced mono.strict: if TRUE, then strict monotonicity is enforced; otherwise weak width: radius of point count or half-width of strip standardize: if TRUE, detection function is scaled so g(0)=1 ddfobj: distance detection function object; see `create.ddfobj` bounded: TRUE if parameters ended up a boundary (I think) model: list of formulas for detection function model (probably can remove this)