getDuplicatedTimestamps: Identifies duplicated timestamps

In move: Visualizing and Analyzing Animal Track Data

Identifies duplicated timestamps

Description

Identifies all pairs of duplicated timestamps within an individual and sensor type from data downloaded from Movebank or own data.

Usage

  ## S4 method for signature 'character'
getDuplicatedTimestamps(x, ..., onlyVisible = TRUE)
 
  ## S4 method for signature 'factor'
getDuplicatedTimestamps(x, timestamps, sensorType, visible=NULL, ...)

Arguments

x	full path to the csv (or compressed) file location downloaded from a Movebank study, or to the zip file location downloaded from the EnvData tool in Movebank. data.frame read into R from a csv file downloaded from Movebank, or downloaded with getMovebankLocationData. factor containing the name(s) of the individual(s) if non-Movebank data are provided.
timestamps	vector containing timestamps with POSIXct conversion if non-Movebank data are provided,i.e. as.POSIXct(data$timestamp, format="%Y-%m-%d %H:%M:%S", tz="UTC")
sensorType	optional, character or vector of characters containing sensor type(s) if non-Movebank data are provided.
onlyVisible	logical, indicating if the visible column in the movebank data should be considered when the column visible is present, the default is to ignore all non-visible/outlier locations
visible	optional, a logical vector indicating the locations that should be considered.
...	currently not implemented

Details

If own data (non-Movebank) are used, the vectors specified in "x", "timestamps" and optionally "visible" have to have the same length.

Value

This function returns a list. The name of the list elements contains the individual's name, the timestamp that is duplicated and the sensor type (if provided). Each list element contains a vector with the corresponding row numbers where the duplicated timestamps are located in the table. If no duplicated timestamps are found NULL is returned.

Author(s)

Anne Scharf

Examples

data(duplicatedDataExample)
getDuplicatedTimestamps(x=as.factor(duplicatedDataExample$individual.id), 
                        timestamps=as.POSIXct(duplicatedDataExample$timestamps, 
					      format="%Y-%m-%d %H:%M:%S", tz="UTC"),
                        sensorType=duplicatedDataExample$sensor.type)

filePath<-system.file("extdata","leroy.csv.gz",package="move")
getDuplicatedTimestamps(filePath)

move documentation built on Sept. 29, 2024, 9:06 a.m.