MoveNetCreateHi: MoveNetCreate

In matthewsilk/CMRnet: Construct and Analyse Social and Movement Networks from Spatio-temporally Referenced Capture-Mark Recapture Data

MoveNetCreate

Description

Creates dynamic, directed movement networks from capture-mark-recapture datasets using information on the capture locations and times of individuals.

Usage

MoveNetCreateHi(
  data,
  intwindow,
  mindate,
  maxdate,
  netwindow,
  overlap,
  nextonly = FALSE,
  index = FALSE
)

Arguments

data	A 5 column dataframe with columns for the ID of the captured individual, the location of its capture (a name or number), the x coordinate of its capture location, the y coordinate of the capture location, and the date and time of capture
intwindow	The maximum period of time (in minutes) between two co-captures (i.e. if intwindow = 60 then two individuals captured 60 minutes apart could be considered co-captured but two individuals captured 61 days apart couldn't)
mindate	The start date (format = "YYYY-MM-DD hh:mm:ss") of the study (i.e. when you want to build networks from)
maxdate	The end date (format = "YYYY-MM-DD hh:mm:ss") of the study (i.e. when you want to build networks until). Please provide as the day after the last day of the study. Please provide as the day after the last day of the study.
netwindow	The period of time over which each network is built in days (i.e. netwindow=30 would correspond to monthly networks)
overlap	The amount of overlap between netwindows in days (i.e. overlap = 5 would result in a second network window starting 5 days before the end of the first). When overlap=0, there is no overlap between successive network windows
nextonly	(TRUE/FALSE). Determines whether a network edge is only created to the next capture of an individual or all captures within the intwindow. Defaults to FALSE
index	Defaults to FALSE. If FALSE edges are weighted by the number of movements. If TRUE then edges are weighted by the number of movements divided by the number of captures in a group

Details

Networks connect locations that individuals have moved between within a particular interaction window. The time period for each network, together with the temporal and spatial restrictions on the capture window used to infer a movement can be defined by the user

Value

A list of length 3 containing:

1. the edgelist for the network in each of the netwindows as an array

2. the adjacency matrix for the network in each of the netwindows as an array

3. a matrix indicating which individuals occurred in each netwindow

Examples

## Not run: 
# load example data
data(cmrData3)

# set parameters for network creation
mindate<-"2019-12-01 00:00:00"
maxdate<-"2020-07-01 00:00:00"
intwindow<-24*60
netwindow<-20
overlap<-2
spacewindow<-0

# create network
movenetdat<-MoveNetCreateHi(data=cmrData,
intwindow=intwindow,
mindate=mindate,
maxdate=maxdate,
netwindow=netwindow,
overlap=overlap,
nextonly=TRUE,
index=FALSE)

## End(Not run)

matthewsilk/CMRnet documentation built on Nov. 16, 2022, 10:47 p.m.