species_daily_site_plot: Plot Activity for a Species at Each Site Within a Project

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

Plot Activity for a Species at Each Site Within a Project

Description

species_daily_site_plot creates a plot of nightly activity for a chosen species at all sites within a project.

Usage

species_daily_site_plot(
  data_path,
  species,
  monitoring_start = NULL,
  monitoring_end = NULL,
  gaps = FALSE,
  save_directory = NULL,
  y_scale = "free_y",
  width = 15.9,
  height = 8.43,
  text_size = 10,
  date_label = "%b",
  title = FALSE
)

Arguments

data_path	Character. Path to an existing RData file.
species	Character: the four letter species code for the species you wish to plot. E.g. "Epfu".
monitoring_start	Character, the date the monitoring began (e.g. "2019-01-01"), leave as NULL to use the earliest data point as the monitoring start.
monitoring_end	Character, the date the monitoring ceased (e.g. "2019-01-01"), leave as NULL to use the latest data point as the monitoring end
gaps	Boolean. Set true to add grey blocks to the plot to indicate periods in which the recorder was not active (requires log files to be loaded first using import_logs. Default is FALSE.)
y_scale	Character. Determines whether scales on the y-axis are matched or free. Defaults to "free_y" for unmatched axis, set to "fixed" for matched axis.
width	Number. The width in cm of the plot if saved to file. Default is 25 cm.
height	Number. The height of the plot if saved to file. Default is 20 cm.
text_size	Numeric: adjusts the size of text in the figure.
date_label	Date value: adjusts the formatting of the month labels on the y-axis. See https://www.statmethods.net/input/dates.html for formatting.
title	Logical vector. If FALSE (default) title is omitted.
save.directory	Character: if provided a .png image of the plot will be saved in the folder specified. Defaults to NULL: no output saved.

Value

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

See Also

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

Examples

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

## End(Not run)

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