vega coverage ledger
Generated from
catalog/scenarios.jsonplus the curated unit table for this engine. Runtime: vega 6.4.0 + vega-lite 6.4.3. Last generated: 2026-09-21.
Units record what this engine does with each unit of its official documentation — kept, or excluded with the reason. Examples by goal is collected from the catalog, so every link below is resolvable from this file.
Marks (18 official → 16 kept)
| Unit | Fence | Disposition | Example in this package |
|---|---|---|---|
bar · line · area |
vega-lite | kept | delivery-throughput/*, incident-trend-stacked-area, streamgraph-topic-composition |
point · circle · square |
vega-lite | kept | data-exploration/*, support-capacity-units |
tick |
vega-lite | kept | stripplot-region-spread |
rect |
vega-lite | kept | deploy-frequency-calendar, service-drift-lasagna |
rule |
vega-lite | kept | team-variance-interval, build-time-candles |
text |
vega-lite | kept | support-capacity-units |
arc |
vega-lite | kept | release-time-split-donut |
trail |
vega-lite | kept | error-budget-burn-trail |
boxplot · errorbar · errorband |
vega-lite (composite) | kept | release-duration-distribution, forecast-range-band |
image |
vega-lite | excluded | needs an external image file |
geoshape |
vega-lite | excluded | needs GeoJSON/TopoJSON; the export path is offline |
Transforms (19 Vega-Lite + Vega additions → 25 used)
| Group | Units kept |
|---|---|
| Row/field maths | calculate filter fold flatten pivot impute sample |
| Aggregation & windows | aggregate joinaggregate window stack bin quantile |
| Statistics | density regression loess kde kde2d isocontour |
| Joins | lookup sequence (data generator) |
| Hierarchy & layout (Vega) | stratify tree treelinks treemap pack partition force linkpath geopath pie |
| Not used | project (geo), voronoi, wordcloud (covered by the infographic engine), crossfilter/relay (interaction) |
Vega-only capability (what Vega-Lite cannot express)
| Unit | Disposition | Example |
|---|---|---|
force + linkpath |
kept — needs "static": true |
service-call-force-map |
tree (cluster) + radial |
kept | org-chart-radial-tree |
treemap · pack · partition (+ arc) |
kept | cost-center-treemap, asset-size-packing, catalog-sunburst-share |
kde · kde2d + isocontour + geopath |
kept | release-size-violin, alert-density-contours |
arc diagrams / radial layouts |
kept | module-import-arcs |
| Parallel coordinates | kept (built from fold + faceted lines, not a transform) |
parallel-risk-screen |
| Word cloud | excluded here — the infographic engine has a template for it | — |
Composition, interaction, maps
| Unit | Disposition |
|---|---|
layer · facet · concat/hconcat/vconcat · repeat · resolve |
kept |
params · select · bind (interaction) |
excluded — an exported image cannot show them; a static overview+detail is built from two views |
| Projections / geo displays | excluded — no external geographic data |
mark.invalid (filter, break-paths-*, show) |
documented as a boundary: nulls are filtered by default, so broken lines need an explicit setting |
Implementation boundaries
| Item | Fact |
|---|---|
| Data resolution order (Vega) | a dataset using "source" must be declared after the dataset it reads, or the spec fails with Undefined data set name |
| Auto-sorting | disabled by the renderer: every ordinal axis whose order matters needs an explicit sort, otherwise data row order decides |
| Expression evaluator | vega-interpreter — expressions are allowed, JavaScript functions are not |
| External data | data.url is unreliable on the export path; use values or the sequence generator |
kde2d coordinates |
receives pixel values (scale('x', datum.field)), so bandwidth is in pixels |
Examples by goal
46 examples across 12 goal domains.
data-exploration
| Scenario | Tier | Example |
|---|---|---|
| distribution comparison | T1 | metric-distribution-small-multiples.md<br>stripplot-region-spread.md |
| correlation | T1 | metric-correlation-matrix.md |
| composition over time | T1 | streamgraph-topic-composition.md |
| deviation analysis | T1 | deviation-from-average.md |
| missing data | T1 | imputed-gap-trend.md |
| regression fit | T1 | regression-trend-fit.md |
| small multiples | T1 | segment-pattern-small-multiples.md |
delivery-throughput
| Scenario | Tier | Example |
|---|---|---|
| team capacity | T0 | support-capacity-units.md |
| release packet profile | T0 | release-duration-distribution.md<br>release-size-violin.md<br>build-time-candles.md<br>request-size-distribution.md<br>asset-size-packing.md<br>release-time-split-donut.md |
| rank movement | T0 | rank-movement-over-time.md<br>adoption-shift-slope.md |
| backlog flow | T1 | demand-overview-detail.md |
| throughput vs cycle | T1 | growth-vs-efficiency-path.md |
| plan vs actual | T1 | plan-to-actual-bridge.md |
service-reliability
| Scenario | Tier | Example |
|---|---|---|
| latency profile | T0 | latency-beeswarm-regions.md<br>service-latency-density.md<br>before-after-latency-gap.md<br>service-drift-lasagna.md |
| forecast band | T1 | forecast-range-band.md<br>team-variance-interval.md |
| error budget | T1 | error-budget-burn-trail.md |
| threshold monitoring | T1 | threshold-breach-annotation.md |
business-reporting
| Scenario | Tier | Example |
|---|---|---|
| revenue mix | T0 | quarterly-share-normalized-stack.md |
| revenue concentration | T1 | revenue-concentration-topk-others.md |
dependencies-and-relations
| Scenario | Tier | Example |
|---|---|---|
| service dependencies | T0 | service-call-force-map.md |
| import coupling | T1 | module-import-arcs.md |
cost-and-budget
| Scenario | Tier | Example |
|---|---|---|
| spend hierarchy | T0 | cost-center-treemap.md |
| cost vs capacity | T1 | capacity-cost-dual-axis.md |
knowledge-and-outline
| Scenario | Tier | Example |
|---|---|---|
| keyword cloud | T0 | topic-landscape-wordcloud.md |
| content mix | T2 | catalog-sunburst-share.md |
ops-monitoring
| Scenario | Tier | Example |
|---|---|---|
| incident load | T0 | alert-density-contours.md<br>incident-rate-stripes.md |
| service profile | T0 | capability-comparison-radar.md<br>risk-profile-parallel.md |
organization-and-roles
| Scenario | Tier | Example |
|---|---|---|
| org structure | T0 | org-chart-radial-tree.md |
| workforce profile | T2 | workforce-seniority-pyramid.md |
goal-and-status-reporting
| Scenario | Tier | Example |
|---|---|---|
| goal attainment | T0 | target-attainment-bullet.md |
engineering-operations
| Scenario | Tier | Example |
|---|---|---|
| deploy rhythm | T1 | deploy-frequency-calendar.md<br>deploy-punchcard-weekday-hour.md |
planning-and-roadmap
| Scenario | Tier | Example |
|---|---|---|
| release schedule | T2 | release-window-schedule.md |
Counts
| Examples using this engine | 46 |
| Goal domains reached | 12 |
| Scenarios | 32 |
| T0 scenarios | 12 |
Sources
- Engine reference:
../vega.md - Catalog:
../../catalog/scenarios.md