Learn R Programming

intRvals

Package intRvals calculates means and variances of arrival intervals (and arrival rates) corrected for missed arrival observations, and compares means and variances of groups of interval data.

Installation in R

library(devtools)
install_github("adokter/intRvals")

General

The central function of package intRvals is estinterval, which is used to estimate the mean arrival interval (and its standard deviation) from interval data with missed arrivals. This is achieved by fitting the theoretical probability density intervalpdf to the interval data

The package can be used to analyse general interval data where intervals are derived from distinct arrival observations. For example, the authors have used it to analyze dropping intervals of grazing geese for estimating their faecal output.

Intervals are defined as the time between observed arrival events (e.g. the time between one excreted droppings to the next) The package provides a way of taking into account missed observations (e.g. defecations), which lead to occasional observed intervals at integer multiples of the true arrival interval.

Typical workflow

  • Fit interval model m to an interval dataset d using estinterval, as in m=estinterval(d).
  • Visually inspect model fits using plot.intRvals, as in plot(m).
  • Use anova.intRvals to check whether the missed event probability was signficantly different from zero, as in anova(m)
  • Also use anova.intRvals to perform model selection between competing models m1,m2 for the same interval dataset d, as in anova(m1,m2)
  • Compare means and variances between different interval datasets d1,d2 using ttest and vartest

Other useful functionality

  • fold provides functionality to fold observed intervals back to their fundamental interval
  • fundamental tests which intervals are fundamental, i.e. intervals not containing a missed arrival observation
  • interval2rate converts interval estimates to rates
  • partition estimates and tests for the presence of within-subject variation
  • intervalsim simulates a set of observed intervals

The package comes with a example interval dataset goosedrop

References

  • Dokter, A.M., et al. 2017. Analysing time-ordered event data with missed observations, Ecology and Evolution, 2017, in press.
  • Bédard, J. & Gauthier, G. 1986. Assessment of faecal output in geese. Journal of Applied Ecology, 23, 77-90.
  • Owen, M. 1971. The Selection of Feeding Site by White-Fronted Geese in Winter. Journal of Applied Ecology 8: 905-917.

Copy Link

Version

Install

install.packages('intRvals')

Monthly Downloads

172

Version

1.0.1

License

GNU General Public License

Maintainer

Adriaan M. Dokter

Last Published

May 2nd, 2022

Functions in intRvals (1.0.1)

anova.intRvals

Compares model fits of intRvals objects
interval2rate

Conversion of interval estimates to rates
fundamental

Estimate which intervals are fundamental
goosedrop

Dataset with dropping intervals observed for foraging Brent Geese (Branta bernicla bernicla)
fold

Folds observed arrival intervals to a fundamental interval
estinterval

Estimate interval model accounting for missed arrival observations
intervalsim

Simulate a set of observed intervals
intRvals-package

Analysing time-ordered event data with missed observations
intervalpdf

Probability density function of an observed interval distribution
loglikinterval

log-likelihood of an observed interval distribution
print.anova.intRvals

print method for class anova.intRvals
summary.intRvals

summary method for class intRvals
print.summary.intRvals

print method for class summary.intRvals
ttest

Student's t-test to compare two means of objects of class intRvals
vartest

F Test to compare two variances of objects of class intRvals
plot.intRvals

Plot an interval histogram and fit of intRvals object
partition

Estimate within-group variation
print.intRvals

print method for class intRvals