GenerateAnimationKMLFile_Multitag: Create Animation of Multiple Transmitters to View in Google...

In RossDwyer/VTrack: A Collection of Tools for the Analysis of Passive Acoustic Telemetry Data

Create Animation of Multiple Transmitters to View in Google Earth

Description

This function creates a Keyhole Markup Language (KML) animation of transmitter detections at receivers that can be displayed in Google Earth. The animation shows the number of transmitters detected within the detection field of a receiver on a given day. Users can adjust the time slider to visualise individual time periods for display.

Usage

  GenerateAnimationKMLFile_Multitag(sInputFile,sPointsFile,sOutputFile,
  sLocation="RECEIVERID")

Arguments

sInputFile	a data frame containing VTrack archive data, this archive is created using the ReadInputData function
sPointsFile	a data frame containing the RECEIVERID or STATIONNAME, 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
sLocation	the location at which we wish to visualise our movement events (i.e. RECEIVERID or STATIONNAME).

Details

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

Author(s)

Ross Dwyer

See Also

ReadInputData, GenerateAnimationKMLFile_Track

Examples

  
  ## Not run: 
    ###GenerateAnimationKMLFile_Multitag example
    
    # Note, users must download Google Earth in order to visualise the kml.
    
    # Load crocodile datset into VTrack archive
    data(crocs)
    data(PointsDirect_crocs)
    
    Vcrocs <- ReadInputData(infile=crocs,
                            iHoursToAdd=10,
                            dateformat = NULL,
                            sVemcoFormat='1.0')
    
    # Set working directory (in this case a temporary directory)
    setwd(tempdir())
    # or alternatively to your Desktop on Mac OS
    # setwd("~/Desktop")
    
    # Run the function to generate the KML
    GenerateAnimationKMLFile_Multitag(Vcrocs,
                                      PointsDirect_crocs,
                                      "Croc Multi.kml",
                                      sLocation="RECEIVERID")
                                      
    # Note, due to the decommissioning of the plotKML package, this function is no longer operational
    # please use the GenerateAnimationKMLFile_Track function instead

## End(Not run)

RossDwyer/VTrack documentation built on Feb. 23, 2024, 10:40 p.m.