Read all flight logs in a given folder and merge with data from a selecVideos() or selecAudios() data frame by time.

linkMetadataToFlight(
  ROOTfolderpath = NULL,
  flightlog_extension = ".srt",
  selected_videos = NULL,
  flightlog_datetime = NULL,
  timezone = NULL,
  melt = FALSE,
  ...
)

Arguments

ROOTfolderpath

full path to folder where all the flight logs to be processed are at (without a final slash). E.g. '/Users/you/Desktop'

flightlog_extension

string. Choose between .srt or .csv file entension.

selected_videos

data.frame from the selectVideos() function.

flightlog_datetime

string with column name of selected_videos containing the date and time.

timezone

string. Add the correct timezone where the drone videos were taken, as per the R base notation (for additional information, see help(timezomes)). Should this argument be left empty, the time zone will be assumed to be the same as the computer system.

melt

logical. If TRUE, returns one data.frame with all flight logs.

...

If flightlog_extension = ".csv", arguments are passed down to read.csv().If flightlog_extension = ".SRT", arguments are passed down to read.table()

Value

A data frame or a list of data frames merging every event exported by the selectVideos() or selectAudios() functions to flight logs.

Author

Alexandre Machado

Examples

if (FALSE) linkMetadataToFlight(ROOTfolderpath = "/Volumes/HDD/flightlogs", selected_videos = df_selected_videos, flightlog_extension = '.csv', flightlog_datetime = "CUSTOM.updateTime", timezone = "America/Sao_Paulo", melt = TRUE)