blockr.ggplot (version 0.1.0)

new_facet_block: Facet Block

Description

Applies faceting to a ggplot object using facet_wrap() or facet_grid(). Accepts a single ggplot input and adds faceting based on data columns.

Usage

new_facet_block(
  facet_type = "wrap",
  facets = character(),
  rows = character(),
  cols = character(),
  ncol = character(),
  nrow = character(),
  scales = "fixed",
  labeller = "label_value",
  dir = "h",
  space = "fixed",
  ...
)

Value

A ggplot transform block object of class facet_block.

Arguments

facet_type

Type of faceting: "wrap" or "grid" (default: "wrap")

facets

Column(s) to facet by for facet_wrap (character vector)

rows

Column(s) for row facets in facet_grid (character vector)

cols

Column(s) for column facets in facet_grid (character vector)

ncol

Number of columns for facet_wrap (default: NULL for auto)

nrow

Number of rows for facet_wrap (default: NULL for auto)

scales

Scale behavior: "fixed", "free", "free_x", "free_y" (default: "fixed")

labeller

Labeller function: "label_value", "label_both", "label_parsed" (default: "label_value")

dir

Direction for facet_wrap: "h" (horizontal) or "v" (vertical) (default: "h")

space

Space behavior for facet_grid: "fixed", "free_x", "free_y" (default: "fixed")

...

Forwarded to new_ggplot_transform_block()

Examples

# Create a facet wrap block
new_facet_block(facet_type = "wrap", facets = "cyl")

# Create a facet grid block
new_facet_block(facet_type = "grid", rows = "cyl", cols = "gear")

if (interactive()) {
  library(blockr.core)
  # Facet block requires a ggplot input
  serve(new_facet_block())
}