Section 1 Introduction

The SHEDS brook trout occupancy model predicts probability of occupancy for catchments smaller than 200 km^2 in the northeastern U.S. from Maine to Virginia.

The documentation is divided into the following sections:

  1. Introduction : provides an overview the model and its documentation, as well as a snapshot of the current calibration
  2. Theory : describes how the model works including the underlying structure and theory
  3. Data Sources : describes the datasets used as inputs to the model
  4. Data Processing : describes how input datasets are processed prior to model fitting (i.e. QAQC procedures)
  5. Calibration and Validation : describes how well the model predicts occupancy based on observations that were included (calibration) and excluded (validation) from the model fitting process
  6. Predictions : describes how predictions are generated after the model is calibrated and describes the various summary metrics that are computed for each catchment

The model will be periodically updated and re-calibrated (approximately once every 6 months) to incorporate any newly available data or updated stream temperature model results, and to make any necessary revisions to the data processing and/or model structure. With each update, a new version will be assigned to the model, and this documentation website will be updated to reflect the most recent performance of the model. A brief summary of the changes associated with each new version is provided in the Change Log below.

1.1 Model Overview

1.2 Current Snapshot

Table 1.1 provides a snapshot of the calibration and validation performance for the current version of the model (v0.9). More details about the model performance can be found in the Calibration and Validation section.

Table 1.1: Summary statistics of model calibration and validation
Calibration Validation
# Catchments 9,287 2,570
Sensitivity 0.679 0.617
Specificity 0.775 0.679
False Negative Rate 0.056 0.127
False Positive Rate 0.057 0.139
Accuracy 0.717 0.641
Error Rate 0.113 0.265
AUC 0.954 0.795

1.3 Model Versioning

The model uses semantic versioning of the form: vX.Y.Z

  • X is the major version, which will be incremented when there is a major change to the model theory, code, or datasets.
  • Y is the minor version, which will be incremented when there is a new set of results due to changes in the model code, datasets, processing procedures, etc.
  • Z is the patch version, which will be incremented only when there is a change to the documentation or code that does not yield different results.

1.4 Source Code

The source code for the model itself and this documentation is available in the Github repository walkerjeffd/sheds-bto-model. Each version of the model will be included under the list of Releases.

1.5 Change Log

  • v0.9.0 (Aug 16, 2018)
    Preliminary release of the new model framework and documentation.
  • Previous Versions (prior to 2018)
    Previous versions of the brook trout occupancy model can be found here. That website is now deprecated, but will remain available for future reference. Beginning with v1.0.0 of the new framework and codebase, all model changes and results will be tracked and made available.