VTrack (version 1.11)

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)

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

Details

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

See Also

ReadInputData, RunResidenceExtraction, GenerateAnimationKMLFile

Examples

## 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,
#                         fAATAMS=FALSE,
#                         fVemcoDualSensor=FALSE,
#                         dateformat = NULL,
#                         sVemcoFormat='1.0')
# 
# # Load Wenlock points file and generate circuitous distance matrix
# 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
# 
# # This file can be found within the tempdir() directory on your computer. 
# # Double-click on the .kml file to open in Google Earth
# ## End(Not run)