unUsedRecords: Extracts or creates the unUsedRecords

unUsedRecords<-R Documentation

Extracts or creates the unUsedRecords

Description

This function returns the unUsedRecords part of the move object or assigns locations as unused, this could for example be used to remove test locations from a track. unUsedRecords can include events with no locations, locations flagged as outliers, non-location sensor data when includeExtraSensors is set to TRUE in the getMovebankData function.

Usage

 ## S4 method for signature '.unUsedRecords'
unUsedRecords(obj,...)
 ## S4 method for signature '.unUsedRecordsStack'
unUsedRecords(obj,...)
  
 ## S4 replacement method for signature '.MoveTrackSingle,logical'
unUsedRecords(obj) <- value
 ## S4 replacement method for signature '.MoveTrackStack,logical'
unUsedRecords(obj) <- value

Arguments

obj

a move, moveStack or moveBurst object

value

A logical vector of the same length as the number of locations

...

Currently not implemented

Value

an .unUsedRecords or .unUsedRecordsStack object

Author(s)

Marco Smolla & Anne Scharf

Examples

data(leroy)
data(fishers)

## get unused records from a move or moveStack object
str(unUsedRecords(leroy)) # from a move object
str(unUsedRecords(fishers)) # from a moveStack object

## assign locations of a move object as unused record
par(mfrow=2:1)
plot(leroy, type='b')
# e.g. assign every second location as unused
unUsedRecords(leroy)<-as.logical((1:n.locs(leroy))%%2) 
plot(leroy, type='b')

# e.g. assign first 20 locations as unused
data(leroy)
unUsedRecords(leroy)<- as.logical(c(rep("TRUE",20), rep("FALSE",n.locs(leroy)-20)))

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