Describe Pelagic Data Systems (PDS) Tracks — describe_pds

Writes one row per trip with where its track starts and ends, read from the stored tracks.

Usage

describe_pds_tracks(log_threshold = logger::DEBUG, package = "coasts")

Arguments

log_threshold: The logging threshold to use. Default is logger::DEBUG.
package: Name of the package whose inst/conf.yml to read. Defaults to "coasts".

Value

None (invisible).

Details

Columns: Trip, Boat, start_end_distance (metres between the first and last point), outliers_proportion (percentage of points faster than 30 m/s), timetrace_dispersion (standard deviation of the time between points), start_lat, start_lng, end_lat and end_lng. The end point is where the boat landed, which is how generate_fleet_analysis() places a tracker when pds.fleet_location is landing.

The step is incremental: only trips absent from the previous descriptors file are read, so the first run reads every stored track and later runs read only new ones. A trip whose track is not stored yet is retried next run.

The parameters needed are:

pds:
  pds_trips:
    file_prefix:
    version:
  pds_tracks:
    file_prefix:
    descriptors:
      file_prefix: