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.
detfct.fit(ddfobj, optim.options, bounds, misc.options)fitted detection function model object with the following list structure
final parameter vector
final negative log likelihood value
number of function evaluations
see codes in optim
string about convergence
hessian evaluated at final parameter values
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)
detection function object
control options for optim
bounds for the parameters
miscellaneous options
Dave Miller; Jeff Laake