new_chart_block()
draws the data it receives as an interactive chart and passes the data
on, filtered by the reader’s last click if drill is set.
Everything below can also be set in the block’s gear; the gear and the
code write the same arguments.
Run any of these with a data frame of your own:
library(blockr.core)
library(blockr.viz)
serve(
new_chart_block(type = "bar", category = "Species",
value = "Sepal.Length", func = "mean"),
data = list(data = iris)
)| type | draws | set |
|---|---|---|
"bar", "waterfall", "pie",
"treemap" |
one mark per category, aggregated | category, value, func |
"boxplot", "pointrange" |
the spread of a column per category | category, value, summary |
"histogram" |
the rows of one numeric column, binned | x, bins |
"scatter", "line",
"area" |
one mark per row | x, y |
"band" |
a running quantile band across individuals | x, y, id |
"gantt" |
intervals on lanes | x, xend, y |
An aggregated type draws one mark per value of category,
and aggregates value with func. A row count
needs no value. orientation turns the marks
and changes nothing else:
# counts per class, horizontal bars
new_chart_block(type = "bar", category = "class")
# counts per class, vertical bars
new_chart_block(type = "bar", category = "class", orientation = "vertical")
# summed sales per region
new_chart_block(type = "bar", category = "region", value = "sales",
func = "sum")x and y are for the types that draw one
mark per row (scatter, line, area, band), the histogram and the
gantt.
func is one of "count",
"count_distinct", "pct_distinct",
"mean", "median", "sum",
"min", "max" or "identity" (the
value as it is).
color colors, series splits rows into lines
or point groups, facet draws one panel per level, and
label writes a column on the marks.
new_chart_block(type = "bar", category = "class", value = "hwy",
func = "mean", color = "drv", position = "dodge")
new_chart_block(type = "line", x = "date", y = "value", color = "country",
facet = "region", facet_cols = 3, legend = "marks")With facet_row the panels form a grid, as with ggplot2’s
facet_grid(): facet_row levels down,
facet levels across, strips on top and on the right. A
combination without rows is an empty cell.
facet_scales = "free_y" gives each row its own value axis,
shared by the panels in that row; "free" also frees the
other axis per column. Only the outer panels label their axes. A row
missing a facet or facet_row level is left out
of a line, scatter or timeline and shows as a “(missing)” row or column
of bars, as in a wrap.
new_chart_block(type = "line", x = "AVISITN", y = "AVAL", series = "USUBJID",
facet = "TRTA", facet_row = "PARAM", facet_scales = "free_y")position is "stack", "dodge"
or "fill" (shares of 100 percent). legend is
"bottom", "top", "marks" (names
at the end of the lines or on the slices) or "none".
highlight keeps a few marks in color and grays the
rest:
# a forecast fan: nested bands, the first the outermost
new_chart_block(type = "line", x = "date", y = "fc",
ymin = c("lo95", "lo80"), ymax = c("hi95", "hi80"))
# a target line and a shaded period
new_chart_block(type = "line", x = "date", y = "rate",
value_lines = c(Target = 2),
x_ranges = list(Recession = c("2008-01-01", "2009-06-30")))
# a scatter with a linear trend per group, on a log axis
new_chart_block(type = "scatter", x = "gdp", y = "life", color = "continent",
smoother = "lm", x_transform = "log10")format prints the values on the axis, in tooltips and in
value labels: "number", "compact" (1.2K),
"percent", or a number of decimals from 0 to 6.
unit is text after the number.
title, subtitle and caption
take templates. {@arg} prints one of the block’s own
settings, and the reader can change it by clicking it on the chart. A
part in [...] disappears when it would be empty.
With drill, a click filters the block’s output to the
rows behind the clicked mark: set it to a column, or to
"auto" for the mark’s own category. Blocks linked below the
chart then show only those rows. A brush on a scatter or a line filters
to the brushed range.
With download = TRUE (the default) the block offers
Excel (the rows), an image, a web page and PowerPoint (the chart as
drawn).