trip2kml: Write a file which plots a trip in Google Earth

In slisovski/GeoLight: Analysis of Light Based Geolocator Data

Write a file which plots a trip in Google Earth

Description

This function creates a .kml file from light intensity measurements over time that can ve viewed as a trip in Google Earth.

Usage

trip2kml(
  file,
  tFirst,
  tSecond,
  type,
  degElevation,
  col.scheme = "heat.colors",
  point.alpha = 0.7,
  cex = 1,
  line.col = "goldenrod"
)

Arguments

file	A character expression giving the whole path and the name of the resulting output file including the .kml extension.
tFirst	date and time of sunrise/sunset (e.g. 2008-12-01 08:30)
tSecond	date and time of sunrise/sunset (e.g. 2008-12-01 17:30)
type	either 1 or 2, defining tFirst as sunrise or sunset respectively
degElevation	sun elevation angle in degrees (e.g. -6 for "civil twilight"). Either a single value, a vector with the same length as tFirst.
col.scheme	the color scheme used for the points. Possible color schemes are: rainbow, heat.colors, topo.colors, terrain.colors.
point.alpha	a numerical value indicating the transparency of the point colors on a scale from 0 (transparent) to 1 (opaque).
cex	numerical value for the size of the points.
line.col	An character expression (any of colors or hexadecimal notation), or numeric indicating the color of the line connecting the point locations.

Value

This function returns no data. It creates a .kml file in the in the defined path.

Author(s)

Simeon Lisovski and Michael U. Kemp

Examples

data(hoopoe2)
  hoopoe2$tFirst <- as.POSIXct(hoopoe2$tFirst, tz = "GMT")
  hoopoe2$tSecond <- as.POSIXct(hoopoe2$tSecond, tz = "GMT")
filter <- distanceFilter(hoopoe2,distance=30)
## takes time
## trip2kml("trip.kml", hoopoe2$tFirst[filter], hoopoe2$tSecond[filter], hoopoe2$type[filter],
##		degElevation=-6, col.scheme="heat.colors", cex=0.7,
##		line.col="goldenrod")

slisovski/GeoLight documentation built on June 5, 2024, 4:24 p.m.