tidyDiveDurations: Apply 'tidy' data principles to the dive-duration histogram...

In jmlondon/wcUtils: Utilities to Access the Wildlife Computers Data Portal API

Apply 'tidy' data principles to the dive-duration histogram data stream

Description

tidyDiveDurations returns a 'tidy'd' data frame of dive duration data

Usage

tidyDiveDurations(histos)

Arguments

histos

a list returned from read_histos

Details

The histogram data stream is provided in a 'wide' format (each row represents a time period and the observed values are provided in 1 to 72 'bin' columns). This format can be difficult to work with in R and other data analysis platforms (e.g. database tables), so we use the tidyr and dplyr packages to manipulate the data into a more flexible, 'narrow' format. This results in a data structure where every row represents a single observation.

This is implemented, here, with the dive duration data. For dive uration data, the tag records the duration in seconds of a qualifying dive and tallies those durationso user-sepcified duration bins and user-specified time bins. This, unlike with timeline data, requires some knowledge of these user-specified bins. As long as the user has uploaded a configuration/report file to the Wildlife Computers Data Portal, then the *-Histos.csv file provides information on the dive durations. If the bin information is not available, the function will produce a warning and output files with generic 'Bin' labels.

Value

a data frame with tidy, narrow data structure and actual dive duration bin limits (when provided)

jmlondon/wcUtils documentation built on March 19, 2024, 8:40 a.m.