plot_pp_swift: Plot processed Swift fixes from PinPoint Host software output

In adamdsmith/pinpoint: Scheduling fixes and reading and plotting data from Lotek PinPoint tags

Plot processed Swift fixes from PinPoint Host software output

Description

This function uses leaflet to generate a basic interactive map of PinPoint Swift fixes from the 'pp_df' class data produced by read_pp_swift. A separate overlay group is created for each distinct tag ID. Failed GPS fix attempts are removed automatically. Users can optionally filter GPS fixes by the reported dilution of precision 'max_hdop' or the number of satellites 'min_sats'. Limited experimentation finds fixes with at least 4 satellites and an HDOP <= 20 and to be of adequate locational quality, with an RMS of about 20 m (see details of test_pp_swift for more information). These are the defaults. For larger scale studies, fixes from 3 satellites may also be useful.

Usage

plot_pp_swift(pp_df, min_sats = 4, max_hdop = 20)

Arguments

pp_df	a 'pp_df' object (i.e., a 'data.frame' created by read_pp_swift)
min_sats	numeric/integer scalar indicating the minimum number of satellites required (default is 4) to accept a GPS fix as valid.
max_hdop	numeric scalar indicating the maximum dilution of precision (default is <= 20) to accept a GPS fix as valid.

Examples

## Not run: 
# Select appropriate text files from file selection window that opens
pp_tests <- list.files(path = system.file("extdata", package = "pinpoint"), full.names = TRUE)
dat <- read_pp_swift(pp_tests)
plot_pp_swift(dat)
plot_pp_swift(dat, min_sats = 8)

## End(Not run)

adamdsmith/pinpoint documentation built on Dec. 10, 2024, 11:42 p.m.