ExportKMLTelemetry: ExportKMLTelemetry

Description Usage Arguments Value

Description

Create a Google Earth KML file (points and multitrack) from lat/long coordinates.

Usage

1
2
3
4
5
ExportKMLTelemetry(df, id, datetime, lat, long, alt, alt_mode, speed,
  agl, behavior, point_color, point_metadata, point_pal, point_r_pal,
  point_b_pal, extrude, path, path_color, path_metadata, path_pal,
  path_r_pal, path_b_pal, arrow, icon_by_sex, labelscale, dateformat,
  timeformat, datetimeformat, file, output_dir)

Arguments

df

input dataframe, must have id, lat, long, and datetime

id

column name of unique identifier, data is split into unique paths and separate folders based on this parameter

datetime

column name of datetime in POSIXct format or as a character in the format (%Y/%m/%d %H:%M)

lat

column name of latitude coordinates (WGS84, dec. degree)

long

column name of longitude coordinates (WGS84, dec. degree)

alt

input dataframe column name for altitude(m). Optional.

alt_mode

based on KML code: "absolute","clampedToGround", "relativeToGround" (see KML documentation for description). Default is "clampedToGround".

speed

input dataframe column name for speed. Optional

agl

input dataframe column name for "altitude above ground level", optional

behavior

input dataframe column name for behavior. Optional

point_color

column name that determines the color for each point, may be same as 'id' parameter, but may also be sex, behavior, season, etc. Default is 'id' parameter

point_metadata

location of metadata .csv file. Metadata file must have a column that matches name of 'point_color'parameter and "icon_color" column with hexadecimal colors.

point_pal

name of color palette funtions (e.g., rainbow, heat.colors, terrain.colors, topo.colors, cm.colors used to create colors. This parameter has priority over the other point color palette parameters. Default is NULL.

point_r_pal

Specifc number of 'R_pal' color palette from the 'PlotKML' Package (e.g., 1 = R_pal[[1]]). This parameter has priority over the 'b_pal' parameter for setting the colors. Default is NULL.

point_b_pal

color palette name from RColorBrewer package, default is "Set1". Automatically adjusts number of colors to match the unique number of factors in the 'point_color' column of the input dataframe.

extrude

logical, either FALSE (default) for no line, or TRUE which extends a line from the point to the ground.

path

logical, to create Track paths. Default is TRUE.

path_color

similar to 'point_color' parameter, but the value must have the same factor level structure as the id file, because each path is constructed for each id factor. Default will use 'id' parameter.

path_metadata

location of metadata .csv file. Metadata file must have a column that matches name of 'path_color' parameter and an "icon_color" column with hexadecimal colors.

path_pal

name of color palette funtions (e.g., rainbow, heat.colors, terrain.colors, topo.colors, cm.colors used to create colors. This parameter has priority over the other point color palette parameters. Default is NULL.

path_r_pal

Specifc number of 'R_pal' color palette from the 'PlotKML' Package (e.g., 1 = R_pal[[1]]). This parameter has priority over the 'b_pal' parameter for setting the colors. Default is NULL.

path_b_pal

color palette name from RColorBrewer package, default is "Set1". Automatically adjusts number of colors to match the unique number of factors in the 'point_color' column of the input dataframe.

arrow

logical, use arrow heads on path icons.

icon_by_sex

logical, use different icons based on "sex" column

labelscale

adjusts the size of the Google Earth location point labels. Default is 0, which hides the labels. To show labels, change to a value between 0.7-1.

dateformat

changes the format of the date in the Google Earth location pop-up windows. Default is "%Y/%m/%d".

timeformat

changes the format of the time in the Google Earth locations pop-up windows. Default is "%I:%M %p".

datetimeformat

changes the datetime format for the label of highlighted points. Default is "%Y/%m/%d %I:%M %p"

file

filename of output KML file, default is name of input dataframe

output_dir

name for folder in the KML file, default is working directory

Value

KML of points and multitracks


Blakemassey/gisr documentation built on Aug. 30, 2020, 12:14 a.m.