Skip to content

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
Compilation Error
External query file not found: '/opt/build/repo/apps/examples/_doc_examples.yaml' (referenced as '_doc_examples.yaml#sales')
▶
▶ Try in Playground ×
Compilation Error
External query file not found: '/opt/build/repo/apps/examples/_doc_examples.yaml' (referenced as '_doc_examples.yaml#sales')
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
Compilation Error
External query file not found: '/opt/build/repo/apps/examples/_doc_examples.yaml' (referenced as '_doc_examples.yaml#sales')
▶
▶ Try in Playground ×
Compilation Error
External query file not found: '/opt/build/repo/apps/examples/_doc_examples.yaml' (referenced as '_doc_examples.yaml#sales')
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 — —

All chart types at a glance:

Error: Example file not found: /opt/build/repo/apps/examples/charts/all-chart-types.yml