hd_venn_df: Create a Venn Diagram Directly from a Data Frame

In highdir: Unified Data Visualization Framework for Dynamic and Static Graphics

Create a Venn Diagram Directly from a Data Frame

Description

A single-call convenience wrapper that accepts the same tidy data frame as venn_df_to_list() and returns either an hd_spec_venn object (for the declarative API) or an hd_geom layer (for the composable + API), depending on the output argument.

Usage

hd_venn_df(
  df,
  output = c("spec", "geom"),
  series_name = "Venn Diagram",
  label_font_size = "14px",
  value_suffix = "",
  use_names = FALSE,
  show_legend = FALSE
)

Arguments

df	A data frame with columns id, name, value, type. See venn_df_to_list() for the full format description.
output	Character. "spec" (default) returns an hd_spec_venn; "geom" returns an hd_geom layer for use with +.
series_name	Character. Passed to hd_geom_venn() when output = "geom". Default "Venn Diagram".
label_font_size	Character. Passed to hd_geom_venn() when output = "geom". Default "14px".
value_suffix	Character. Passed to hd_geom_venn(). Suffix appended to value labels (e.g. "%"). Default "".
use_names	Logical. Passed to hd_geom_venn(). Use human-readable names instead of ids in labels. Default FALSE.
show_legend	Logical. Passed to hd_geom_venn(). Show a legend beneath the diagram. Default FALSE.

Details

This means you never need to call venn_df_to_list(), hd_spec_venn(), or hd_geom_venn() directly when starting from a data frame.

Value

An hd_spec_venn object when output = "spec", or an hd_geom object when output = "geom".

Which output to use

output = "spec" (default)

Returns an hd_spec_venn object. Pass to hd_make() just like any other spec. Best for reporting pipelines and scripts that separate data from presentation.

output = "geom"

Returns an hd_geom layer. Add to an hd() object with +. Best for interactive exploration and inline charts.

Declarative API (output = "spec")

df <- data.frame(
  type  = c("set", "set", "intersect"),
  id    = c("A",   "B",   "A,B"),
  name  = c("Oslo", "Bergen", "Both"),
  value = c(120, 95, 40)
)

spec_v <- hd_venn_df(df)
hd_make(spec_v, "venn", hd_opts(title = "City overlap"))

Composable API (output = "geom")

hd(mode = "dynamic") +
  hd_venn_df(df, output = "geom") +
  hd_opts(title = "City overlap")

See Also

venn_df_to_list(), hd_spec_venn(), hd_geom_venn(), hd_make(), hd()

Examples

df <- data.frame(
  type  = c("set", "set", "intersect"),
  id    = c("A",   "B",   "A,B"),
  name  = c("Oslo", "Bergen", "Both"),
  value = c(120, 95, 40)
)

# Declarative API
spec_v <- hd_venn_df(df)
hd_make(spec_v, "venn", hd_opts(title = "City overlap"))

# Composable API
hd(mode = "dynamic") +
  hd_venn_df(df, output = "geom") +
  hd_opts(title = "City overlap")

# static mode
hd(mode = "static") +
  hd_venn_df(df, output = "geom") +
  hd_opts(title = "City overlap")

highdir documentation built on July 31, 2026, 5:06 p.m.