vemsort: Prepare VEMCO transmitter CSV files for analysis
In mhpob/TelemetryR: Handle VEMCO detection data.

Description Usage Arguments Details Value See Also Examples

vemsort finds and combines all VEMCO CSV files in a directory

1	vemsort(directory = getwd(), clust = NULL, prog_bar = F, creation_date = NULL)

`directory`	String. Location of CSV data, defaults to current wd.
`clust`	A cluster object created by `makeCluster`. If cluster is supplied, this will use `parLapply` to import the files. Defaults to NULL with no parallel evaluation.
`prog_bar`	Logical. Do you want a progress bar displayed? Will increase evaluation time. Initiates `pblapply`.
`creation_date`	Character date in a standard unambiguous format (e.g., YYYY-MM-DD). Will select only files created after this date.

This function assumes that all necessary CSV files are within the specified directory or subdirectories within. All files must have the default headings offloaded by VEMCO products. These are, in order: Date and Time (UTC), Receiver, Transmitter, Transmitter Name, Transmitter Serial, Sensor Value, Sensor Unit, Station Name, Latitude, Longitude.

Output is a data frame containing all detections from the directory's CSV files. Adds two columns: one containing local time of the detections (as defined by Sys.timzone) and one containing the detection's CSV file of origin.

makeCluster, parLapply, pblapply

vemsort('C:/Users/mypcname/Documents/Vemco/Vue/ReceiverLogs')

# Select files created after Jan 1, 2015
vemsort('C:/Users/mypcname/Documents/Vemco/Vue/ReceiverLogs',
         creation_date = '2015-01-01')

# Use parallel computation and a progress bar
cl <- parallel::makeCluster(parallel::detectCores() - 1)
vemsort('C:/Users/mypcname/Documents/Vemco/Vue/ReceiverLogs',
         clust = cl, prog_bar = T)
parallel::stopCluster(cl)