calcMantel {MigConnectivity}

Calculate Mantel correlation (rM) from points and/or distances.

Description

Calculation of rM from POINTS geolocators and/or GPS data, not accounting for uncertainty. If you've already calculated distances between points, you can use those instead.

Usage

calcMantel(
  targetPoints = NULL,
  originPoints = NULL,
  targetDist = NULL,
  originDist = NULL
)

Arguments

targetPoints

A sf POINTS object, with length number of animals tracked. Each point indicates the point estimate location in the non-release season.

originPoints

A sf POINTS object, with length number of animals tracked. Each point indicates the release location of an animal.

targetDist

Distances between the target locations of the tracked animals. Symmetric matrix with number of animals rows and columns, although really you only need the lower triangle filled in.

originDist

Distances between the origin locations of the tracked animals. Symmetric matrix with number of animals rows and columns, although really you only need the lower triangle filled in.

Value

calcMantel returns a list with elements:

pointCorr

Simple point estimate of Mantel correlation.

originDist, targetDist

Distances between each pair of originPoints and each pair of targetPoints, respectively, in meters. If you used distances as inputs instead, then these are just what you fed in.

References

Ambrosini, R., A. P. Moller, and N. Saino. 2009. A quantitative measure of migratory connectivity. Journal of Theoretical Biology 257:203-211. doi:10.1016/j.jtbi.2008.11.019

See Also

estMantel, calcMC, estMC

Examples

data(OVENdata) # Ovenbird
rM0 <- calcMantel(originPoints = OVENdata$originPoints, # Capture Locations
                  targetPoints = OVENdata$targetPoints) # Target locations
str(rM0)