Hierarchy and Specialized Charts

These families answer more specialized questions. Begin with comparison or trend charts when possible, and use the compatibility explanation to identify the required data for each specialized view.

Polar charts

Interactive example

Polar charts

Comparing magnitudes by angle and radius.

Polar charts require non-negative values.

Type	Best for	Required data
`rose`	Comparing magnitudes by angle and radius.	Category, value, and series.
`radarLine`	Comparing multivariate profiles.	At least three categories, non-negative values, and series.
`radarArea`	Comparing filled multivariate profiles.	At least three categories, non-negative values, and series.
`polarColumn`	Radial category comparison.	Category, value, and series.
`radialColumn`	Rectangular radial columns for category comparison.	Non-negative category/value data and one or more series.
`stackedPolarColumn`	Radial totals and composition.	Category, value, and series.
`normalizedPolarColumn`	Radial percentage composition.	Category, value, and series.
`radialBar`	A single-series circular progress comparison.	Category, value, and exactly one series.
`multiRingRadialBar`	Comparing several series as concentric rings.	Category, value, and series.

Hierarchy charts

Interactive example

Hierarchy charts

Space-efficient nested proportions.

Treemap, sunburst, icicle and circle packing require row-hierarchy metadata and select one non-negative weight series. Organization cards use their own parent-ID or dimension-path hierarchy contract and can omit numeric weights.

Type	Best for	Required data
`treemap`	Space-efficient nested proportions.	`hierarchy` plus one `weight` measure.
`sunburst`	Concentric hierarchy levels.	`hierarchy` plus one `weight` measure.
`icicle`	Depth-oriented rectangular hierarchy.	`hierarchy` plus one `weight` measure.
`circlePacking`	Nested hierarchy represented by packed circles.	`hierarchy` plus one `weight` measure.
`organization`	Parent/child reporting structures with cards and connectors.	Stable category/parent-ID or dimension-path hierarchy; numeric weights are optional. Missing parents and cycles reject.

Treemap includes a category legend so names remain identifiable when a tile is too narrow for its header. Legend colors match the tiles, including custom renderer palettes. Use presentation.legendPosition to position it or set 'none' to hide it, and the renderer’s labels API to translate or style legend text. Very compact or dense legends retain the shared overflow indicator; each tile still exposes its full name through hover and keyboard focus.

Matrix and specialized charts

Interactive example

Matrix and specialized charts

Comparing magnitude across category-by-series cells.

Type	Best for	Required data
`heatmap`	Comparing magnitude across category-by-series cells.	Category, value, and series.
`calendarHeatmap`	Activity intensity by date.	A date-semantic category, value, and exactly one series.
`waterfall`	Sequential positive and negative contribution to a result.	Category, value, and exactly one series.
`timelineRange`	Start/end intervals by category.	Exactly one `start` and one `end` measure.

Process, flow, and financial charts

Interactive example

Process, flow, and financial charts

Stage-by-stage conversion or attrition.

Type	Best for	Required data
`funnel`	Stage-by-stage conversion or attrition.	Non-negative category/value data and one series.
`coneFunnel`	Proportional stage widths connected by tapered segments.	Non-negative category/value data and one selected series.
`pyramid`	Hierarchical-looking stage magnitude.	Non-negative category/value data and one series.
`sankey`	Weighted directional flows.	`source`, `target`, and non-negative `weight` channels.
`chord`	Weighted relationships in a circular flow matrix.	`source`, `target`, and non-negative `weight` channels.
`candlestick`	Open/high/low/close price movement.	One or more explicit OHLC groups bound to `open`, `high`, `low`, and `close`; each close field owns a group.
`ohlc`	Compact open/high/low/close price ticks.	One or more explicit OHLC groups with distinct close owners.
`volumePrice`	OHLC price movement plus traded volume.	One or more paired OHLC/volume groups with distinct close and volume owners.

Optional geographic pack

Interactive example

Geographic providers

Explore schematic provider-owned regions. The example does not include real map geometry.

createPivotChartGeographicCapabilityPack(provider) creates a standalone host for provider-owned choropleth, proportionalSymbolMap, and geographicHeatmap views. Render these explicitly with pack.render(...). They are intentionally outside PIVOT_CHART_TYPES and the standard gallery. The provider owns map assets, projected geometry, and licensing; Pivot does not bundle a map library or geographic data.

Next steps

See data/channel reference, renderer capabilities and server data.