create_heatmap: Function wraps ggplot2 geom_tile to produce a heatmap that...
In deandevl/RplotterPkg: R Plotting Functions Using ggplot2

create_heatmap

R Documentation

Function wraps ggplot2 geom_tile to produce a heatmap that shows magnitude as an array of cells in two dimensions.

Description

Function returns a ggplot2 x/y plot of a pair of discrete variables. Instead of a point, a rectangle/cell/tile is located for each x/y value with the cell itself being colored or sized depending on the value of a third associated discrete or continuous variable.

Usage

create_heatmap(
  df,
  aes_x = NULL,
  aes_y = NULL,
  aes_label = NULL,
  aes_color = NULL,
  aes_fill = NULL,
  aes_size = NULL,
  aes_width = NULL,
  aes_height = NULL,
  tile_sz = 1.1,
  tile_color = "white",
  tile_fill = "white",
  label_sz = 6,
  label_color = "black",
  label_fontface = "plain",
  label_alpha = 1,
  title = NULL,
  subtitle = NULL,
  caption = NULL,
  center_titles = FALSE,
  x_title = NULL,
  y_title = NULL,
  hide_x_tics = FALSE,
  hide_y_tics = FALSE,
  rot_x_tic_angle = 0,
  rot_y_tic_label = FALSE,
  x_limits = NULL,
  x_major_breaks = waiver(),
  x_minor_breaks = waiver(),
  x_labels = waiver(),
  x_major_date_breaks = waiver(),
  x_minor_date_breaks = waiver(),
  x_date_labels = waiver(),
  x_log10 = FALSE,
  y_limits = NULL,
  y_major_breaks = waiver(),
  y_minor_breaks = waiver(),
  y_labels = waiver(),
  y_log10 = FALSE,
  x_y_decimals = NULL,
  x_y_scientific = NULL,
  axis_text_size = 11,
  panel_color = "white",
  panel_border_color = "black",
  show_legend = TRUE,
  legend_pos = "right",
  legend_key_width = 0.5,
  legend_key_height = 0.7,
  legend_key_backgrd = "white",
  silent_NA_warning = FALSE,
  png_file_path = NULL,
  png_width_height = c(480, 480)
)

Arguments

`df`	The target data frame from which the heatmap is plotted.
`aes_x`	The x axis variable name from `df`. This is a required discrete numeric, Date/POSIXct variable.
`aes_y`	The y axis variable name from `df`. This is a required discrete numeric.
`aes_label`	Sets the variable name from `df` as the required source for the tile's text.
`aes_color`	The discrete/continuous variable name from `df` for the aesthetic mapping for color.
`aes_fill`	The discrete/continuous variable name from `df` for the aesthetic mapping for fill.
`aes_size`	The variable name from `df` for the aesthetic mapping for size.
`aes_width`	The variable name from `df` for the aesthetic mapping for width.
`aes_height`	The variable name from `df` for the aesthetic mapping for height.
`tile_sz`	A numeric that sets the tile's size width attribute in millimeters.
`tile_color`	A numeric that sets the tile's attribute border color.
`tile_fill`	A string that sets the fill color attribute for the tile.
`label_sz`	A numeric that sets the size of the label.
`label_color`	A string that sets the label's color.
`label_fontface`	A string that sets the label's font face. Acceptable values are "plain", "bold", "italic", "bold.italic".
`label_alpha`	A numeric that sets the label's alpha value.
`title`	A string that sets the plot title.
`subtitle`	A string that sets the plot subtitle.
`caption`	A string that sets the plot caption
`center_titles`	A logical which if `TRUE` centers both the `title` and `subtitle`.
`x_title`	A string that sets the x axis title. If NULL (the default) then the x axis title does not appear.
`y_title`	A string that sets the y axis title. If NULL (the default) then the y axis title does not appear.
`hide_x_tics`	A logical that controls the appearance of the x axis tics.
`hide_y_tics`	A logical that controls the appearance of the y axis tics.
`rot_x_tic_angle`	A numeric that sets the angle of rotation for the x tic labels. When x tic labels are long, a value of 40 for this argument usually works well.
`rot_y_tic_label`	A logical which if TRUE rotates the y tic labels 90 degrees for enhanced readability.
`x_limits`	Depending on the class of `aes_x`, a numeric/Date/POSIXct 2 element vector that sets the minimum and maximum for the x axis. Use NA to refer to the existing minimum and maximum.
`x_major_breaks`	Depending on the class of `aes_x`, a numeric/Date/POSIXct vector or function that defines the exact major tic locations along the x axis.
`x_minor_breaks`	Depending on the class of `aes_x`, a numeric/Date/POSIXct vector or function that defines the exact minor tic locations along the x axis.
`x_labels`	A character vector with the same length as `x_major_breaks`, that labels the major tics.
`x_major_date_breaks`	If the class of `aes_x` is Date/POSIXct, a string containing the number and date unit for major breaks. `"1 year"`, `"4 sec"`, `"3 month"`, `"2 week"`.
`x_minor_date_breaks`	If the class of `aes_x` is Date/POSIXct, a string containing the number and date unit for minor breaks.
`x_date_labels`	If the class of `aes_x` is Date/POSIXct, a string containing the format codes, the strftime format, for the date. Examples: `%Y-%m`, `%Y/%b/%d`, `%H-%M-%S`
`x_log10`	A logical which if `TRUE` will use a log10 scale for the x axis.
`y_limits`	A numeric 2 element vector that sets the minimum and maximum for the y axis. Use `NA` to refer to the existing minimum and maximum.
`y_major_breaks`	A numeric vector or function that defines the exact major tic locations along the y axis.
`y_minor_breaks`	A numeric vector or function that defines the exact minor tic locations along the y axis.
`y_labels`	A character vector with the same length as `y_major_breaks`, that labels the major tics.
`y_log10`	A logical which if `TRUE` will use a log10 scale for the y axis.
`x_y_decimals`	A two element numeric vector that set the number of decimals for the x and y tic labels.
`x_y_scientific`	A two element logical vector that if TRUE uses scientific notation for the x and y tic labels.
`axis_text_size`	A numeric that sets the font size along the axis'. Default is 11.
`panel_color`	A string in hexidecimal or color name that sets the plot panel's color. The default is "white".
`panel_border_color`	A string in hexidecimal or color name that sets the plot panel's border color. The default is "black".
`show_legend`	A logical that controls the appearance of the legend.
`legend_pos`	A string that sets the legend position. Acceptable values are "top", "bottom", "left", "right".
`legend_key_width`	A numeric that sets the legend width in cm.
`legend_key_height`	A numeric that sets the legend height in cm.
`legend_key_backgrd`	A string that sets the legend's background color.
`silent_NA_warning`	A logical that controls the appearance of a console warning when Na's are removed.
`png_file_path`	A character string with the directory and file name to produce a png image of the plot.
`png_width_height`	A numeric vector that sets the width and height of the png image in pixels. The default is c(480,480). There are 37.8 pixels in a centimeter.