collapsibleTree (version 0.1.5)

collapsibleTreeSummary: Create Summary Interactive Collapsible Tree Diagrams

Description

Interactive Reingold-Tilford tree diagram created using D3.js, where every node can be expanded and collapsed by clicking on it. This function serves as a convenience wrapper to add color gradients to nodes either by counting that node's children (default) or specifying another numeric column in the input data frame.

Usage

collapsibleTreeSummary(df, hierarchy, root = deparse(substitute(df)),
  inputId = NULL, width = NULL, height = NULL, attribute = "leafCount",
  fillFun = colorspace::heat_hcl, maxPercent = 25, linkLength = NULL,
  fontSize = 10, tooltip = TRUE, ...)

Arguments

df

a data frame from which to construct a nested list

hierarchy

a character vector of column names that define the order and hierarchy of the tree network

root

label for the root node

inputId

the input slot that will be used to access the selected node (for Shiny). Will return a named list of the most recently clicked node, along with all of its parents.

width

width in pixels (optional, defaults to automatic sizing)

height

height in pixels (optional, defaults to automatic sizing)

attribute

numeric column not listed in hierarchy that will be used as weighting to define the color gradient across nodes. Defaults to 'leafCount', which colors nodes by the cumulative count of its children

fillFun

function that takes its first argument and returns a vector of colors of that length. rainbow_hcl is a good example.

maxPercent

highest weighting percent to use in color scale mapping. All numbers above this value will be treated as the same maximum value for the sake of coloring in the nodes (but not the ordering of nodes). Setting this value too high will make it difficult to tell the difference between nodes with many children.

linkLength

length of the horizontal links that connect nodes in pixels. (optional, defaults to automatic sizing)

fontSize

font size of the label text in pixels

tooltip

tooltip shows the node's label and attribute value.

...

other arguments passed on to fillFun, such declaring a palette for brewer.pal

Examples

# NOT RUN {
# Color in by number of children
collapsibleTreeSummary(warpbreaks, c("wool", "tension", "breaks"), maxPercent = 50)

# Color in by the value of breaks and use the terrain_hcl gradient
collapsibleTreeSummary(
  warpbreaks,
  c("wool", "tension", "breaks"),
  attribute = "breaks",
  fillFun = colorspace::terrain_hcl,
  maxPercent = 50
)
# }