Generalized Dissimilarity Modeling is a statistical technique for modelling variation in biodiversity between pairs of geographical locations or through time. The gdm package provides functions to fit, evaluate, summarize, and plot Generalized Dissimilarity Models and to make predictions (across space and/or through time) and map biological patterns by transforming environmental predictor variables.

Details

The functions in the gdm package provide the tools necessary for fitting GDMs, including functions to prepare biodiversity and environmental data. Major functionality includes:

  • Formatting various types of biodiversity and environmental data to gdm's site-pair format used in model fitting

  • Fitting GDMs using geographic and environmental distances between sites

  • Plotting fitted functions & extracting I-spline values

  • Estimating predictor importance using matrix permutation and predictor contributions using deviance paritioning

  • Using cross-validation to evaluate models

  • Predicting pairwise dissimiliarites between sites or times and transforming environmental predictors to biological importance and mapping these patterns.

To see the preferable citation of the package, type citation("gdm").

I. Formatting input data

GDM fits biological distances to pairwise site geographical and environmental distances. Most users will need to first format their data to gdm's site-pair table format:

formatsitepairTo convert biodiversity and environmental data to site-pair format

II. Model fitting, evaluation, and summary

gdmTo fit a GDM
gdm.crossvalidationTo evaluate a GDM
gdm.partition.devianceTo asses predictor contributions to deviance explained
gdm.varImpTo asses model significance and predictor importance
summaryTo summarize a GDM

III. Model prediction and transformation of environmental data

predictTo predict biological dissimilarities between sites in space or between time periods
gdm.transformTo transform each environmental predictor to biological importance

IV. Plotting model output and fitted functions

plotTo plot model fit and I-splines
isplineExtractTo extract I-spline values to allow for custom plotting
plotUncertaintyTo estimate and plot model sensitivity using bootstrapping

Author

The gdm development team is Matt Fitzpatrick and Karel Mokany. The R package is based on code originally developed by Glenn Manion under the direction of Simon Ferrier. Where others have contributed to individual functions, credits are provided in function help pages.

The maintainer of the R version of gdm is Matt Fitzpatrick <mfitzpatrick@umces.edu>.