ctmm (version 0.2.8)

variogram.fit: Visually fit a movement model to a variogram

Description

This function plots a variogram object overlayed with a continuous-time movement model guesstimated from the variogram's shape. Sliders are given to adjust the parameter guesstimates and the result can be saved to a global variable. The intention of this function is to facilitate good starting guesses for ctmm.fit.

Usage

variogram.fit(variogram,range=TRUE,CTMM=NULL,name="variogram.fit.model",...)

Arguments

variogram

A variogram object from the output of variogram.

range

Whether or not processes with a finite home range are considered.

CTMM

Optional initial guesstimate of the model parameters, in ctmm object format. The slider range is triple this value.

name

Name of the global variable to store the guesstimate in.

...

Optional parameters passed to plot.variogram.

Details

When range=TRUE, sigma is the asymptote of the variogram and tau is an array of autocorrelation timescales. The position timescale is roughly the time lag it takes of the variogram to reach 63% of its asymptote. The velocity autocorrelation timescale visually corresponds to width of the concave bowl shape at the beginning of the variogram. When range=FALSE, sigma is the asymptotic slope of the variogram and only the velocity timescale is finite. By default, parameter values are estimated from the shape of the variogram. If this fails, the CTMM option can provide alternative initial guesstimates.

See Also

ctmm.fit, plot.variogram, variogram.

Examples

#Load package and data
library(ctmm)
data(buffalo)

#Extract movement data for a single animal
cilla <- buffalo[[1]]

#Calculate variogram
v1 <- variogram(cilla)

# generate a visual fit of the variogram (requires RStudio)
variogram.fit(v1)