VTrack (version 1.21)

ExtractTagSummary: Function to Extract Summary Data for each Transmitter in the File

Description

This function extracts summary data for each transmitter in the file

Usage

ExtractTagSummary(sInputFile,sLocation)

Arguments

sInputFile

a data frame containing VTrack archive data, this archive is created using the ReadInputData function

sLocation

the location at which we wish to extract our tag summary data (i.e. RECEIVERID or STATIONNAME). The default is RECEIVERID

Value

TRANSMITTERID

a character vector containing the factory assigned transmitter tag id

FIRSTDETECT

a vector of class POSIXct of the time of the first location fix

LASTDETECT

a vector of class POSIXct of the time of the last location fix

NODETECTS

a numeric vector giving the number of transmitter location fixes

STARTLOC

a character vector containing the first location at which the transmitter was detected

ENDLOC

a character vector containing the last location at which the transmitter was detected

NOLOCS

a numeric vector giving the number of unique receivers or stations at which the transmitter was detected

Details

distances are given in meters

Examples

# NOT RUN {
# Load the crocodile data in the VTrack 1.0 archive format
#  adding 10 hours to convert from UTC 
data(crocs)
Vcrocs <- ReadInputData(infile=crocs,
                        iHoursToAdd=10,
                        dateformat = NULL,
                        sVemcoFormat='1.0')

# Extract summary table of transmitters in the file according to receiver serial numbers 
ExtractTagSummary(Vcrocs,sLocation="RECEIVERID")

# Extract summary table of transmitters in the file according to station names 
ExtractTagSummary(Vcrocs,sLocation="STATIONNAME")
# }