GenerateAnimationKMLFile_Track: Create Animation of Transmitter Track to View in Google Earth
In VTrack: A Collection of Tools for the Analysis of Remote Acoustic Telemetry Data

Description Usage Arguments Details Author(s) See Also Examples

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.

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

`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`).

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

Ross Dwyer

ReadInputData, RunResidenceExtraction, GenerateAnimationKMLFile

## 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

## End(Not run)