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.