Graflume · Alpha
Gauge · Edge-case application
Emphasize one metric's current level within a defined range. Exercise numeric range, sparse structure, and large inputs with valid data. Each tab materializes data only when needed and never silently repairs invalid values.
Chart family · Default families
Gauge
Emphasize one metric's current level within a defined range.
- Quick API
gauge()- Browser snapshot
graflume- mark
gauge- Presets
- 5
Edge cases
Numeric range, irregular structure, and data volume
Exercise numeric range, sparse structure, and large inputs with valid data. Each tab materializes data only when needed and never silently repairs invalid values.
Wide numeric range
Mix zero, very small finite values, and very large finite values to verify automatic domains, precision, and stable geometry. NaN and Infinity remain intentionally invalid. It applies 2 data-integrity rules that preserve finite values and axis domains.
StatusLoading
extreme-rangeextreme-smallextreme-largezerodomain-boundarybudget:marks<=1
Loading
Wide numeric range · Row data
Row data and zero-copy TypedArray columns share one data contract.
categoryordinal | valuequantitative | previousquantitative | targetquantitative |
|---|---|---|---|
| Reliability | 0 | 1e-09 | 1e+12 |
Browser API · Portable schema
Browser API
Graflume.gauge()
const data = [
{
"category": "Reliability",
"previous": 1e-9,
"target": 1000000000000,
"value": 0
}
];
const options = {
"accessibility": {
"description": "Service reliability compared with its target and previous value. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
"label": "Gauge"
},
"axes": {
"x": false,
"y": false
},
"height": 620,
"locale": "en",
"mark": {
"fields": {
"reference": "previous",
"target": "target"
},
"options": {
"max": 1000000000000,
"min": 0,
"mode": "angular"
}
},
"title": {
"subtitle": "edge case · range",
"text": "Gauge"
},
"width": "container",
"x": {
"field": "category",
"title": "Service metric",
"type": "ordinal"
},
"y": {
"field": "value",
"title": "Percent",
"type": "quantitative"
}
};
Graflume.gauge('#chart', data, options);Portable schema
ChartSpec 0.1 · options
{
"accessibility": {
"description": "Service reliability compared with its target and previous value. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
"label": "Gauge"
},
"axes": {
"x": false,
"y": false
},
"height": 620,
"locale": "en",
"mark": {
"fields": {
"reference": "previous",
"target": "target"
},
"options": {
"max": 1000000000000,
"min": 0,
"mode": "angular"
}
},
"title": {
"subtitle": "edge case · range",
"text": "Gauge"
},
"width": "container",
"x": {
"field": "category",
"title": "Service metric",
"type": "ordinal"
},
"y": {
"field": "value",
"title": "Percent",
"type": "quantitative"
}
}Sparse and irregular structure
Exercise only duplicate, missing, sparse, or out-of-order structures whose meaning is defined for this family. Broken references and malformed tuples are never disguised as successful examples. It applies 2 structural rules that preserve the meaning of missing, duplicate, and ordered values.
StatusLoading
irregular-structurezero-baselinedomain-boundarybudget:marks<=1
Loading
Sparse and irregular structure · Row data
Row data and zero-copy TypedArray columns share one data contract.
categoryordinal | valuequantitative | previousquantitative | targetquantitative |
|---|---|---|---|
| Reliability | 99.93 | 99.84 | 99.9 |
Browser API · Portable schema
Browser API
Graflume.gauge()
const data = [
{
"category": "Reliability",
"previous": 99.84,
"target": 99.9,
"value": 99.93
}
];
const options = {
"accessibility": {
"description": "Service reliability compared with its target and previous value. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
"label": "Gauge · Sparse and irregular structure"
},
"axes": {
"x": false,
"y": false
},
"height": 620,
"locale": "en",
"mark": {
"fields": {
"reference": "previous",
"target": "target"
},
"options": {
"max": 100,
"min": 0,
"mode": "angular"
}
},
"title": {
"subtitle": "edge case · structure",
"text": "Gauge · Sparse and irregular structure"
},
"width": "container",
"x": {
"field": "category",
"title": "Service metric",
"type": "ordinal"
},
"y": {
"field": "value",
"title": "Percent",
"type": "quantitative"
}
};
Graflume.gauge('#chart', data, options);Portable schema
ChartSpec 0.1 · options
{
"accessibility": {
"description": "Service reliability compared with its target and previous value. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
"label": "Gauge · Sparse and irregular structure"
},
"axes": {
"x": false,
"y": false
},
"height": 620,
"locale": "en",
"mark": {
"fields": {
"reference": "previous",
"target": "target"
},
"options": {
"max": 100,
"min": 0,
"mode": "angular"
}
},
"title": {
"subtitle": "edge case · structure",
"text": "Gauge · Sparse and irregular structure"
},
"width": "container",
"x": {
"field": "category",
"title": "Service metric",
"type": "ordinal"
},
"y": {
"field": "value",
"title": "Percent",
"type": "quantitative"
}
}High data volume
Materialize a deterministic compact recipe only when this tab opens. Graflume's performance profile bounds mark count, hit testing, and animation work for the input size. It applies 6 high-volume rules for deterministic generation and bounded output. This family materializes 60,000 logical events and bounds rendered bar marks at 5,000.
StatusLoading
high-row-cardinalityall-input-rows-generatedall-input-rows-processeddeterministic-generationbounded-renderinginput:60000zoom-pan-resetbudget:bar-marks<=5000
- Legend:
legend · explicit · 1 channels - Point and range highlights:
highlights[] · datum · category - Custom callouts:
annotations[] · datum · category · callout · placement:auto
Loading
Browser API · Portable schema
Browser API
Graflume.gauge()
const recipe = {
"cardinality": {
"axes": {},
"sourceRows": 60000,
"unit": "events"
},
"expectedInvariants": [
"finite-json",
"value-inside-explicit-domain"
],
"id": "categorical-events",
"initialView": {
"kind": "domain",
"zoom": 1
},
"outputBudget": {
"maximum": 5000,
"resource": "bar-marks"
},
"parameters": {
"explicitPerformance": true,
"family": "gauge",
"nullableFields": [],
"positiveFields": [],
"scenario": "volume",
"valueFields": [
"value",
"previous",
"target"
],
"valuePolicy": "bounded-domain"
},
"preview": {
"maximumRows": 12,
"method": "top-groups"
},
"reduction": {
"method": "group-sum-top-k",
"stage": "pre-aggregate"
},
"seed": 4153681792,
"shape": "rows",
"version": 2
};
const { data, previewRows, plan } = Graflume.materializeDemoRecipe(recipe);
const options = {
"accessibility": {
"description": "Zoom and pan inspect the rendered surface without changing data axes or values. When playback controls are available, they move through real steps in the order each unique value first appears in the source data.",
"label": "Gauge · High data volume"
},
"annotations": [
{
"connector": {
"visible": true
},
"detail": "Attach user-authored safe text to a datum, axis range, or normalized plot position.",
"id": "manual-callout",
"placement": "auto",
"style": {
"maxWidth": 220,
"padding": 8
},
"target": {
"field": "category",
"type": "datum",
"value": "Reliability"
},
"text": "Point and range highlights · Reliability"
}
],
"axes": {
"x": false,
"y": false
},
"create": {
"adaptive": {
"environment": {
"rowCount": 60000
},
"largeDataNavigation": true,
"profiles": "auto"
}
},
"height": 620,
"highlights": [
{
"id": "manual-focus",
"padding": 7,
"target": {
"field": "category",
"type": "datum",
"value": "Reliability"
}
}
],
"interaction": {
"controls": {
"annotations": false,
"export": true,
"fullscreen": true,
"labels": {
"controls": "Chart controls",
"enterFullscreen": "Enter fullscreen",
"exitFullscreen": "Exit fullscreen",
"exportPng": "Download PNG",
"hideAnnotations": "Hide callouts",
"loop": "Loop playback",
"nextFrame": "Next frame",
"pause": "Pause",
"play": "Play",
"previousFrame": "Previous frame",
"reset": "Reset view",
"seek": "Playback position",
"showAnnotations": "Show callouts",
"speed": "Playback speed",
"zoomIn": "Zoom in",
"zoomOut": "Zoom out"
},
"playback": false,
"reset": true,
"zoom": true
},
"hover": true,
"navigation": {
"drag": true,
"keyboard": true,
"maxZoom": 6,
"minZoom": 1,
"pinch": true,
"wheel": "modifier"
},
"tooltip": {
"fields": [
{
"field": "category",
"format": "auto",
"label": "Category"
},
{
"field": "value",
"format": "number",
"fractionDigits": 0,
"label": "Value",
"suffix": "%"
},
{
"field": "previous",
"format": "number",
"label": "Previous"
},
{
"field": "target",
"format": "number",
"label": "Target"
}
],
"title": "Gauge · High data volume",
"trigger": "mark"
}
},
"legend": {
"interactive": false,
"items": [
{
"id": "semantic-0",
"label": "Value"
}
],
"labels": {
"hide": "Hide",
"show": "Show"
},
"maxItems": 8,
"mode": "layers",
"orientation": "horizontal",
"position": "bottom",
"title": "Gauge · High data volume",
"visible": true
},
"locale": "en",
"mark": {
"fields": {
"reference": "previous",
"target": "target"
},
"options": {
"max": 100,
"min": 0,
"mode": "angular"
}
},
"padding": {
"top": 52
},
"performance": "ultra",
"theme": "graflume-light",
"title": {
"subtitle": "Service reliability compared with its target and previous value · 60,000 logical rows, screen-aware detail",
"text": "Gauge · High data volume"
},
"width": "container",
"x": {
"field": "category",
"title": "Service metric",
"type": "ordinal"
},
"y": {
"field": "value",
"title": "Percent",
"type": "quantitative"
}
};
Graflume.gauge('#chart', data, options);Portable schema
ChartSpec 0.1 · options
{
"accessibility": {
"description": "Zoom and pan inspect the rendered surface without changing data axes or values. When playback controls are available, they move through real steps in the order each unique value first appears in the source data.",
"label": "Gauge · High data volume"
},
"annotations": [
{
"connector": {
"visible": true
},
"detail": "Attach user-authored safe text to a datum, axis range, or normalized plot position.",
"id": "manual-callout",
"placement": "auto",
"style": {
"maxWidth": 220,
"padding": 8
},
"target": {
"field": "category",
"type": "datum",
"value": "Reliability"
},
"text": "Point and range highlights · Reliability"
}
],
"axes": {
"x": false,
"y": false
},
"create": {
"adaptive": {
"environment": {
"rowCount": 60000
},
"largeDataNavigation": true,
"profiles": "auto"
}
},
"height": 620,
"highlights": [
{
"id": "manual-focus",
"padding": 7,
"target": {
"field": "category",
"type": "datum",
"value": "Reliability"
}
}
],
"interaction": {
"controls": {
"annotations": false,
"export": true,
"fullscreen": true,
"labels": {
"controls": "Chart controls",
"enterFullscreen": "Enter fullscreen",
"exitFullscreen": "Exit fullscreen",
"exportPng": "Download PNG",
"hideAnnotations": "Hide callouts",
"loop": "Loop playback",
"nextFrame": "Next frame",
"pause": "Pause",
"play": "Play",
"previousFrame": "Previous frame",
"reset": "Reset view",
"seek": "Playback position",
"showAnnotations": "Show callouts",
"speed": "Playback speed",
"zoomIn": "Zoom in",
"zoomOut": "Zoom out"
},
"playback": false,
"reset": true,
"zoom": true
},
"hover": true,
"navigation": {
"drag": true,
"keyboard": true,
"maxZoom": 6,
"minZoom": 1,
"pinch": true,
"wheel": "modifier"
},
"tooltip": {
"fields": [
{
"field": "category",
"format": "auto",
"label": "Category"
},
{
"field": "value",
"format": "number",
"fractionDigits": 0,
"label": "Value",
"suffix": "%"
},
{
"field": "previous",
"format": "number",
"label": "Previous"
},
{
"field": "target",
"format": "number",
"label": "Target"
}
],
"title": "Gauge · High data volume",
"trigger": "mark"
}
},
"legend": {
"interactive": false,
"items": [
{
"id": "semantic-0",
"label": "Value"
}
],
"labels": {
"hide": "Hide",
"show": "Show"
},
"maxItems": 8,
"mode": "layers",
"orientation": "horizontal",
"position": "bottom",
"title": "Gauge · High data volume",
"visible": true
},
"locale": "en",
"mark": {
"fields": {
"reference": "previous",
"target": "target"
},
"options": {
"max": 100,
"min": 0,
"mode": "angular"
}
},
"padding": {
"top": 52
},
"performance": "ultra",
"theme": "graflume-light",
"title": {
"subtitle": "Service reliability compared with its target and previous value · 60,000 logical rows, screen-aware detail",
"text": "Gauge · High data volume"
},
"width": "container",
"x": {
"field": "category",
"title": "Service metric",
"type": "ordinal"
},
"y": {
"field": "value",
"title": "Percent",
"type": "quantitative"
}
}