split: Splitting a MoveStack, MoveBurst or DBBMMStack

splitR Documentation

Splitting a MoveStack, MoveBurst or DBBMMStack

Description

Splitting a MoveStack or MoveBurst into a list of Move objects. Splitting a DBBMMStack into a list of DBBMM objects.

Usage

  ## S4 method for signature 'MoveStack,missing'
split(x, f, drop=FALSE, ...)

Arguments

x

a moveStack, moveBurst or DBBMMStack object

f

not needed

drop

not needed

...

Currently not implemented

Details

A MoveStack is split into a list of Move objects by the trackId slot of the given MoveStack, obtaining one move object per unique trackId (usually corresponding to animal names). For staking this list of move objects use moveStack.

A MoveBurst object is split into a list of Move objects by the burstId slot of the given MoveBurst. One move object per burst (e.g. segment with given behavior) is obtained. Every location where the burst is switched will be recycled.

A DBBMMStack is split into a list of DBBMM objects by the trackId slot of the given DBBMMStack.

Value

'list'

Note

After splitting any object, the coordinates in the @coords slot in the resulting objects are named "coords.x1" and "coords.x2" (due to the usage of functions of other packages within this function).

Author(s)

Marco Smolla & Anne Scharf

Examples

## splitting a MoveStack
data(fishers)
split(fishers)

## splitting a DBBMMStack
data(dbbmmstack)
split(dbbmmstack)

## splitting a MoveBurst
data(leroy)
behav <- c(rep(c("a","b","c","a"),each=200), rep("b", 118))
leroyBurst <- burst(x=leroy, f=behav)
split(leroyBurst)

move documentation built on July 9, 2023, 6:09 p.m.