Graflume · Alpha
Volume profile · Edge-case application
Aggregate volume by price bin to reveal where trading activity concentrates. 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 · Specialized families
Volume profile
Aggregate volume by price bin to reveal where trading activity concentrates.
- Quick API
volumeProfile()- Browser snapshot
graflume/complete- mark
volume-profile- Presets
- 1
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-largezeropositive-domainbudget:marks<=6
Loading
Wide numeric range · Row data
Row data and zero-copy TypedArray columns share one data contract.
datetemporal | pricequantitative | volumequantitative |
|---|---|---|
| 2026-01-01 | 5.150000000000001e-10 | 0 |
| 2026-02-01 | 9.9e-07 | 1 |
| 2026-03-01 | 1.03 | 1000 |
| 2026-04-01 | 990 | 1e+06 |
| 2026-05-01 | 1.03e+06 | 1e+09 |
| 2026-06-01 | 1.98e+09 | 1e+12 |
Browser API · Portable schema
Browser API
Graflume.volumeProfile()
const data = [
{
"close": 5.150000000000001e-10,
"date": "2026-01-01",
"high": 5.253000000000001e-10,
"low": 4.949e-10,
"open": 5.05e-10,
"price": 5.150000000000001e-10,
"value": 5.150000000000001e-10,
"volume": 0
},
{
"close": 9.9e-7,
"date": "2026-02-01",
"high": 0.0000010302,
"low": 9.702e-7,
"open": 0.0000010099999999999999,
"price": 9.9e-7,
"value": 9.9e-7,
"volume": 1
},
{
"close": 1.03,
"date": "2026-03-01",
"high": 1.0506,
"low": 0.9898,
"open": 1.01,
"price": 1.03,
"value": 1.03,
"volume": 1000
},
{
"close": 990,
"date": "2026-04-01",
"high": 1030.2,
"low": 970.1999999999999,
"open": 1010,
"price": 990,
"value": 990,
"volume": 1000000
},
{
"close": 1030000,
"date": "2026-05-01",
"high": 1050600,
"low": 989800,
"open": 1010000,
"price": 1030000,
"value": 1030000,
"volume": 1000000000
},
{
"close": 1980000000,
"date": "2026-06-01",
"high": 2060400000,
"low": 1940400000,
"open": 2020000000,
"price": 1980000000,
"value": 1980000000,
"volume": 1000000000000
}
];
const options = {
"accessibility": {
"description": "Trading activity reveals the price levels where liquidity accumulated. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
"label": "Volume profile"
},
"axes": {
"x": {
"format": {
"dateStyle": "long",
"timeZone": "UTC",
"type": "date"
}
}
},
"height": 620,
"interaction": {
"hover": true,
"tooltip": {
"axis": "y",
"fields": [
{
"dateStyle": "long",
"field": "date",
"format": "date",
"label": "Date",
"timeZone": "UTC"
},
{
"field": "priceStart",
"format": "number",
"label": "Price range start"
},
{
"field": "priceEnd",
"format": "number",
"label": "Price range end"
},
{
"field": "volume",
"format": "number",
"label": "Volume"
},
{
"field": "proportion",
"format": "percent",
"fractionDigits": 1,
"label": "Proportion"
}
],
"title": "Volume profile",
"trigger": "axis"
}
},
"locale": "en",
"mark": {
"fields": {
"price": "price",
"volume": "volume"
}
},
"title": {
"subtitle": "edge case · range",
"text": "Volume profile"
},
"width": "container",
"x": {
"field": "date",
"title": "Trading day",
"type": "temporal"
},
"y": {
"field": "price",
"title": "Price",
"type": "quantitative"
}
};
Graflume.volumeProfile('#chart', data, options);Portable schema
ChartSpec 0.1 · options
{
"accessibility": {
"description": "Trading activity reveals the price levels where liquidity accumulated. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
"label": "Volume profile"
},
"axes": {
"x": {
"format": {
"dateStyle": "long",
"timeZone": "UTC",
"type": "date"
}
}
},
"height": 620,
"interaction": {
"hover": true,
"tooltip": {
"axis": "y",
"fields": [
{
"dateStyle": "long",
"field": "date",
"format": "date",
"label": "Date",
"timeZone": "UTC"
},
{
"field": "priceStart",
"format": "number",
"label": "Price range start"
},
{
"field": "priceEnd",
"format": "number",
"label": "Price range end"
},
{
"field": "volume",
"format": "number",
"label": "Volume"
},
{
"field": "proportion",
"format": "percent",
"fractionDigits": 1,
"label": "Proportion"
}
],
"title": "Volume profile",
"trigger": "axis"
}
},
"locale": "en",
"mark": {
"fields": {
"price": "price",
"volume": "volume"
}
},
"title": {
"subtitle": "edge case · range",
"text": "Volume profile"
},
"width": "container",
"x": {
"field": "date",
"title": "Trading day",
"type": "temporal"
},
"y": {
"field": "price",
"title": "Price",
"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 3 structural rules that preserve the meaning of missing, duplicate, and ordered values.
StatusLoading
irregular-structureduplicate-keyout-of-orderzero-baselinebudget:marks<=7
Loading
Sparse and irregular structure · Row data
Row data and zero-copy TypedArray columns share one data contract.
datetemporal | pricequantitative | volumequantitative |
|---|---|---|
| 2025-01-03 | 97.4641 | 1217 |
| 2025-01-01 | 95.1 | 1070 |
| 2025-01-03 | 97.4641 | 1217 |
| 2025-01-04 | 98.1631 | 1287 |
| 2025-01-05 | 98.4747 | 1353 |
| 2025-01-06 | 98.3969 | 1415 |
| 2025-01-02 | 96.4177 | 1144 |
Browser API · Portable schema
Browser API
Graflume.volumeProfile()
const data = [
{
"date": "2025-01-03",
"price": 97.4641,
"volume": 1217
},
{
"date": "2025-01-01",
"price": 95.1,
"volume": 1070
},
{
"date": "2025-01-03",
"price": 97.4641,
"volume": 1217
},
{
"date": "2025-01-04",
"price": 98.1631,
"volume": 1287
},
{
"date": "2025-01-05",
"price": 98.4747,
"volume": 1353
},
{
"date": "2025-01-06",
"price": 98.3969,
"volume": 1415
},
{
"date": "2025-01-02",
"price": 96.4177,
"volume": 1144
}
];
const options = {
"accessibility": {
"description": "Trading activity reveals the price levels where liquidity accumulated. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
"label": "Volume profile · Sparse and irregular structure"
},
"axes": {
"x": {
"format": {
"dateStyle": "long",
"timeZone": "UTC",
"type": "date"
}
}
},
"height": 620,
"interaction": {
"hover": true,
"tooltip": {
"axis": "y",
"fields": [
{
"dateStyle": "long",
"field": "date",
"format": "date",
"label": "Date",
"timeZone": "UTC"
},
{
"field": "priceStart",
"format": "number",
"label": "Price range start"
},
{
"field": "priceEnd",
"format": "number",
"label": "Price range end"
},
{
"field": "volume",
"format": "number",
"label": "Volume"
},
{
"field": "proportion",
"format": "percent",
"fractionDigits": 1,
"label": "Proportion"
}
],
"title": "Volume profile · Sparse and irregular structure",
"trigger": "axis"
}
},
"locale": "en",
"mark": {
"fields": {
"price": "price",
"volume": "volume"
}
},
"title": {
"subtitle": "edge case · structure",
"text": "Volume profile · Sparse and irregular structure"
},
"width": "container",
"x": {
"field": "date",
"title": "Trading day",
"type": "temporal"
},
"y": {
"field": "price",
"title": "Price",
"type": "quantitative"
}
};
Graflume.volumeProfile('#chart', data, options);Portable schema
ChartSpec 0.1 · options
{
"accessibility": {
"description": "Trading activity reveals the price levels where liquidity accumulated. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
"label": "Volume profile · Sparse and irregular structure"
},
"axes": {
"x": {
"format": {
"dateStyle": "long",
"timeZone": "UTC",
"type": "date"
}
}
},
"height": 620,
"interaction": {
"hover": true,
"tooltip": {
"axis": "y",
"fields": [
{
"dateStyle": "long",
"field": "date",
"format": "date",
"label": "Date",
"timeZone": "UTC"
},
{
"field": "priceStart",
"format": "number",
"label": "Price range start"
},
{
"field": "priceEnd",
"format": "number",
"label": "Price range end"
},
{
"field": "volume",
"format": "number",
"label": "Volume"
},
{
"field": "proportion",
"format": "percent",
"fractionDigits": 1,
"label": "Proportion"
}
],
"title": "Volume profile · Sparse and irregular structure",
"trigger": "axis"
}
},
"locale": "en",
"mark": {
"fields": {
"price": "price",
"volume": "volume"
}
},
"title": {
"subtitle": "edge case · structure",
"text": "Volume profile · Sparse and irregular structure"
},
"width": "container",
"x": {
"field": "date",
"title": "Trading day",
"type": "temporal"
},
"y": {
"field": "price",
"title": "Price",
"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 100,000 logical rows and bounds rendered bar marks at 5,000.
StatusLoading
high-row-cardinalityall-input-rows-generatedall-input-rows-processeddeterministic-generationbounded-renderinginput:100000zoom-pan-resetbudget:bar-marks<=5000
- Legend:
legend · explicit · 1 channels - Point and range highlights:
highlights[] · datum · date - Custom callouts:
annotations[] · datum · date · callout · placement:auto
Loading
Browser API · Portable schema
Browser API
Graflume.volumeProfile()
const recipe = {
"cardinality": {
"axes": {},
"sourceRows": 100000,
"unit": "rows"
},
"expectedInvariants": [
"finite-json",
"price-positive",
"volume-nonnegative"
],
"id": "ohlcv-sequence",
"initialView": {
"kind": "domain",
"zoom": 1
},
"outputBudget": {
"maximum": 5000,
"resource": "bar-marks"
},
"parameters": {
"explicitPerformance": true,
"family": "volume-profile",
"nullableFields": [],
"positiveFields": [
"volume"
],
"scenario": "volume",
"valueFields": [
"price"
],
"valuePolicy": "price-volume"
},
"preview": {
"maximumRows": 12,
"method": "quantiles"
},
"reduction": {
"method": "ohlcv-time-bins",
"stage": "bin"
},
"seed": 261648477,
"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": "Volume profile · 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": "date",
"type": "datum",
"value": "2025-06-24"
},
"text": "Point and range highlights · 2025-06-24"
}
],
"axes": {
"x": {
"format": {
"dateStyle": "long",
"timeZone": "UTC",
"type": "date"
}
}
},
"create": {
"adaptive": {
"environment": {
"rowCount": 100000
},
"largeDataNavigation": true,
"profiles": "auto"
}
},
"height": 620,
"highlights": [
{
"id": "manual-focus",
"padding": 7,
"target": {
"field": "date",
"type": "datum",
"value": "2025-06-24"
}
}
],
"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": {
"axis": "y",
"fields": [
{
"dateStyle": "long",
"field": "date",
"format": "date",
"label": "Date",
"timeZone": "UTC"
},
{
"field": "priceStart",
"format": "number",
"label": "Price range start"
},
{
"field": "priceEnd",
"format": "number",
"label": "Price range end"
},
{
"field": "volume",
"format": "number",
"label": "Volume"
},
{
"field": "proportion",
"format": "percent",
"fractionDigits": 1,
"label": "Proportion"
}
],
"title": "Volume profile · High data volume",
"trigger": "axis"
}
},
"legend": {
"interactive": false,
"items": [
{
"id": "semantic-0",
"label": "Volume · width"
}
],
"labels": {
"hide": "Hide",
"show": "Show"
},
"maxItems": 8,
"mode": "layers",
"orientation": "horizontal",
"position": "bottom",
"title": "Volume profile · High data volume",
"visible": true
},
"locale": "en",
"mark": {
"fields": {
"price": "price",
"volume": "volume"
}
},
"padding": {
"top": 52
},
"performance": "ultra",
"theme": "graflume-light",
"title": {
"subtitle": "Trading activity reveals the price levels where liquidity accumulated · 100,000 logical rows, screen-aware detail",
"text": "Volume profile · High data volume"
},
"width": "container",
"x": {
"field": "date",
"title": "Trading day",
"type": "temporal"
},
"y": {
"field": "price",
"title": "Price",
"type": "quantitative"
}
};
Graflume.volumeProfile('#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": "Volume profile · 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": "date",
"type": "datum",
"value": "2025-06-24"
},
"text": "Point and range highlights · 2025-06-24"
}
],
"axes": {
"x": {
"format": {
"dateStyle": "long",
"timeZone": "UTC",
"type": "date"
}
}
},
"create": {
"adaptive": {
"environment": {
"rowCount": 100000
},
"largeDataNavigation": true,
"profiles": "auto"
}
},
"height": 620,
"highlights": [
{
"id": "manual-focus",
"padding": 7,
"target": {
"field": "date",
"type": "datum",
"value": "2025-06-24"
}
}
],
"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": {
"axis": "y",
"fields": [
{
"dateStyle": "long",
"field": "date",
"format": "date",
"label": "Date",
"timeZone": "UTC"
},
{
"field": "priceStart",
"format": "number",
"label": "Price range start"
},
{
"field": "priceEnd",
"format": "number",
"label": "Price range end"
},
{
"field": "volume",
"format": "number",
"label": "Volume"
},
{
"field": "proportion",
"format": "percent",
"fractionDigits": 1,
"label": "Proportion"
}
],
"title": "Volume profile · High data volume",
"trigger": "axis"
}
},
"legend": {
"interactive": false,
"items": [
{
"id": "semantic-0",
"label": "Volume · width"
}
],
"labels": {
"hide": "Hide",
"show": "Show"
},
"maxItems": 8,
"mode": "layers",
"orientation": "horizontal",
"position": "bottom",
"title": "Volume profile · High data volume",
"visible": true
},
"locale": "en",
"mark": {
"fields": {
"price": "price",
"volume": "volume"
}
},
"padding": {
"top": 52
},
"performance": "ultra",
"theme": "graflume-light",
"title": {
"subtitle": "Trading activity reveals the price levels where liquidity accumulated · 100,000 logical rows, screen-aware detail",
"text": "Volume profile · High data volume"
},
"width": "container",
"x": {
"field": "date",
"title": "Trading day",
"type": "temporal"
},
"y": {
"field": "price",
"title": "Price",
"type": "quantitative"
}
}