README.md

In embiuw/LoggeR: Read and process whale and seabird sightings from Logger database

LoggeR

R package for reading and pre-processing whale and seabird sightings data collected using the IFAW Logger software. Logger stores data in a Microsoft Access database, and the LoggeR package contains functions for reading data directly from such a database. The package also contains function for initial pre-processing, such as correcting on- and off effort periods, and filtering out erroneous GPS data points, and then fill in missing GPS data in all tables. Finally, the package also contains a function for plotting sightings on an interactive map, using the R leaflet package. The user can zoom and pan in the map, and sightings (represented by dots) can be clicked to obtain a tooltip containing information about the sighting.

NOTE 1. The readLogger functions will only work on Windows, while all other functions should be platform-independent.

NOTE 2. For the package to recognise the Access databases, they will have to be set up as 32-bit ODBC data sources. See here for instructions.

NOTE 3. R (RStudio) must to run in 32-bit mode, otherwise the Access functions will not run. To check/change this in Rstudio, go to 'Tools -> Global Options... and check current mode at the top, under 'R version'.

NOTE 4. In order to display the map background tiles, the computer must be online. Offline use requires map tiles to have been previously downloaded (using e.g. the RGoogleMaps package, see example here).

Installation

On PC's running Windows, ensure you have installed Rtools. Install devtools and its dependencies, and finally install the LoggeR package:

install('devtools')
devtools::install_github("embiuw/LoggeR", build_vignettes = TRUE)

embiuw/LoggeR documentation built on May 21, 2020, 4:34 p.m.