matchscale: Match Kernel

Description

Finds scale parameter (move.a) of a movement model that corresponds to desired quantile, or expected distance moved.

Usage

matchscale(movementmodel, q = 40, expected = NULL, p = 0.5, lower = 1e-05, upper = 1e+05, 
   move.b = 1, truncate = Inf)

Value

Numeric value for move.a (scale parameter or zero-inflation in the case of `UNIzi') or truncation radius (`UNI').

Arguments

movementmodel: character (see Movement models and openCR-vignettes.pdf)
q: desired quantile (distance moved)
expected: numeric expected distance moved
p: cumulative probability
move.b: shape parameter of movement kernel
lower: lower bound interval to search
upper: upper bound interval to search
truncate: numeric q value at which distribution truncated

Details

The default behaviour is to find the movement parameter for the given combination of q and p.

The alternative, when a value is provided for `expected', is to find the movement parameter corresponding to the given expected distance.

The truncate argument must be specified for movementmodel `UNIzi`. For movementmodel `UNI' there is no parameter and the radius of truncation is varied to achieve the requested quantile q corresponding to cumulative probability p, or the desired expected distance.

Examples

Run this code


matchscale('BVN', 40, 0.5)
matchscale('BVT', 40, 0.5, move.b = 1)
matchscale('BVT', 40, 0.5, move.b = 5)
matchscale('BVT', move.b = 5, expected = 10)