Density Surface Modelling of Distance Sampling Data

Density surface modelling of line transect data. A Generalized Additive Model-based approach is used to calculate spatially-explicit estimates of animal abundance from distance sampling (also presence/absence and strip transect) data. Several utility functions are provided for model checking, plotting and variance estimation.


![Build Status](https://travis-ci.org/DistanceDevelopment/dsm.svg? branch=master)

dsm provides a Generalized Additive Model (GAM)-based approach to calculate spatially-explicit estimates of animal abundance from distance sampling (also presence/absence and strip transect) data. Several utility functions are provided for model checking, plotting and variance estimation.

Using dsm

A quick introduction to how to use the package can be found on the distance sampling website.

News

dsm news!

2.2.13

  • dsm.var.gam now has an example
  • dsm.var.prop now checks that the detection function model does not have covariates

2.2.12

  • The alpha argument now works for analytical variance reported using dsm.var.prop and dsm.var.gam print.summary and summary methods. Thanks to Jason Roberts and Eric Rexstad for spotting this issue.
  • dsm now uses numDeriv::grad to calculate derivatives for variance estimation -- this should be much faster. Thanks to Jason Roberts for this fix.
  • dsm now requires mrds version 2.1.15 or higher, due to internal changes
  • fixed issue where Effort column was required even when segment.area was specified. Thanks to Greg Lollback for spotting this issue.
  • ensured that ordering of segments matched the ordering of the observations so that aggregation of observations are correct. Thanks to Dave Fifield for reporting this bug and suggesting a fix.
  • check.cols no longer checks to see if there is a column called "distance" when strip transects are being used

2.2.11

  • dsm.var.prop uses update() rather than messing around with eval()
  • print.summary.dsm.var didn't work for GAM variance when no detection function was specified, now fixed (thanks to Natalia Dellabianca for spotting this)
  • Removed non-working plot() code in variance examples -- see the Mexico pantropical spotted dolphins for a proper treatment of plotting using projections (http://distancesampling.org/R/vignettes/mexico-analysis.html)
  • plot.var.gam no longer crashes by default when distance data doesn't have columns "x" and "y"

2.2.10

  • corrected offsets in examples in dsm, dsm.var.prop, dsm.var.movblk
  • updated mexdolphins data with lat/long reversal in prediction data and non-list storage
  • stopped use of rqgam.check from being used with non-negbin/Tweedie responses (thanks to Phil Bouchet for highlighting this issue).

2.2.9

  • Moving block bootstrap now works when there is no detection function (suggested by Laura Williamson)
  • Mexico dolphin data has had the areas of the prediction grids and segments re-projected. Thanks to Phil Bouchet for pointing out this error. Context: https://groups.google.com/d/msg/distance-sampling/oj1j8mSmnTc/3cOAAJgBw9MJ

2.2.8

  • Speed up and reduced memory usage in variance calculations, thanks to Filipe Dias for asking about this.
  • Better error when no observations are matched to the detection function. Thanks to Ricardo Lima for highlighting this.
  • Check for missing columns had incorrect logic, now corrected and with tests. Thanks to Julia Migné for spotting this.

2.2.7

  • Plotting check plots using random quantile residuals (rqgam.check) didn't work for Tweedie or tw family models, now fixed. Thanks to Laura Mannocci and Jason Roberts for pointing this out.
  • Plotting CV used matrix() to coerce data into a data.frame -- thus converting all elements to the simplest type. Errors ensued. Thanks to Adrian Schiavini for finding this bug!

2.2.6

  • dsm.var.prop and dsm.var.gam now allow you to supply a single number as an offset, then copy it as many times as you need. Thanks to Filipe Dias for suggesting this.

2.2.5

  • dsm.var.prop will now throw an error if there is no detection function in the dsm that it's trying to calculate the variance for (thanks to Adrián Schiavini for finding this)
  • variance/CV plotting threw an error when no detection function was supplied but observation=TRUE. Now error is sidestepped (again, thanks to Adrián Schiavini for finding this).

2.2.4

  • changed stop() to warning() when data not in the detection function are included in the observation data frame, as they are automatically excluded later, bug found by Eric Rexstad and Anna Cucknell

2.2.3

  • moving block boostrap was using observed abundances as the residuals and therefore gave wrong answers (Eric Rexstad found this bug)

2.2.2

  • version number reporting now works (Len Thomas found this bug)
  • more documentation
  • by default density and presence models are now weighted by area of each segment

2.2.1

  • switch over to new testthat spec
  • added new response variables (Dhat, density.est, count, n), suggestion from Len Thomas

2.1.4

  • check that all observed distances are within width will now throw an error

2.1.3

  • CRAN-compatibility fixes

2.1.2

  • updates to dsm.cor
  • more unified plotting
  • variance estimation tweaks for non-dsm models

2.0.6

  • removed warning about if() comparison length in make.soapgrid need to pass bnd as a list()
  • dsm.cor now handles gamm objects
  • dsm.cor allows one to check residual autocorrelation in your models
  • presence/absence data now no longer needs a dummy detection function object

2.0.5

  • started NEWS file
  • fixed bug where dsm.var.gam() didn't return predictions so plotting the result would fail
  • silly typo in docs
  • check if we're using mgcv version >= 1.7-24 for GAMM fitting and warn if not

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("dsm")

2.2.15 by Laura Marshall, 5 months ago


http://github.com/DistanceDevelopment/dsm


Report a bug at https://github.com/DistanceDevelopment/dsm/issues


Browse source code at https://github.com/cran/dsm


Authors: David L. Miller, Eric Rexstad, Louise Burt, Mark V. Bravington, Sharon Hedley.


Documentation:   PDF Manual  


Task views: Analysis of Ecological and Environmental Data


GPL (>= 2) license


Imports nlme, ggplot2, statmod

Depends on mgcv, mrds, numDeriv

Suggests Distance, tweedie


See at CRAN