Visualize time-based data over time.
visualize_time_at(data = NULL, timebin = NULL, bin = FALSE,
timefloor = NULL, color = NULL, geom = c("bar", "hist"),
add_alpha = FALSE, alpha_range = c(0.25, 1),
scale_manual_base = default_scale_manual(), scale_manual_params = list(),
labs_base = default_labs(), labs_params = list(title = "Count Over Time"),
theme_base = default_theme(panel.grid.major.x = ggplot2::element_blank()),
theme_params = list())
visualize_time(..., timebin, color)
visualize_time_facet_at(..., theme_base = default_theme(panel.grid.major.x =
ggplot2::element_blank()), facet = NULL,
facet_base = default_facet(facet), facet_params = list())
visualize_time_facet(..., timebin, color, facet)
Arguments
data |
data.frame. |
timebin |
bare for NSE; character for SE. Name of column in data to use for time axis. |
bin |
logical. Whether or not to call lubridate::floor_date() to truncate timebin . |
timefloor |
character. Name of column passed directly to unit parameter of
lubridate::floor_date() if bin = FALSE . |
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. |
geom |
character. 'bar' or 'hist'. 'bar' is probably best for everything except Date objects. |
add_alpha |
logical. Whether or not to use ggplot2::scale_alpha() based on count. |
alpha_range |
numeric (vector). Direct parameter passed to range parameter
of ggplot2::scale_alpha() . |
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. |
... |
dots. Parameters to pass directly to visualize_time() . |
facet |
bare for NSE; character for SE. Name of column in data to use for facetting. |
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. |
Value
gg
Details
facet
version is for facetting. Lists are used for
customization arguments (instead of dots) because there
are multiple arguments that can be customized.
See also
https://juliasilge.com/blog/ten-thousand-tweets/.