Temperature-salinity (T-S) plot from a data frame using ggplot2

Makes a T-S plot from salinity and temperature data.

ts_plot(
  dt,
  temp_col = "temp",
  sal_col = "sal",
  WM = kongsfjord_watermasses,
  color_wmpoly = "grey30",
  xlim = NULL,
  ylim = NULL,
  color = "watertype",
  zoom = TRUE,
  nlevels = 6,
  color_isopyc = "grey90",
  symbol_shape = 1,
  symbol_size = 3,
  symbol_alpha = 0.6,
  color_scale = NULL,
  color_var_name = NULL,
  margin_distr = FALSE,
  margin_width = 0.15,
  margin_height = 0.2,
  plot_data = TRUE,
  base_size = 10
)

Arguments

dt	data frame
temp_col	character specifying the column name that contains temperature information. Should be potential temperatures (theta) instead of in-situ tempretatures, if default `WM` is used.
sal_col	character specifying the column name that contains salinity information.
WM	dataframe containing the water type definitions for polygons boundaries for water types. Set to `NULL` to remove the polygon boundaries. See Details in `define_water_type` for further details.
color_wmpoly	character defining the color for water mass polygon edges.
xlim	numeric vector specifying th limits for x-axis. If `NULL`, the `zoom` argument is used.
ylim	numeric vector specifying th limits for y-axis. If `NULL`, the `zoom` argument is used.
color	character indicating the mapping variable for color. Either a single character from `colors`, "watertype" or column name in `dt`. If `"watertype"`, the symbols are colored based on water type using a prededined palette. If the character specifies a valid color, that color is used for the data symbols.
zoom	logical indicating whether the x- and y-axis should be limited to data. If `FALSE`, the entire water mass diagram from the `WM` data frame is shown.
nlevels	number of automatically-selected isopycnal levels. Set to 0 to remove isopycnals.
color_isopyc	character defining the color for isopycnals.
symbol_shape	character or numeric. ggplot syntax for shape of plotting symbols. See `geom_point`
symbol_size	numeric. ggplot syntax for size of symbol. See `geom_point`
symbol_alpha	numeric value between 0 and 1 defining the transparency of symbols. Set to 1 to remove transparency. See `geom_point`
color_scale	named vector giving all `WM$abb` levels (names) and their corresponding colors. See the `values` argument in `scale_colour_manual`
color_var_name	character giving the name that should be used in legend of color scale. See the `name` argument in `scale_colour_manual`
margin_distr	logical indicating whether kernel density estimates of temperature and salinity should be added to margins of the plot.
margin_width, margin_height	numeric specifying the width and height of the x- and y-axis margin plots as a propotion of the plot width ("npc" from `unit`).
plot_data	logical indicating whether salinity and temperature data should be plotted. `FALSE` returns an empty T-S plot frame allowing further customization using ggplot2 syntax.
base_size	Base size parameter for ggplot. See theme_bw.

Examples

# Using example data

dt <- data.frame(temp = c(1, -1.1, -0.8, 3.2), sal = c(34, 34.5, 34.9, 33.9))
ts_plot(dt)

# Using real CTD data

data("ctd_kongsfjord")

ts_plot(ctd_kongsfjord)
ts_plot(ctd_kongsfjord, zoom = FALSE) # show all of WM
ts_plot(ctd_kongsfjord, color = "area", margin_distr = TRUE) # scaling color to "area"
ts_plot(ctd_kongsfjord, color = "red", margin_distr = TRUE) # no color scaling

# Using a different WM

data("ctd_rijpfjord")

ts_plot(ctd_rijpfjord, WM = rijpfjord_watermasses)

# example of graphical parameter modification
ts_plot(ctd_rijpfjord, WM = rijpfjord_watermasses, symbol_shape = 16, symbol_size = 0.1,
symbol_alpha = 0.8, margin_distr = TRUE, xlim = c(32, 35), color = "area")

Temperature-salinity (T-S) plot from a data frame using ggplot2

Arguments

See also

Examples