trip2kml: Write a file which plots a trip in Google Earth
In GeoLight: Analysis of Light Based Geolocator Data

Description Usage Arguments Value Author(s) Examples

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

1
2
3

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

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

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

Simeon Lisovski and Michael U. Kemp

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")