An internal function that operate within CMRnet::DatastreamPermSpat

cmrPermSpat(
  D,
  locmat,
  same.time,
  time.restrict,
  spat.restrict,
  same.id,
  n.swaps,
  n.rand,
  burnin,
  n.burnin,
  warn.thresh
)

Arguments

D

The input dataset to be randomised

locmat

A matrix indicating whether distance between the capture locations is less than spat.restrict if not "n"

same.time

(TRUE/FALSE) Whether swaps should be restricted to only occur trapping events on the same date or not

time.restrict

Provided as a number of months. Imposes time restrictions on when swaps can take place so that locations can only be swapped with those a fixed time before or after being captured

spat.restrict

Provided on the same scale as the coordinates in the input dataset. Imposes space restrictions on when swaps can take place so that locations can only be swapped with those captued within a fixed distance

same.id

(TRUE/FALSE) Whether swaps should be restricted to only be between captures of the same individual

n.swaps

The number of swaps between each random network being extracted (e.g. n.swaps = 10 would equate to 10 swaps taking place between each random network being saved)

n.rand

The number of randomised networks to be generated

burnin

(TRUE/FALSE) Whether burnin is required

n.burnin

The number of swaps to discard as burn-in before the first random network is created. The total number of swaps conducted is thus n.burnin+n.swaps*n.rand

warn.thresh

The number of times no matches are found (i.e. constraints on randomisations are too restrictive) before the function is stopped and an error message returned

Value

A randomised dataset with the same dimensions as the original input dataset