The chart block

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)
)

Types

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

Category and value

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).

Splitting the marks

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:

new_chart_block(type = "line", x = "year", y = "gdp", color = "country",
                highlight = list(country = "Switzerland"))

Lines, bands and ranges

# 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")

Numbers

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.

new_chart_block(type = "bar", category = "region", value = "share",
                func = "mean", format = "percent", value_labels = TRUE)

Titles

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.

new_chart_block(
  type = "bar", category = "class", value = "hwy", func = "mean",
  title = "Highway mileage by class",
  subtitle = "{@func in mean, median} of {label(@value)}[ by {@color}]"
)

Clicks

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.

new_chart_block(type = "bar", category = "region", drill = "auto")

Downloads

With download = TRUE (the default) the block offers Excel (the rows), an image, a web page and PowerPoint (the chart as drawn).