Skip to contents

Changelog

Source: NEWS.md

ggsunburstR 0.5.1

Error messages

Code quality

  • Extracted shared .read_newick_safe() helper – eliminates duplicated Newick parsing logic between parse_newick() and nw_print().
  • compute_coordinates() now guards against all-zero leaf sizes with an informative error instead of silent division by zero.
  • drilldown() params$drilldown_from now always stores the node name (previously stored mixed types depending on how node was specified).
  • Fixed 1-space indent in drilldown.R.
  • Pinned rangle(270) test to exact expected value.

Documentation

  • Added @seealso cross-references to sunburst(), icicle().
  • Added @details to ggtree() documenting three layout modes.
  • Added bare name fill example to sunburst() roxygen2 examples.
  • Added label_repel example to icicle() roxygen2 examples.
  • Added deprecation plan note for fill = NULL in sunburst() and icicle() docs.

Testing

  • Added 21 edge-case tests: single-leaf bars/tile, empty/malformed paths, duplicate paths, non-scalar data.tree fields, deep tree (20 levels), xlim < 360 labels, tibble input, duplicate tip labels, all-zero values, print output content, fill=“auto” equivalence, invalid fill expression.
  • 625 tests total, R CMD check 0/0/0.

ggsunburstR 0.5.0

ggplot2 geom

  • geom_sunburst() provides idiomatic ggplot2 syntax: ggplot(df) + geom_sunburst(aes(id = child, parent = parent)). Uses a custom StatSunburst ggproto to convert parent-child data.frames into sunburst coordinates. Add coord_polar() for sunburst layout or leave Cartesian for icicle. Supports values, branchvalues, and leaf_mode parameters.

New theme

  • theme_sunburst() provides a tailored theme for sunburst and donut charts: centred bold title, bottom legend, tidy margins. Based on theme_void().

Fill improvements

  • fill = "auto" maps fill to the depth column in sunburst(), icicle(), and donut().
  • fill = "none" explicitly produces static grey (escape hatch for when the default eventually changes to "auto" in a future version).
  • Bare name support: sunburst(sb, fill = depth) now works alongside the existing fill = "depth" string syntax.

Testing

  • Added 36 new tests (605 total).
  • R CMD check: 0 errors, 0 warnings, 0 notes.

ggsunburstR 0.4.0

Label enhancements

  • sunburst() gains label_type = "perpendicular" for arc-following labels that use pre-computed pangle/pvjust values and position text at the radial midpoint.
  • sunburst() and icicle() gain show_node_labels for internal node labels, label_size for controlling text size, and min_label_angle for filtering labels on narrow sectors.
  • icicle() gains label_repel = TRUE for ggrepel-based collision avoidance. Requires the ggrepel package (Suggests). Polar repulsion for sunbursts is deferred – use min_label_angle instead.

New functions

Data improvements

  • sunburst_data() now includes ymin, ymax, and delta_angle columns in the $leaf_labels data.frame, enabling perpendicular label positioning and angular filtering.

Dependencies

  • Added ggrepel and ggnewscale to Suggests.

Testing

  • Added 69 new tests (569 total).
  • R CMD check: 0 errors, 0 warnings, 0 notes.

ggsunburstR 0.3.0

New plot types

  • donut() creates ring charts – sunbursts restricted to the outermost 1–N depth levels with configurable centre hole size.
  • ggtree() creates classical dendrograms using geom_segment(). Supports horizontal layout (rotate = TRUE), circular layout (polar = TRUE), leaf labels, and scale bars.

New functions

  • drilldown() extracts a subtree and recomputes coordinates so the selected node fills the full angular space. Returns a new sunburst_data object compatible with all plot functions. Supports chaining.
  • bars() adds bar chart annotations adjacent to leaf nodes. Values are max-normalised per variable. Supports multiple variables, labels, and value display.
  • tile() adds heatmap-style tile annotations adjacent to leaf nodes. Works with both numeric and categorical variables.

Testing

  • Added 76 new tests (499 total).
  • R CMD check: 0 errors, 0 warnings, 0 notes.

ggsunburstR 0.2.0

New input formats

  • Accept ape::phylo objects directly – no Newick conversion needed (sunburst_data(phylo_obj)).
  • Path-delimited strings – sunburst_data(c("A/B/C", "A/B/D")) with configurable separator via sep.
  • Path-column data.frames – sunburst_data(data.frame(path = ...)) with extra columns carried as node attributes.
  • data.tree::Node objects – R6-based trees with custom scalar fields preserved as attributes.

New functions

  • highlight_nodes() adds a highlight layer to sunburst/icicle plots for specific nodes by name or ID.
  • nw_print() prints tree structure from Newick input for inspection.

Bug fixes

  • Fixed rbind column mismatch when nodes have varying extra columns from different input sources.

Testing

  • Added 81 new tests (423 total), including comprehensive ragged tree edge-case coverage.

ggsunburstR 0.1.0

Initial release.

Features

  • sunburst_data() parses hierarchical data from 4 input formats: Newick strings/files, data.frames with parent-child columns, lineage files, and node-parent CSV/TSV files.
  • sunburst() creates polar sunburst plots with coord_polar().
  • icicle() creates rectangular icicle plots with scale_y_reverse().
  • Value-weighted sectors via the values parameter.
  • Label support with pre-computed positions and flip logic for readability.
  • Tree transforms: ladderize and ultrametric options.
  • S3 class sunburst_data with print(), plot(), as.data.frame(), and $data alias.
  • Standard ggplot2 objects – customise with +.
  • 342 tests, R CMD check clean.