VTrack (version 1.21)

GenerateAnimationKMLFile_Track: Create Animation of Transmitter Track to View in Google Earth

Description

This function creates a Keyhole Markup Language (KML) animation of horizontal movements that can be displayed in Google Earth. The animation shows when a transmitter was within the detection field of a receiver and when it moved between receivers or stations. Users can adjust the time slider to visualise individual time periods for display.

Usage

GenerateAnimationKMLFile_Track(sInputFile, sid, sPointsFile, 
                            sOutputFile, sTrackColour,sLocation)

Arguments

sInputFile

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

sid

a string variable containing a single TRANSMITTERID

sPointsFile

a data frame containing the RECEIVERID, the coordinates and the detection RADIUS in meters. This should be in the format LOCATION, LATITUDE, LONGITUDE, RADIUS

sOutputFile

a string detailing the location and name of the output kml file to be created

sTrackColour

colour of the tracks in the output .kml

sLocation

the location at which we wish to visualise our tracks (i.e. RECEIVERID or STATIONNAME).

Details

the output is a .kml that can be viewed as an animation in Google Earth

See Also

ReadInputData, RunResidenceExtraction, GenerateAnimationKMLFile

Examples

# NOT RUN {
# }
# NOT RUN {
###GenerateAnimationKMLFile_Track example

# Note, users must download Google Earth in order to visualise the kml

# Load crocodile datset into VTrack archive
data(crocs)
Vcrocs <- ReadInputData(infile=crocs,
                        iHoursToAdd=10,
                        dateformat = NULL,
                        sVemcoFormat='1.0')

# Load Wenlock points file
data(PointsDirect_crocs)

# Set working directory (in this case a temporary directory)
setwd(tempdir())
# or alternatively to your Desktop on Mac OS
# setwd("~/Desktop")

(TransmitterList <- ExtractUniqueValues(Vcrocs,2)) # Extract the transmitter names
TransmitterList[1] # Let's create the track for this tag

# Run the function to generate the KML for a single transmitter
GenerateAnimationKMLFile_Track(Vcrocs, # VTrack archive file
                               TransmitterList[1], # Transmitter id
                               PointsDirect_crocs, # points file
                               "Track1.kml", # file name
                               "cc69deb3", # colour of the track
                               sLocation="RECEIVERID")

# This file can be found within the tempdir() directory on your computer. 
# Double-click on the .kml file to open in Google Earth
# }