README.md

Description

SpatialDeltaGLMM Is an R package for implementing a spatial delta-generalized linear mixed model (delta-GLMM) for use when standardizing fishery-independent index data for U.S. West Coast surveys. Has built in diagnostic functions and model-comparison tools Is intended to improve analysis speed, replicability, peer-review, and interpretation of index standardization methods Will eventually be improved to incorporate informative help files accessible via standard R commands.

Background This tool is designed to estimate spatial variation in density using fishery-independent data, with the goal of estimating total abundance for a target species in one or more years. The model builds upon delta-generalized linear mixed modelling techniques (Thorson and Ward 2013,2014), which separately models the proportion of tows that catch at least one individual ("encounter probability") and catch rates for tows with at least one individual ("positive catch rates"). Submodels for encounter probability and positive catch rates always incorporate variation in density among years (as a fixed effect), and can incorporate variation among sampling vessels (as a random effect, Thorson and Ward 2014). Each submodel can also estimate spatial variation (variation that is constant among years), and spatiotemporal variation (variation over space which differs among years). Spatial and spatiotemporal variation are approximated as Gaussian Markov random fields (Thorson Skaug et al. 2015 ICESJMS), which imply that correlations in spatial variation decay as a function of distance. The tool incorporates geometric anisotropy, i.e., differences and rotation of the direction of correlation, where correlations may decline faster inshore-offshore than alongshore (Thorson Shelton et al. 2015 ICESJMS).

Development notes SpatialDeltaGLMM now has unit-testing to ensure that results are consistent across software updates Package VAST (link here) has been developed as a multispecies extension to SpatialDeltaGLMM, and unit testing confirms that it gives identical results when using data for a single species. I recommend that new users use VAST to ease the transition to multispecies or age/size-structured index models. * Other spatio-temporal tools are linked at www.FishStats.org

Build Status

Resources for using the tool

There are three main resources for learning about and using the tool:

  1. Please see the tutorial for example code.

  2. Please also read the Wiki. For West Coast users, I have a Guidelines for West Coast users wiki page, which is a living document and will evolve over time as best practices become apparent.

  3. Please use the R help files, e.g., model settings are documented in ?SpatialDeltaGLMM::Data_Fn after you have installed the package

Other resources include:

Database

Regions that have been previously tested (and have associated meta-data): alt text and see FishViz.org for visualization of results for regions with a public API for their data, using package FishData (link here).

Installation Instructions

This function depends on R version >=3.1.1 and a variety of other tools.

First, install the package devtools package from CRAN

# Install and load devtools package
install.packages("devtools")
library("devtools")

Second, please install the following: TMB (Template Model Builder): https://github.com/kaskr/adcomp INLA (integrated nested Laplace approximations): http://www.r-inla.org/download

Note: at the moment, packages TMB and INLA can be installed using the commands

# devtools command to get TMB from GitHub
install_github("kaskr/adcomp/TMB") 
# source script to get INLA from the web
source("http://www.math.ntnu.no/inla/givemeINLA.R")  

Next, please install package SpatialDeltaGLMM from this GitHub repository using a function in the devtools package:

# Install package
install_github("nwfsc-assess/geostatistical_delta-GLMM", ref="3.3.0") 
# Load package
library(SpatialDeltaGLMM)

Or you can always use the development version

# Install package
install_github("nwfsc-assess/geostatistical_delta-GLMM") 

Description of package

Please cite if using the software

Description of individual features

Range shift metrics

Effective area occupied metric

Spatio-temporal statistical methods

Accounting for fish shoals using robust observation models

Accounting for variation among vessels

Bias-correction of estimated indices of abundance

Funding and support for the tool



nwfsc-assess/geostatistical_delta-GLMM documentation built on May 24, 2019, 10:57 a.m.