ts_plot: Temperature-salinity (T-S) plot from a data frame using...
In MikkoVihtakari/WaterMass: Helpers for the Analysis of Oceanographic Data

Description Usage Arguments Author(s) See Also Examples

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
)

`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.

Mikko Vihtakari with help from baptiste to align marginal plots.

define_water_type, the kongsfjord_watermasses data.frame ,the rijpfjord_watermasses data.frame

Other ts_plot: ctd_kongsfjord, define_water_type(), isfjord_watermasses, kongsfjord_watermasses, rijpfjord_watermasses

# 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")