graph_TRHbivariate: Graph a bivariate plot of temperature and humidity data

In ConSciR: Tools for Conservation Science

Graph a bivariate plot of temperature and humidity data

Description

Plots temperature vs relative humidity points coloured by a selected environmental metric calculated from temperature and humidity variables using ConSciR functions.

Usage

graph_TRHbivariate(
  mydata,
  Temp = "Temp",
  RH = "RH",
  z_func = "none",
  facet_by = "Sensor",
  LowT = 16,
  HighT = 25,
  LowRH = 40,
  HighRH = 60,
  Temp_range = c(0, 40),
  RH_range = c(0, 100),
  alpha = 0.5,
  limit_caption = ""
)

Arguments

mydata	A data frame containing temperature (Temp) and relative humidity (RH) columns.
Temp	The name of the column in mydata containing temperature data ("Temp").
RH	The name of the column in mydata containing relative humidity data ("RH").
z_func	A character string specifying which environmental metric function to use. See details for options (default 'none').
facet_by	Name of categorical column to facet by; defaults to "Sensor".
LowT	Numeric value for lower temperature limit of the target range. Default is 16°C.
HighT	Numeric value for upper temperature limit of the target range. Default is 25°C.
LowRH	Numeric value for lower relative humidity limit of the target range. Default is 40%.
HighRH	Numeric value for upper relative humidity limit of the target range. Default is 60%.
Temp_range	Numeric vector of length two defining x-axis plot limits for temperature.
RH_range	Numeric vector of length two defining y-axis plot limits for relative humidity.
alpha	Numeric transparency level for points.
limit_caption	Character string caption describing plot limits.

Details

Humidity and conservation functions can be used for the y-axis.

• calcHR: Humidity Ratio (g/kg)

• calcMR: Mixing Ratio (g/kg)

• calcAH: Absolute Humidity (g/m^3)

• calcSH: Specific Humidity (g/kg)

• calcAD: Air Density (kg/m^3)

• calcDP: Dew Point (°C)

• calcFP: Frost Point (°C)

• calcEnthalpy: Enthalpy (kJ/kg)

• calcPws: Saturation vapor pressure (hPa)

• calcPw: Water Vapour Pressure (hPa)

• calcPI: Preservation Index

• calcLM: Lifetime

• calcEMC_wood: Equilibrium Moisture Content (wood)

Value

A ggplot2 plot object showing temperature vs relative humidity colored by the selected metric, with annotated boundary segments.

Examples

# mydata file
filepath <- data_file_path("mydata.xlsx")
mydata <- readxl::read_excel(filepath, sheet = "mydata", n_max = 100)

graph_TRHbivariate(
  mydata,
  z_func = "calcAH",
  LowT = 16, HighT = 25,
  LowRH = 40, HighRH = 60,
  Temp_range = c(0, 40),
  RH_range = c(0, 100),
  alpha = 0.7,
  limit_caption = "Example limit box"
)

ConSciR documentation built on Nov. 5, 2025, 5:25 p.m.