hotspot.numbers: Hotspot numbers

In AMBarbosa/DeadCanMove: Assess How Spatial Roadkill Patterns Change with Temporal Sampling Scheme

Description

This function calculates the total numbers of events and the hotspot thresholds for each group and sampling interval.

Usage

hotspot.numbers(hotspots.list, sampl.intervals, groups, 
include.all.together = TRUE, min.total.events = 0, 
min.hotspot.threshold = 2)

Arguments

hotspots.list	results of the sequential.hotspots function
sampl.intervals	integer vector of the sampling intervals to analyse (at the moment, these intervals must be consecutive and start with one)
groups	taxa or groups to analyse separately (e.g. as.character(unique(dataset$group)))
include.all.together	logical, whether to run the analysis also for all groups combined
min.total.events	minimum total number of events to calculate hotspots for a group
min.hotspot.threshold	minimum number of events for a region to be considered a hotspot

Value

A list of the following matrices:

N.events
HS.threshold
N.hotspots
events.in.HS

Note

This function currently works only for hotspots of submats created with 'sampl.interval', not 'window.size' and 'gap.size'. See submatrix, sequential.submatrix, and check that your names(hotspots.list[[1]]) are something like "group.intv1", not "group.w1.g2.s1".

Author(s)

A. Marcia Barbosa, J. Tiago Marques, Sara M. Santos

See Also

hotspots, sequential.hotspots

Examples

data(roadkills)

submats <- sequential.submatrix(dataset = roadkills,
sampl.columns = 4:ncol(roadkills), sampl.intervals = 1:3,
group.column = "taxon", include.all.together = TRUE, 
remove.zeros = TRUE, keep.nonsampl.columns = TRUE, 
n.subsampl.columns = 120)

hsl <- sequential.hotspots(dataset = roadkills, submats = submats,
region.column = "segment", first.subsampl.col = 4, confidence = 0.95)

hsn <- hotspot.numbers(hotspots.list = hsl, sampl.intervals = 1:3,
groups = as.character(unique(roadkills$taxon)), 
include.all.together = TRUE, min.hotspot.threshold = 2)

hsn

AMBarbosa/DeadCanMove documentation built on Nov. 3, 2021, 10:03 a.m.