Visualize token frequenceis across pairs of facet values.

visualize_freqs_facet_by2_at(data = NULL, token = NULL, facet = "name_xy",
  xy_nms, xy_grid, filter_facet = FALSE, facet_main = NULL,
  filter_facet_base = default_filter_facet(facet_main),
  filter_facet_params = list(), color = NULL, add_labels = TRUE,
  scale_manual_base = default_scale_manual(), scale_manual_params = list(),
  labs_base = default_labs(), labs_params = list(title =
  "Relative Word Frequency"), theme_base = default_theme(),
  theme_params = list(), facet_base = default_facet("name_xy"),
  facet_params = list())

visualize_freqs_facet_by2(..., token, color, facet)

Arguments

data

data.frame.

token

bare for NSE; character for SE. Name of column in data to use for count.

facet

bare for NSE; character for SE. Name of column in data to use for facetting.

xy_nms

character (vector). Values to use to create a 'grid' of all combinations of values.

xy_grid

data.frame. Output from create_xy_grid().

filter_facet

logical. Whether or not to filter the facet values. facet values to include and exclude. Not used if filter_facet = FALSE.

facet_main

of same type as facet values. Value of single 'main' facet.

filter_facet_base

stuff. Work similarly to other _base arguments.

filter_facet_params

list. Works similarly to other _params arguments.

color

bare for NSE; character for SE. Name of column in data to use for color basis. Even if fill is the actual ggplot2 aesthetic, the internal code will 'coerce' this column to fill. In order to simplify internal code, MUST be specified.

add_labels

logical. Whether or not to add text labels (of the tokens).

scale_manual_base

list. Parameters to pass to ggplot2::scale_fill_manual() or ggplot2::scale_color_manual(), depending on the aesthetic mapping. A default values argument is specified in the internal function default_scale_manual(), so if overwriting explicitly, then values should be included in the list.

scale_manual_params

list. Additional parameters to pass to ggplot2::scale_fill_manual() or ggplot2::scale_color_manual() (e.g. breaks, labels, or name). The default values specified by scale_manual_base = default_scale_manual() can be overwritten a values argument in this list (or directly with a values argument in the scale_manual_base list.

labs_base

ggplot2::labs() function. Defaults to a pre-determined set of values. It is recommended NOT to modify this argument; isntead, the _params argument should be used for customization.

labs_params

list. Additional parameters to pass to ggplot2::labs() to use in addition to and/or override the parameters set in the _base parameter.

theme_base

ggplot2::theme() function. (e.g. as ggplot2::theme_minimal().) A custom theme is supplied as a default. As with the the labs_base argument, it is NOT recommended to change this directly.

theme_params

list. Additional parameters to pass to ggplot2::labs(). Should be used in the same manner as labs_params for customization.

facet_base

ggplot2::facet_wrap() function. An internal function sets defaults for facets, scales, ncol, nrow, and strip.position As with the labs_base and theme_base arguments, it is NOT recommended to set this argument explicitly; instead, the accompanying _params argument should be used.

facet_params

list. Additional parameters to pass to ggplot2::facet_wrap(). Parameters passed to this argument override thos in the _base argument.

...

dots. Parameters to pass directly to visualize_time().

Value

gg.

Details

compute_freqs_facet_by2_at() should NOT be called beforehand.