homerange {riverdist}

Home Range

Description

Returns the minimum observed home range for multiple observations of each individual fish.

Usage

homerange(
  unique = NULL,
  survey = NULL,
  seg,
  vert,
  rivers,
  map = FALSE,
  algorithm = NULL,
  main = NULL,
  ...
)

Arguments

unique

A vector of unique identifiers for each fish. If the default (NULL) is used, the function will assume all observations come from a single individual.

survey

A vector of survey identifiers for each fish. This argument is not needed for home range calculation, but can affect plotting (see plot.homerange).

seg

A vector of river locations (segment component).

vert

A vector of river locations (vertex component).

rivers

The river network object to use.

map

Deprecated, use plot.homerange for plotting instead. Originally, whether to produce sanity-check maps of observed locations and calculated home range for each fish.

algorithm

Which route detection algorithm to use ("Dijkstra", "sequential", or "segroutes"). If left as NULL (the default), the function will automatically make a selection. See detectroute for more details.

main

Deprecated, use plot.homerange for plotting instead. Originally, plot title, if map is set to TRUE. If unspecified, the unique ID will be used for the title.

...

Deprecated, use plot.homerange for plotting instead. Originally, additional plotting arguments, if map is set to TRUE.

Value

An object of the homerange-class. The $ranges element is a data frame with two columns: $ID is a list of unique fish (as specified by unique=), and $range is calculated minimum home range, in the units of the coordinate system (this will likely be meters). The other elements are used for plotting, see homerange-class for more details.

Note

Building routes from the river mouth to each river network segment and/or distance lookup tables will greatly reduce computation time (see buildsegroutes).

Author(s)

Matt Tyers

See Also

plot.homerange, homerangeoverlap, plothomerangeoverlap

Examples

data(Gulk, fakefish)
ranges <- with(fakefish, homerange(unique=fish.id, survey=flight, seg=seg, vert=vert, rivers=Gulk))
ranges

# 19 plots will be produced, recommend calling par(mfrow=c(4,5))
plot(ranges)
plot(ranges,cumulative=TRUE,label=TRUE)

homerangeoverlap(ranges)

plothomerangeoverlap(ranges)
with(fakefish, riverpoints(seg=seg, vert=vert, rivers=Gulk))