Home

Awesome

Build Status

Modules

This repository contains the modules for the Zoon species distribution modelling package.

A module is a self contained part of a SDM analysis. We conceptualise a SDM analysis as containing five parts.

Occurrence data

Collect occurrence data. This could be from a local file or an online database and might include presence only data, presence/absence data, abundance data etc.

Covariate data

Collect data on predictor variables for the model. While commonly environmental measurements, this could include habitat data, distributions of other species, anthropogenic variables or anything else.

Processes

The are maany things that need to be done to the data before actual modelling takes place. This might include taking background pseudoabsences, splitting the data for crossvalidation, runnings a PCA on environmental variables, data cleaning or a million other things.

Models

This is the area most other SDM packages focus on. Common examples include logistic regression and random forests. But also wrapping whole packages means there's a lot of models available.

Output

Good species distribution analyses should provide a variety of outputs. Typically we want to use our trained models to map where a species exists. We should also be checking how well our models work and the response shape and importance of each covariate. Perhaps we also want to upload our entire analysis to an online repository. Who knows.

Contributing modules

Modules are simple R scripts containing a single function and some metadata. The inputs and outputs of each module type are controlled. A brief description can be found here. The function BuildModule from the Zoon package is used to turn a function in an R session into a module.

Please note, Zoon is still being developed. We would love you to contribute modules, but can't yet guarantee that there won't be major changes that might break modules. We will try to fix user submitted modules if we break them.