Ecological Report
Elham Ebrahimi
ecological-report.RmdIntroduction
The Ecological Report is the main interpretive output of
camtrapReport. It assembles processed camera-trap data into
an article-style document that combines narrative text, tables, figures,
and maps. This tutorial explains how the report is organised, what each
section is designed to show, and how the main outputs can be
interpreted.
For a practical introduction to input data preparation and first use, see the Get started page.
How the Ecological Report is organised
The Ecological Report is structured as a standard scientific-style
document. It typically includes an introduction, methods, results,
acknowledgements, an appendix, and references. Within these sections,
camtrapReport inserts outputs generated by selected
analysis modules.
The exact contents of the report depend on the modules included in the workflow. Some sections provide study context and methodological information, whereas others present ecological summaries, figures, and maps.
Report-level sections
Introduction
The Introduction provides the ecological and monitoring context of the report. It briefly explains why the study was conducted, what taxa or groups are being monitored, and which ecological questions the report is intended to address.
Methods
The Methods section explains how the data were collected and processed. It describes the study area, camera deployment, sampling effort, image handling, and the main steps used to prepare the data for analysis.
Results
The Results section contains the main ecological outputs generated by the selected modules. Depending on the report settings, this section may include summaries of captures, temporal activity patterns, species richness, spatial density, habitat use, species co-occurrence, species accumulation, and abundance-related trends.
Acknowledgements
This section records package attribution, project support, and other acknowledgements linked to the report.
Methods modules
Study Area
The Study Area section introduces the site and provides the spatial context of the report. It usually includes the location of the study site, its approximate extent, and a short description of the monitoring area.
This section helps readers understand where the survey took place before moving to the analytical outputs.
Camera Locations
The Camera Locations section shows where the camera traps were deployed. In the current report format, this is presented as an interactive map with camera positions displayed by survey year and for the full monitoring period.
This output helps users: - inspect the spatial distribution of deployments, - compare yearly coverage, - review camera metadata linked to map points, - understand how habitat or spatial coverage may influence later results.
Sampling Effort
Sampling effort describes how much survey effort was invested across the monitoring period. In the report, this section summarises the number of active cameras, their deployment duration, and the total effort across years.
This section is important because many ecological outputs depend on effort. Differences in capture numbers or species detections should be interpreted in the context of how much sampling was conducted.
Image Processing
The Image Processing section explains how the images were classified, grouped, validated, and archived. It provides context for how raw media were transformed into analysis-ready observations.
This section helps users understand the data provenance behind the report outputs.
Data Processing
The Data Processing section explains how the input data were cleaned, harmonised, summarised, and prepared for ecological analysis. It links the original camera-trap data to the final report outputs.
This section is especially useful for documenting reproducibility and making the analytical workflow transparent.
Results modules
Captures
The Captures section provides an overview of the observed taxa and summarises key capture-based metrics. In the example report, this includes a table of frequently detected species with values such as number of captures, relative abundance index, number of capture locations, and total number of photos.
This section gives readers a first summary of which species dominate the dataset and how frequently they were recorded.
Activity Patterns
The Activity Patterns section describes how detections are distributed across the 24-hour day. The output is typically shown as a smoothed activity curve for each species, often with confidence intervals and sunrise/sunset reference lines.
These outputs help users interpret whether species are mainly diurnal, nocturnal, or crepuscular, and can also reveal differences among species in daily timing of activity.
Richness
The Richness section summarises how many species were detected across camera locations. In the current report style, richness is visualised on an interactive map in which point size and colour reflect the number of species recorded at each location.
This section helps identify biodiversity hotspots, uneven sampling outcomes, and variation in local species diversity across the study area.
Species Co-occurrence
The Species Co-occurrence section summarises pairwise associations among species recorded across camera locations. In the current report, this is shown as a correlation-style matrix.
These outputs help users explore whether species tend to be recorded together or apart across sites. They are useful for descriptive comparison, but should be interpreted cautiously because co-occurrence does not by itself imply ecological interaction.
Spatial Density
The Spatial Density section visualises the spatial concentration of detections across the study area. In the current report format, this is presented as an interactive density surface overlaid on the map.
This module helps users identify areas of relatively high and low detection intensity and compare spatial patterns among species or across survey years.
Habitat Preferences
The Habitat Preferences section compares capture-rate distributions across habitat types. In the current example, the output is shown as a stacked bar chart summarising the relative contribution of each habitat type for each species.
This section helps users assess broad differences in habitat association and provides an accessible summary of how detections are distributed across available habitat categories.
Species Accumulation Curves
Species accumulation curves show how recorded richness changes with increasing sampling effort. In the report, these curves are presented by survey year and in a comparison view.
These outputs help users assess whether the survey captured most of the detectable species pool or whether additional sampling would likely reveal more species.
Capture-Based and Abundance Trends
This section summarises temporal trends in species records across survey years. Depending on the selected output, it may include the number of captures, capture rate, number of locations, and REM-based density estimates.
These outputs are useful for comparing change over time, but they should always be interpreted with sampling effort and detection conditions in mind.
How to read the report
A useful way to read the Ecological Report is to move from context to interpretation:
- Read the Introduction and Methods to understand the study design.
- Review Camera Locations and Sampling Effort to assess survey coverage.
- Use Captures as the first summary of the observed species.
- Interpret Activity Patterns, Richness, Co-occurrence, Spatial Density, Habitat Preferences, and Accumulation Curves as complementary views of the same dataset.
- Read abundance-related trends in the context of both effort and species detectability.
In this way, the report functions not as a collection of separate figures, but as a connected set of outputs that support ecological interpretation.
Customising the report
The Ecological Report is modular. Users can include selected sections, omit others, and adapt the structure of the final report to match their monitoring objective.
This means that the report can be used both as a standard reporting format and as a flexible framework for customised ecological summaries.
Conclusion
The Ecological Report is designed to turn processed camera-trap data into a structured, interpretable, and reproducible document. Its article-style format combines context, methods, ecological outputs, and narrative explanation in a single report.
By understanding the purpose of each module and how the outputs relate to one another, users can read the report more effectively and adapt it more easily to different study goals.