contact (version 1.0.1)

findDistThresh: Identify Distance Threshold for Contact

Description

Sample from a multivariate normal distribution to create "in-contact" point pairs (n = n1) based on real-time-location systems accuracy, and generate distribution of length n2 describing average distances between point pairs. This function outputs upper confidence intervals associated with average distances between "in-contact" points.

Usage

findDistThresh(n1 = 1000, n2 = 1000, acc.Dist1 = 0.5,
  acc.Dist2 = NULL, pWithin1 = 90, pWithin2 = NULL, spTh = 0.666)

Arguments

n1

Numerical. Number of points used in the expected-distance distribution(s). Defaults to 1000.

n2

Numerical. Number of expected-distance distribution iterations to be averaaged. Defaults to 1000.

acc.Dist1

Numerical. Accuracy distance for point 1.

acc.Dist2

Numerical. Accuracy distance for point 2. If == NULL, defaults to acc.Dist1 value.

pWithin1

Numerical. Percentage of data points within acc.Dist of true locations for point 1.

pWithin2

Numerical. Percentage of data points within acc.Dist of true locations for point 2. If == NULL, defaults to pWithin1 value.

spTh

Numerical. Pre-determined distance representing biological threshold for contact.

Value

Output is a named vector with 22 observations describing the mean, max, and upper 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75, 80, 85, 90, 95, and 99-percent CI values calculated from the contact-distance distribution.

Details

This function is for adjusting contact-distance thresholds (spTh) to account for positional accuracty of real-time-location systems, assuming random (non-biased) error in location-fix positions relative to true locations. Essentially this function can be used to determine an adjusted spTh value that likely includes >= 99-percent of true contacts defined using the initial spTh.

References

Farthing, T.S., Dawson, D.E., Sanderson, M.W., and Lanzas, C. in Review. Accounting for space and uncertainty in real-time-location- system-derived contact networks. Ecology and Evolution.

Examples

# NOT RUN {
findDistThresh(n1 = 10, n2 = 10, acc.Dist1 = 0.5, acc.Dist2 = NULL, 
   pWithin1 = 90, pWithin2 = NULL, spTh = 0.5) 

findDistThresh(n1 = 10, n2 = 10, acc.Dist1 = 0.5, acc.Dist2 = NULL, 
   pWithin1 = 90, pWithin2 = NULL, spTh = 0)
# }