More Chart Types¶

Beyond the common charts, Dataface supports all Vega-Lite mark types. This page covers specialized charts and the complete reference.

Heatmap¶

Best for: Two-dimensional patterns, matrix data

charts:
  heatmap:
    query: _doc_examples.yaml#sales
    type: heatmap
    title: Revenue Heatmap
    x: product
    y: category
    color: revenue
rows:
  - heatmap

▶

Field	Required	Description
`x`	Yes	Column categories
`y`	Yes	Row categories
`color`	Yes	Value to color by

Histogram¶

Best for: Distribution of continuous values

charts:
  histogram:
    query: _doc_examples.yaml#sales
    type: histogram
    title: Revenue Distribution
    x: revenue
rows:
  - histogram

▶

Field	Required	Description
`x`	Yes	Continuous field to bin
`color`	No	Category grouping

Histograms automatically bin the x-axis values.

All Vega-Lite Marks¶

Dataface supports every Vega-Lite mark type. Use the type field with any mark name:

Type	Description	Use Case
`bar`	Bar chart	Category comparisons
`line`	Line chart	Time series
`area`	Area chart	Stacked trends
`point`	Point plot	Scatter plots
`circle`	Circle plot	Bubble charts
`square`	Square plot	Matrix dots
`tick`	Tick marks	Distribution strips
`rect`	Rectangle	Heatmaps, calendars
`rule`	Rule/line	Reference lines, thresholds
`text`	Text labels	Annotations
`trail`	Trail plot	Paths, connections
`arc`	Arc marks	Pie, donut, radial charts
`geoshape`	Geographic shapes	Maps
`choropleth`	Filled region map	State/country metrics
`point_map`	Location markers	Plotting locations
`bubble_map`	Sized markers	Location + magnitude
`boxplot`	Box plot	Statistical distribution
`errorbar`	Error bars	Uncertainty visualization
`errorband`	Error bands	Confidence intervals

Convenience Aliases¶

These aliases map to Vega-Lite marks with sensible defaults:

Alias	Maps To	What It Does
`scatter`	`point`	Scatter plot
`heatmap`	`rect`	Color-coded matrix
`pie`	`arc`	Pie chart
`donut`	`arc`	Pie with inner radius
`histogram`	`bar`	Auto-binned bar chart

Input Requirements¶

Quick reference for what each chart type needs:

Type	Required	Optional
`bar`	`x`, `y`	`color`, `size`
`line`	`x`, `y`	`color`, `size`, `shape`
`area`	`x`, `y`	`color`
`scatter`	`x`, `y`	`color`, `size`, `shape`
`heatmap`	`x`, `y`, `color`	—
`pie` / `donut`	`x`, `y`	`color`
`histogram`	`x`	`color`
`boxplot`	`x`, `y`	`color`
`kpi`	`metric`	—
`table`	—	—

Gallery¶

All chart types at a glance:

▶

Chart Types - Common charts with examples
Maps - Choropleth, point, and bubble maps
Charts Overview - Field reference and styling
Vega-Lite Marks - Official documentation