Pie Charts¶

Dataface pie charts are authored with top-level Dataface fields.

type: pie renders an arc mark
inner_radius sets the inner radius ratio (0–1) for a donut appearance
theta defines wedge size
color splits the whole into slices

This page documents the authored Dataface surface for pie charts. Raw chart-level Vega-Lite mark and encoding passthrough are not part of that surface.

Top-Level Pie Fields¶

Dataface field	Maps to Vega-Lite	Notes
`query`	`data.values`	Query results become the plotted dataset.
`type: pie`	`mark.type: "arc"`	Standard pie chart.
`inner_radius`	`mark.innerRadius`	Inner radius ratio (0–1). Use `0.5` for a donut appearance.
`title`	`title.text`	Chart title.
`description`	metadata	Available for tooling and docs.
`theta`	`encoding.theta.field`	Required wedge-size field.
`color`	`encoding.color.field`	Category shorthand.
`style.legend.disable: true`	`encoding.color.legend: null`	Typed legend control.

Top-Level Example¶

charts:
  pie_top_level:
    query: _doc_examples.yaml#sales_by_category
    type: pie
    title: Revenue by Category
    description: Pie-chart top-level fields
    theta: revenue
    color: category
    style:
      legend:
        disable: true
rows:
  - pie_top_level

▶

Authored Surface¶

Arbitrary Vega-Lite spec, mark, encoding, config, transform, params, and composition blocks are rejected on the authored surface. Use top-level Dataface fields and the typed style: object.