surveyDashboard: Survey Dashboard for Camera Trap Data Analysis

In camtrapR: Camera Trap Data Management and Analysis Framework

Survey Dashboard for Camera Trap Data Analysis

Description

A comprehensive Shiny dashboard for analyzing camera trap survey data. The dashboard provides interactive visualization, data exploration, and analysis tools including:

• Data import from CSV files, Wildlife Insights exports, or camtrapDP format

• Interactive maps for camera locations and species detections

• Species activity pattern analysis

• Covariate extraction and analysis tools

• Single-species and community occupancy modeling

• Spatial prediction capabilities

Usage

surveyDashboard(
  CTtable = NULL,
  recordTable = NULL,
  stationCol = NULL,
  cameraCol = NULL,
  xcol = NULL,
  ycol = NULL,
  crs = NULL,
  setupCol = NULL,
  retrievalCol = NULL,
  hasProblems = FALSE,
  CTdateFormat = "ymd",
  camerasIndependent = NULL,
  speciesCol = "Species",
  recordDateTimeCol = "DateTimeOriginal",
  recordDateTimeFormat = "ymd HMS",
  timeZone = "UTC",
  exclude = NULL
)

Arguments

CTtable	A data.frame containing the camera trap deployment information.
recordTable	A data.frame containing the camera trap records.
stationCol	The column name containing the camera trap station ID
cameraCol	The column name containing the camera trap IDs (optional, only if 2 or more cameras per station)
xcol	The column name containing the X coordinate of the camera trap station.
ycol	The column name containing the Y coordinate of the camera trap station.
crs	The coordinate reference system (CRS) of the camera trap data. Must be a valid argument to st_crs
setupCol	The column name containing the camera trap deployment date (and time).
retrievalCol	The column name containing the camera trap retrieval date (optionally date-time).
hasProblems	A logical indicating whether there are periods of cameras malfunctioning
CTdateFormat	The date format of the camera trap deployment and retrieval date and time (default: "ymd").
camerasIndependent	logical. If multiple camera per station, are they independent?
speciesCol	The column name containing the species names
recordDateTimeCol	The column name containing the record date and time
recordDateTimeFormat	The date/time format of recordDateTimeCol
timeZone	Time zone of records in recordTable
exclude	Species to be excluded from the data set

Details

The dashboard includes several major components:

Data Import & Management:

• CSV file import with column mapping

• Wildlife Insights data import (zip, CSV, or directory)

• camtrap DP data import

• Study area import from shapefile

• Save/restore functionality for app state

• Export functionality to save data from dashboard

Data Processing:

• Flexible station filtering with multiple criteria

• Temporal record filtering with independence criteria

• Filtering species records by species name

• Automated covariate extraction from local rasters or online elevation data

• Covariate correlation analysis with visualization

• Species accumulation curves

Basic Analysis:

• Basic summary statistics

• Interactive overview and species detection maps

• Activity pattern analysis (single species and two-species overlap)

• Camera operation visualization

Occupancy Modeling:

• Basic workflow for simple model specification (linear effects)

• Support for both unmarked and ubms packages

• Automated detection history creation

• Model comparison and selection

• Response curves and spatial predictions

Community Occupancy Modeling:

• Flexible species selection with filtering

• Support for fixed, random, and independent effects

• Species-site random effects

• Effort handling on detection

• MCMC diagnostics and convergence assessment

• Species occupancy, richness and PAO predictions

Value

A Shiny dashboard application for camera trap survey data analysis

Note

• Interactive maps with multiple basemap options

• Covariate scaling is performed automatically if requested (includes automatic scaling of prediction rasters)

• The app state can be saved and restored

Current limitations include:

- supports only single-season data - no support for spatial capture-recapture models (or anything related to individual IDs)

Author(s)

Juergen Niedballa

Examples

## Not run: 

# Start the dashboard without parameters
# This opens the application with a welcome screen where data can be imported
surveyDashboard()

# Basic usage with minimal parameters

data("camtraps")
data("recordTableSample")

  surveyDashboard(
    CTtable = camtraps,
    recordTable = recordTableSample,
    xcol = "utm_x",
    ycol = "utm_y",
    crs = "epsg:32650",      # = UTM50N
    stationCol = "Station",
    setupCol = "Setup_date",
    retrievalCol = "Retrieval_date",
    CTdateFormat = "dmy"
  )
  
## End(Not run)
  
  

camtrapR documentation built on Nov. 5, 2025, 6:54 p.m.