chart.histogram@1

Primary palette

Profile verification

• Marks bar/line/area/point/pie/donut bind explicit selected records. Numeric values must be finite numbers; numeric strings are not coerced.
• x is category/number/date; point requires numeric x, bar/pie/donut category. Line/area may use category, number or UTC date.
• Zero-baseline and arc share rules remain mark-specific; unit declarations must agree with supplied record units.
• aggregate none/sum/count/min/max/mean is available only on supported bar/arc/top-k paths, with contributor IDs preserved; count has no physical unit.
• Explicit empty records is legal for bar/line/area/point; filtering a nonempty selection to nothing is an error. Missing error/skip is explicit.
• Specialization mark histogram uses channels: x. Raw numeric samples, no y or series. Equal-width bins, bin_count 2..100; final maximum belongs to the last bin; contributor IDs retained.

Profile defaults

Explicit file settings override eligible CSS, then these profile defaults and the common standard apply. Unspecified semantic facts remain unspecified.

{
  "projection.kind": "chart",
  "projection.profile": "chart.histogram@1",
  "projection.mark": "histogram",
  "projection.x_type": "number",
  "projection.aggregate": "none",
  "projection.missing": "error",
  "projection.bin_count": "derived: min(40,max(5,ceil(sqrt(n))))"
}

Projection properties

kind, profile, width, height, records, mark, x, y, x_type, size, unit, aggregate, filter, order, missing, inner_radius, series, series_missing, arrangement, transform, layers, bins, normalize, outside, whiskers, quartiles, step, baseline, target, open, high, low, close, bin_count, k, others, error, trend, iso, depth

Search the property codex

Design operations

• Select records; bind channels and units; choose mark; edit source values; select filter/order/aggregate; inspect every mark contribution.

Outside this profile

• density normalization
• unequal bins (use chart.quality@1 transform for declared boundaries)