species_site_aggregated_plot: Plot Species Activity Data for a Project

In vulpes-vulpes/batr: Tools for Using Bat Acoustic Monitoring Data in R

Plot Species Activity Data for a Project

Description

species_site_aggregated_plot creates a plot of nightly activity for each species in a dataset. Different sites within the dataset are aggregated. Monitor activity can be plotted by including a gaps dataset (generated by log_file_parserif desired.

Usage

species_site_aggregated_plot(
  dataset,
  project_name,
  monitoring_start,
  monitoring_end,
  gaps = NULL,
  title = "TRUE",
  save_directory = NULL,
  text_size = 8,
  date_label = "%b"
)

Arguments

dataset	Object: a species_night_site_projectname data frame generated by the GUANO_loader function.
project_name	Character, a brief and relevant reference phrase that will be used to name the text file. Ideally matching project name used in other functions.
monitoring_start	Character, the date the monitoring began (e.g. "2019-01-01")
monitoring_end	Character, the date the monitoring ceased (e.g. "2019-01-01")
gaps	Object: a gaps_projectname data frame generated by the log_file_parser function. Defaults to null.
title	Logical vector. Defaults TRUE, if FALSE title is omitted
text_size	Numeric: adjusts the size of text in the figure.
save.directory	Character: if provided a .png image of the plot will be saved in the folder specified. Defaults to NULL: no output saved.
date_breaks	Date value: adjusts the formatting of the month labels on the y-axis. See https://www.statmethods.net/input/dates.html for formatting.

Value

A plot as an object in the current environment, and a saved image if selected.

Note

Because all sites are aggregated, if gaps are plotted these will be applied to each facet of the plot. Overlapping plots are indicated by denser colour.

See Also

Other Basic Plots: monitoring_effort_plot(), monthly_activity_plot(), multi_species_daily_site_plot(), old_species_daily_site_plot(), species_daily_site_plot()

Examples

## Not run: 
species_site_aggregated_plot(species_night_site_projectname, "Project Name", "2019-01-01", "2019-12-31")

## End(Not run)

vulpes-vulpes/batr documentation built on Jan. 23, 2025, 3:23 p.m.