@urban-toolkit/autk-grammar 5.1.0 → 5.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +89 -1
- package/build/autk-grammar-schema.json +654 -1
- package/dist/autk-grammar.js +737 -617
- package/dist/autk-grammar.js.map +1 -1
- package/dist/autk-grammar.umd.cjs +2 -2
- package/dist/autk-grammar.umd.cjs.map +1 -1
- package/dist/data/autk-grammar-data.cjs +1 -1
- package/dist/data/autk-grammar-data.cjs.map +1 -1
- package/dist/data/autk-grammar-data.js +85 -81
- package/dist/data/autk-grammar-data.js.map +1 -1
- package/dist/index.d.ts +117 -3
- package/package.json +1 -1
|
@@ -48,9 +48,50 @@
|
|
|
48
48
|
"minItems": 1,
|
|
49
49
|
"type": "array"
|
|
50
50
|
},
|
|
51
|
+
"axisLabels": {
|
|
52
|
+
"description": "Titles of the plot's axes, in the order of `axis`, in place of the column names: the x and y axes' titles of a scatter plot, a bar chart, a line chart and a heat matrix, each axis's title of parallel coordinates, and a table's column headers. An axis without a title keeps its column's name, and an axis that holds a transform's output, `@transform`, is titled `value`. A run refuses more titles than `axis` has columns, and two titles alike, since a table finds the column to sort by its header. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
53
|
+
"items": {
|
|
54
|
+
"type": "string"
|
|
55
|
+
},
|
|
56
|
+
"type": "array",
|
|
57
|
+
"uniqueItems": true
|
|
58
|
+
},
|
|
59
|
+
"categoricalColorMapInterpolator": {
|
|
60
|
+
"$ref": "#/definitions/CategoricalColorMapInterpolator",
|
|
61
|
+
"description": "Color scheme of marks colored by categories: a categorical `scheme*` scheme, `schemeObservable10` by default. The categories take the scheme's colors in the order they first appear, or in `colorMapDomain`'s order, and those past the scheme's last color take that one. A sequential or diverging `interpolate*` name is refused. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
62
|
+
},
|
|
51
63
|
"color": {
|
|
64
|
+
"description": "Column whose values color the marks: a scatter plot's points, a bar chart's bars, and the lines of parallel coordinates, which a click on an axis's title colors by that axis instead. When every value is a number, or a string that reads as one, the marks take `colorMapInterpolator`'s scheme; otherwise the values are categories, and take `categoricalColorMapInterpolator`'s. A heat matrix colors its cells by their values, which `@transform` names. Line charts and tables color no mark by value.",
|
|
52
65
|
"type": "string"
|
|
53
66
|
},
|
|
67
|
+
"colorMapDomain": {
|
|
68
|
+
"description": "Categories the plot is colored over, in order: the first takes the categorical scheme's first color, and so on. The values are read as categories, numbers too, and a mark whose value is not among them is drawn in the mark color. It cannot be set with `colorMapRange`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
69
|
+
"items": {
|
|
70
|
+
"type": "string"
|
|
71
|
+
},
|
|
72
|
+
"type": "array"
|
|
73
|
+
},
|
|
74
|
+
"colorMapInterpolator": {
|
|
75
|
+
"$ref": "#/definitions/ContinuousColorMapInterpolator",
|
|
76
|
+
"description": "Color scheme of marks colored by numbers: a sequential or diverging `interpolate*` scheme, `interpolateReds` by default. The scale's low end takes the scheme's first color and its high end its last: the lowest and highest values, unless `colorMapRange` or `normalization` sets them. A categorical `scheme*` name is refused, since categories take `categoricalColorMapInterpolator`. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
77
|
+
},
|
|
78
|
+
"colorMapRange": {
|
|
79
|
+
"description": "Ends of the color scale of numbers, as `[low, high]` with low less than high. The plot is colored over this range instead of its lowest and highest values, so plots and map layers that set the same range color the same value alike. Values that are categories ignore it, as a layer with a categorical scheme does, and it cannot be set with `colorMapDomain`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
80
|
+
"items": [
|
|
81
|
+
{
|
|
82
|
+
"title": "low",
|
|
83
|
+
"type": "number"
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
"title": "high",
|
|
87
|
+
"type": "number"
|
|
88
|
+
}
|
|
89
|
+
],
|
|
90
|
+
"maxItems": 2,
|
|
91
|
+
"minItems": 2,
|
|
92
|
+
"type": "array",
|
|
93
|
+
"uniqueItems": true
|
|
94
|
+
},
|
|
54
95
|
"dataRef": {
|
|
55
96
|
"description": "Name of the table to plot.",
|
|
56
97
|
"type": "string"
|
|
@@ -65,6 +106,10 @@
|
|
|
65
106
|
"height": {
|
|
66
107
|
"type": "number"
|
|
67
108
|
},
|
|
109
|
+
"highlightColor": {
|
|
110
|
+
"$ref": "#/definitions/HexColor",
|
|
111
|
+
"description": "Color of the selected marks, and of a table's selected rows, as `#rrggbb`: `#5dade2` by default. autk-plot keeps one highlight color for the page, so every plot it draws there takes it: a run refuses two plots that set different ones, and a run whose plots set none gives back autk-plot's. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
112
|
+
},
|
|
68
113
|
"id": {
|
|
69
114
|
"description": "Name of the plot, which a link in `links` uses as its `source`. Unique among the ids of the maps and plots. Without it a plot is known by its `dataRef`, so two plots of one table need ids: a run refuses two plots known by one name.",
|
|
70
115
|
"minLength": 1,
|
|
@@ -101,6 +146,28 @@
|
|
|
101
146
|
"const": "bar",
|
|
102
147
|
"type": "string"
|
|
103
148
|
},
|
|
149
|
+
"markColor": {
|
|
150
|
+
"$ref": "#/definitions/HexColor",
|
|
151
|
+
"description": "Color of the marks that are neither colored by value nor selected, as `#rrggbb`: `#bfbfbf` by default. autk-plot keeps one mark color for the page, so every plot it draws there takes it: a run refuses two plots that set different ones, and a run whose plots set none gives back autk-plot's. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
152
|
+
},
|
|
153
|
+
"normalization": {
|
|
154
|
+
"description": "How the ends of the color scale of numbers are found: `minMax`, the default, takes the lowest and highest values; `percentile` takes the values at the `lowerPercentile` and `upperPercentile` percentiles, 2 and 98 when it gives neither, else 0 and 100 for the one it leaves out. Categories ignore it. A map layer's `normalization` reads the same way. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
155
|
+
"properties": {
|
|
156
|
+
"lowerPercentile": {
|
|
157
|
+
"type": "number"
|
|
158
|
+
},
|
|
159
|
+
"mode": {
|
|
160
|
+
"$ref": "#/definitions/NormalizationMode"
|
|
161
|
+
},
|
|
162
|
+
"upperPercentile": {
|
|
163
|
+
"type": "number"
|
|
164
|
+
}
|
|
165
|
+
},
|
|
166
|
+
"required": [
|
|
167
|
+
"mode"
|
|
168
|
+
],
|
|
169
|
+
"type": "object"
|
|
170
|
+
},
|
|
104
171
|
"osmElements": {
|
|
105
172
|
"description": "Plot an OpenStreetMap layer table as one row per OSM element it was built from, each with the element's tags, `osm_type` and `osm_id` (and `building_id` in a buildings table), rather than one row per table row. A table that is not an OSM layer, a surface, and an OSM table an update changed are plotted row by row, as without it. Read by the Autark adapter only.",
|
|
106
173
|
"type": "boolean"
|
|
@@ -113,6 +180,36 @@
|
|
|
113
180
|
"minItems": 1,
|
|
114
181
|
"type": "array"
|
|
115
182
|
},
|
|
183
|
+
"selection": {
|
|
184
|
+
"description": "Rows selected when the plot is drawn, by their positions among the rows it draws, as `plot:selection` events and `setPlotSelection` name them. The plot draws them in its highlight color (a binned plot, the bins that hold them), and the map layers it is linked to, by `mapRef` or `links`, highlight the same rows, as after `setPlotSelection`. No `plot:selection` event reports it. A run refuses a position past the plot's last row. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
185
|
+
"items": {
|
|
186
|
+
"description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
|
|
187
|
+
"minimum": 0,
|
|
188
|
+
"multipleOf": 1,
|
|
189
|
+
"type": "number"
|
|
190
|
+
},
|
|
191
|
+
"type": "array"
|
|
192
|
+
},
|
|
193
|
+
"tickFormats": {
|
|
194
|
+
"description": "d3-format specifiers of the tick labels of the plot's axes, `[x, y]`: a scatter plot's x and y axes; a bar or line chart's x axis, for labels that read as numbers, and its y axis; and every axis of numbers of parallel coordinates, which read only the first. Heat matrices and tables ignore it. Without it, `['~s', '~s']`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
195
|
+
"items": [
|
|
196
|
+
{
|
|
197
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
198
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
199
|
+
"title": "x",
|
|
200
|
+
"type": "string"
|
|
201
|
+
},
|
|
202
|
+
{
|
|
203
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
204
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
205
|
+
"title": "y",
|
|
206
|
+
"type": "string"
|
|
207
|
+
}
|
|
208
|
+
],
|
|
209
|
+
"maxItems": 2,
|
|
210
|
+
"minItems": 2,
|
|
211
|
+
"type": "array"
|
|
212
|
+
},
|
|
116
213
|
"title": {
|
|
117
214
|
"type": "string"
|
|
118
215
|
},
|
|
@@ -180,6 +277,23 @@
|
|
|
180
277
|
},
|
|
181
278
|
"type": "object"
|
|
182
279
|
},
|
|
280
|
+
"CategoricalColorMapInterpolator": {
|
|
281
|
+
"description": "A categorical color scheme: a `scheme*` name, one color for each category.",
|
|
282
|
+
"enum": [
|
|
283
|
+
"schemeAccent",
|
|
284
|
+
"schemeDark2",
|
|
285
|
+
"schemeCategory10",
|
|
286
|
+
"schemeObservable10",
|
|
287
|
+
"schemePaired",
|
|
288
|
+
"schemePastel1",
|
|
289
|
+
"schemePastel2",
|
|
290
|
+
"schemeSet1",
|
|
291
|
+
"schemeSet2",
|
|
292
|
+
"schemeSet3",
|
|
293
|
+
"schemeTableau10"
|
|
294
|
+
],
|
|
295
|
+
"type": "string"
|
|
296
|
+
},
|
|
183
297
|
"ColorMapInterpolator": {
|
|
184
298
|
"description": "Color scheme for a colored map layer: `scheme*` names are categorical, `interpolate*` names are sequential or diverging.",
|
|
185
299
|
"enum": [
|
|
@@ -244,6 +358,48 @@
|
|
|
244
358
|
],
|
|
245
359
|
"description": "One entry of `compute`. A pass with `type: 'render'` is a {@link RenderComputeSpec } , any other a {@link GpgpuComputeSpec } ."
|
|
246
360
|
},
|
|
361
|
+
"ContinuousColorMapInterpolator": {
|
|
362
|
+
"description": "A sequential or diverging color scheme: an `interpolate*` name, a color for each number of a scale.",
|
|
363
|
+
"enum": [
|
|
364
|
+
"interpolateReds",
|
|
365
|
+
"interpolateBlues",
|
|
366
|
+
"interpolateGreens",
|
|
367
|
+
"interpolateGreys",
|
|
368
|
+
"interpolateOranges",
|
|
369
|
+
"interpolatePurples",
|
|
370
|
+
"interpolateTurbo",
|
|
371
|
+
"interpolateViridis",
|
|
372
|
+
"interpolateInferno",
|
|
373
|
+
"interpolateMagma",
|
|
374
|
+
"interpolatePlasma",
|
|
375
|
+
"interpolateCividis",
|
|
376
|
+
"interpolateWarm",
|
|
377
|
+
"interpolateCool",
|
|
378
|
+
"interpolateCubehelixDefault",
|
|
379
|
+
"interpolateBuGn",
|
|
380
|
+
"interpolateBuPu",
|
|
381
|
+
"interpolateGnBu",
|
|
382
|
+
"interpolateOrRd",
|
|
383
|
+
"interpolatePuBuGn",
|
|
384
|
+
"interpolatePuBu",
|
|
385
|
+
"interpolatePuRd",
|
|
386
|
+
"interpolateRdPu",
|
|
387
|
+
"interpolateYlGnBu",
|
|
388
|
+
"interpolateYlGn",
|
|
389
|
+
"interpolateYlOrBr",
|
|
390
|
+
"interpolateYlOrRd",
|
|
391
|
+
"interpolateBrBG",
|
|
392
|
+
"interpolatePRGn",
|
|
393
|
+
"interpolatePiYG",
|
|
394
|
+
"interpolatePuOr",
|
|
395
|
+
"interpolateRdBu",
|
|
396
|
+
"interpolateRdGy",
|
|
397
|
+
"interpolateRdYlBu",
|
|
398
|
+
"interpolateRdYlGn",
|
|
399
|
+
"interpolateSpectral"
|
|
400
|
+
],
|
|
401
|
+
"type": "string"
|
|
402
|
+
},
|
|
247
403
|
"CsvDataSourceSpec": {
|
|
248
404
|
"description": "Loads a CSV table from exactly one of `csvFileUrl` or `csvObject`.",
|
|
249
405
|
"else": {
|
|
@@ -568,7 +724,7 @@
|
|
|
568
724
|
"type": "string"
|
|
569
725
|
},
|
|
570
726
|
"layer": {
|
|
571
|
-
"description": "Table to read from.",
|
|
727
|
+
"description": "Table to read from. The Autark adapter reads it as an earlier compute pass wrote it; else, when a GeoJSON source loaded it with its coordinates in its workspace's CRS, as the source gave its features, each building part with its own outline; else as autk-db keeps it, a buildings table's geometry inside a GeometryCollection.",
|
|
572
728
|
"type": "string"
|
|
573
729
|
},
|
|
574
730
|
"path": {
|
|
@@ -1126,9 +1282,50 @@
|
|
|
1126
1282
|
"minItems": 1,
|
|
1127
1283
|
"type": "array"
|
|
1128
1284
|
},
|
|
1285
|
+
"axisLabels": {
|
|
1286
|
+
"description": "Titles of the plot's axes, in the order of `axis`, in place of the column names: the x and y axes' titles of a scatter plot, a bar chart, a line chart and a heat matrix, each axis's title of parallel coordinates, and a table's column headers. An axis without a title keeps its column's name, and an axis that holds a transform's output, `@transform`, is titled `value`. A run refuses more titles than `axis` has columns, and two titles alike, since a table finds the column to sort by its header. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1287
|
+
"items": {
|
|
1288
|
+
"type": "string"
|
|
1289
|
+
},
|
|
1290
|
+
"type": "array",
|
|
1291
|
+
"uniqueItems": true
|
|
1292
|
+
},
|
|
1293
|
+
"categoricalColorMapInterpolator": {
|
|
1294
|
+
"$ref": "#/definitions/CategoricalColorMapInterpolator",
|
|
1295
|
+
"description": "Color scheme of marks colored by categories: a categorical `scheme*` scheme, `schemeObservable10` by default. The categories take the scheme's colors in the order they first appear, or in `colorMapDomain`'s order, and those past the scheme's last color take that one. A sequential or diverging `interpolate*` name is refused. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
1296
|
+
},
|
|
1129
1297
|
"color": {
|
|
1298
|
+
"description": "Column whose values color the marks: a scatter plot's points, a bar chart's bars, and the lines of parallel coordinates, which a click on an axis's title colors by that axis instead. When every value is a number, or a string that reads as one, the marks take `colorMapInterpolator`'s scheme; otherwise the values are categories, and take `categoricalColorMapInterpolator`'s. A heat matrix colors its cells by their values, which `@transform` names. Line charts and tables color no mark by value.",
|
|
1130
1299
|
"type": "string"
|
|
1131
1300
|
},
|
|
1301
|
+
"colorMapDomain": {
|
|
1302
|
+
"description": "Categories the plot is colored over, in order: the first takes the categorical scheme's first color, and so on. The values are read as categories, numbers too, and a mark whose value is not among them is drawn in the mark color. It cannot be set with `colorMapRange`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1303
|
+
"items": {
|
|
1304
|
+
"type": "string"
|
|
1305
|
+
},
|
|
1306
|
+
"type": "array"
|
|
1307
|
+
},
|
|
1308
|
+
"colorMapInterpolator": {
|
|
1309
|
+
"$ref": "#/definitions/ContinuousColorMapInterpolator",
|
|
1310
|
+
"description": "Color scheme of marks colored by numbers: a sequential or diverging `interpolate*` scheme, `interpolateReds` by default. The scale's low end takes the scheme's first color and its high end its last: the lowest and highest values, unless `colorMapRange` or `normalization` sets them. A categorical `scheme*` name is refused, since categories take `categoricalColorMapInterpolator`. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
1311
|
+
},
|
|
1312
|
+
"colorMapRange": {
|
|
1313
|
+
"description": "Ends of the color scale of numbers, as `[low, high]` with low less than high. The plot is colored over this range instead of its lowest and highest values, so plots and map layers that set the same range color the same value alike. Values that are categories ignore it, as a layer with a categorical scheme does, and it cannot be set with `colorMapDomain`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1314
|
+
"items": [
|
|
1315
|
+
{
|
|
1316
|
+
"title": "low",
|
|
1317
|
+
"type": "number"
|
|
1318
|
+
},
|
|
1319
|
+
{
|
|
1320
|
+
"title": "high",
|
|
1321
|
+
"type": "number"
|
|
1322
|
+
}
|
|
1323
|
+
],
|
|
1324
|
+
"maxItems": 2,
|
|
1325
|
+
"minItems": 2,
|
|
1326
|
+
"type": "array",
|
|
1327
|
+
"uniqueItems": true
|
|
1328
|
+
},
|
|
1132
1329
|
"dataRef": {
|
|
1133
1330
|
"description": "Name of the table to plot.",
|
|
1134
1331
|
"type": "string"
|
|
@@ -1143,6 +1340,10 @@
|
|
|
1143
1340
|
"height": {
|
|
1144
1341
|
"type": "number"
|
|
1145
1342
|
},
|
|
1343
|
+
"highlightColor": {
|
|
1344
|
+
"$ref": "#/definitions/HexColor",
|
|
1345
|
+
"description": "Color of the selected marks, and of a table's selected rows, as `#rrggbb`: `#5dade2` by default. autk-plot keeps one highlight color for the page, so every plot it draws there takes it: a run refuses two plots that set different ones, and a run whose plots set none gives back autk-plot's. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
1346
|
+
},
|
|
1146
1347
|
"id": {
|
|
1147
1348
|
"description": "Name of the plot, which a link in `links` uses as its `source`. Unique among the ids of the maps and plots. Without it a plot is known by its `dataRef`, so two plots of one table need ids: a run refuses two plots known by one name.",
|
|
1148
1349
|
"minLength": 1,
|
|
@@ -1179,6 +1380,28 @@
|
|
|
1179
1380
|
"const": "heatmatrix",
|
|
1180
1381
|
"type": "string"
|
|
1181
1382
|
},
|
|
1383
|
+
"markColor": {
|
|
1384
|
+
"$ref": "#/definitions/HexColor",
|
|
1385
|
+
"description": "Color of the marks that are neither colored by value nor selected, as `#rrggbb`: `#bfbfbf` by default. autk-plot keeps one mark color for the page, so every plot it draws there takes it: a run refuses two plots that set different ones, and a run whose plots set none gives back autk-plot's. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
1386
|
+
},
|
|
1387
|
+
"normalization": {
|
|
1388
|
+
"description": "How the ends of the color scale of numbers are found: `minMax`, the default, takes the lowest and highest values; `percentile` takes the values at the `lowerPercentile` and `upperPercentile` percentiles, 2 and 98 when it gives neither, else 0 and 100 for the one it leaves out. Categories ignore it. A map layer's `normalization` reads the same way. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1389
|
+
"properties": {
|
|
1390
|
+
"lowerPercentile": {
|
|
1391
|
+
"type": "number"
|
|
1392
|
+
},
|
|
1393
|
+
"mode": {
|
|
1394
|
+
"$ref": "#/definitions/NormalizationMode"
|
|
1395
|
+
},
|
|
1396
|
+
"upperPercentile": {
|
|
1397
|
+
"type": "number"
|
|
1398
|
+
}
|
|
1399
|
+
},
|
|
1400
|
+
"required": [
|
|
1401
|
+
"mode"
|
|
1402
|
+
],
|
|
1403
|
+
"type": "object"
|
|
1404
|
+
},
|
|
1182
1405
|
"osmElements": {
|
|
1183
1406
|
"description": "Plot an OpenStreetMap layer table as one row per OSM element it was built from, each with the element's tags, `osm_type` and `osm_id` (and `building_id` in a buildings table), rather than one row per table row. A table that is not an OSM layer, a surface, and an OSM table an update changed are plotted row by row, as without it. Read by the Autark adapter only.",
|
|
1184
1407
|
"type": "boolean"
|
|
@@ -1191,6 +1414,36 @@
|
|
|
1191
1414
|
"minItems": 1,
|
|
1192
1415
|
"type": "array"
|
|
1193
1416
|
},
|
|
1417
|
+
"selection": {
|
|
1418
|
+
"description": "Rows selected when the plot is drawn, by their positions among the rows it draws, as `plot:selection` events and `setPlotSelection` name them. The plot draws them in its highlight color (a binned plot, the bins that hold them), and the map layers it is linked to, by `mapRef` or `links`, highlight the same rows, as after `setPlotSelection`. No `plot:selection` event reports it. A run refuses a position past the plot's last row. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1419
|
+
"items": {
|
|
1420
|
+
"description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
|
|
1421
|
+
"minimum": 0,
|
|
1422
|
+
"multipleOf": 1,
|
|
1423
|
+
"type": "number"
|
|
1424
|
+
},
|
|
1425
|
+
"type": "array"
|
|
1426
|
+
},
|
|
1427
|
+
"tickFormats": {
|
|
1428
|
+
"description": "d3-format specifiers of the tick labels of the plot's axes, `[x, y]`: a scatter plot's x and y axes; a bar or line chart's x axis, for labels that read as numbers, and its y axis; and every axis of numbers of parallel coordinates, which read only the first. Heat matrices and tables ignore it. Without it, `['~s', '~s']`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1429
|
+
"items": [
|
|
1430
|
+
{
|
|
1431
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
1432
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
1433
|
+
"title": "x",
|
|
1434
|
+
"type": "string"
|
|
1435
|
+
},
|
|
1436
|
+
{
|
|
1437
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
1438
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
1439
|
+
"title": "y",
|
|
1440
|
+
"type": "string"
|
|
1441
|
+
}
|
|
1442
|
+
],
|
|
1443
|
+
"maxItems": 2,
|
|
1444
|
+
"minItems": 2,
|
|
1445
|
+
"type": "array"
|
|
1446
|
+
},
|
|
1194
1447
|
"title": {
|
|
1195
1448
|
"type": "string"
|
|
1196
1449
|
},
|
|
@@ -1464,9 +1717,50 @@
|
|
|
1464
1717
|
"minItems": 1,
|
|
1465
1718
|
"type": "array"
|
|
1466
1719
|
},
|
|
1720
|
+
"axisLabels": {
|
|
1721
|
+
"description": "Titles of the plot's axes, in the order of `axis`, in place of the column names: the x and y axes' titles of a scatter plot, a bar chart, a line chart and a heat matrix, each axis's title of parallel coordinates, and a table's column headers. An axis without a title keeps its column's name, and an axis that holds a transform's output, `@transform`, is titled `value`. A run refuses more titles than `axis` has columns, and two titles alike, since a table finds the column to sort by its header. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1722
|
+
"items": {
|
|
1723
|
+
"type": "string"
|
|
1724
|
+
},
|
|
1725
|
+
"type": "array",
|
|
1726
|
+
"uniqueItems": true
|
|
1727
|
+
},
|
|
1728
|
+
"categoricalColorMapInterpolator": {
|
|
1729
|
+
"$ref": "#/definitions/CategoricalColorMapInterpolator",
|
|
1730
|
+
"description": "Color scheme of marks colored by categories: a categorical `scheme*` scheme, `schemeObservable10` by default. The categories take the scheme's colors in the order they first appear, or in `colorMapDomain`'s order, and those past the scheme's last color take that one. A sequential or diverging `interpolate*` name is refused. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
1731
|
+
},
|
|
1467
1732
|
"color": {
|
|
1733
|
+
"description": "Column whose values color the marks: a scatter plot's points, a bar chart's bars, and the lines of parallel coordinates, which a click on an axis's title colors by that axis instead. When every value is a number, or a string that reads as one, the marks take `colorMapInterpolator`'s scheme; otherwise the values are categories, and take `categoricalColorMapInterpolator`'s. A heat matrix colors its cells by their values, which `@transform` names. Line charts and tables color no mark by value.",
|
|
1468
1734
|
"type": "string"
|
|
1469
1735
|
},
|
|
1736
|
+
"colorMapDomain": {
|
|
1737
|
+
"description": "Categories the plot is colored over, in order: the first takes the categorical scheme's first color, and so on. The values are read as categories, numbers too, and a mark whose value is not among them is drawn in the mark color. It cannot be set with `colorMapRange`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1738
|
+
"items": {
|
|
1739
|
+
"type": "string"
|
|
1740
|
+
},
|
|
1741
|
+
"type": "array"
|
|
1742
|
+
},
|
|
1743
|
+
"colorMapInterpolator": {
|
|
1744
|
+
"$ref": "#/definitions/ContinuousColorMapInterpolator",
|
|
1745
|
+
"description": "Color scheme of marks colored by numbers: a sequential or diverging `interpolate*` scheme, `interpolateReds` by default. The scale's low end takes the scheme's first color and its high end its last: the lowest and highest values, unless `colorMapRange` or `normalization` sets them. A categorical `scheme*` name is refused, since categories take `categoricalColorMapInterpolator`. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
1746
|
+
},
|
|
1747
|
+
"colorMapRange": {
|
|
1748
|
+
"description": "Ends of the color scale of numbers, as `[low, high]` with low less than high. The plot is colored over this range instead of its lowest and highest values, so plots and map layers that set the same range color the same value alike. Values that are categories ignore it, as a layer with a categorical scheme does, and it cannot be set with `colorMapDomain`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1749
|
+
"items": [
|
|
1750
|
+
{
|
|
1751
|
+
"title": "low",
|
|
1752
|
+
"type": "number"
|
|
1753
|
+
},
|
|
1754
|
+
{
|
|
1755
|
+
"title": "high",
|
|
1756
|
+
"type": "number"
|
|
1757
|
+
}
|
|
1758
|
+
],
|
|
1759
|
+
"maxItems": 2,
|
|
1760
|
+
"minItems": 2,
|
|
1761
|
+
"type": "array",
|
|
1762
|
+
"uniqueItems": true
|
|
1763
|
+
},
|
|
1470
1764
|
"dataRef": {
|
|
1471
1765
|
"description": "Name of the table to plot.",
|
|
1472
1766
|
"type": "string"
|
|
@@ -1481,6 +1775,10 @@
|
|
|
1481
1775
|
"height": {
|
|
1482
1776
|
"type": "number"
|
|
1483
1777
|
},
|
|
1778
|
+
"highlightColor": {
|
|
1779
|
+
"$ref": "#/definitions/HexColor",
|
|
1780
|
+
"description": "Color of the selected marks, and of a table's selected rows, as `#rrggbb`: `#5dade2` by default. autk-plot keeps one highlight color for the page, so every plot it draws there takes it: a run refuses two plots that set different ones, and a run whose plots set none gives back autk-plot's. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
1781
|
+
},
|
|
1484
1782
|
"id": {
|
|
1485
1783
|
"description": "Name of the plot, which a link in `links` uses as its `source`. Unique among the ids of the maps and plots. Without it a plot is known by its `dataRef`, so two plots of one table need ids: a run refuses two plots known by one name.",
|
|
1486
1784
|
"minLength": 1,
|
|
@@ -1520,6 +1818,28 @@
|
|
|
1520
1818
|
],
|
|
1521
1819
|
"type": "string"
|
|
1522
1820
|
},
|
|
1821
|
+
"markColor": {
|
|
1822
|
+
"$ref": "#/definitions/HexColor",
|
|
1823
|
+
"description": "Color of the marks that are neither colored by value nor selected, as `#rrggbb`: `#bfbfbf` by default. autk-plot keeps one mark color for the page, so every plot it draws there takes it: a run refuses two plots that set different ones, and a run whose plots set none gives back autk-plot's. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
1824
|
+
},
|
|
1825
|
+
"normalization": {
|
|
1826
|
+
"description": "How the ends of the color scale of numbers are found: `minMax`, the default, takes the lowest and highest values; `percentile` takes the values at the `lowerPercentile` and `upperPercentile` percentiles, 2 and 98 when it gives neither, else 0 and 100 for the one it leaves out. Categories ignore it. A map layer's `normalization` reads the same way. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1827
|
+
"properties": {
|
|
1828
|
+
"lowerPercentile": {
|
|
1829
|
+
"type": "number"
|
|
1830
|
+
},
|
|
1831
|
+
"mode": {
|
|
1832
|
+
"$ref": "#/definitions/NormalizationMode"
|
|
1833
|
+
},
|
|
1834
|
+
"upperPercentile": {
|
|
1835
|
+
"type": "number"
|
|
1836
|
+
}
|
|
1837
|
+
},
|
|
1838
|
+
"required": [
|
|
1839
|
+
"mode"
|
|
1840
|
+
],
|
|
1841
|
+
"type": "object"
|
|
1842
|
+
},
|
|
1523
1843
|
"osmElements": {
|
|
1524
1844
|
"description": "Plot an OpenStreetMap layer table as one row per OSM element it was built from, each with the element's tags, `osm_type` and `osm_id` (and `building_id` in a buildings table), rather than one row per table row. A table that is not an OSM layer, a surface, and an OSM table an update changed are plotted row by row, as without it. Read by the Autark adapter only.",
|
|
1525
1845
|
"type": "boolean"
|
|
@@ -1532,6 +1852,36 @@
|
|
|
1532
1852
|
"minItems": 1,
|
|
1533
1853
|
"type": "array"
|
|
1534
1854
|
},
|
|
1855
|
+
"selection": {
|
|
1856
|
+
"description": "Rows selected when the plot is drawn, by their positions among the rows it draws, as `plot:selection` events and `setPlotSelection` name them. The plot draws them in its highlight color (a binned plot, the bins that hold them), and the map layers it is linked to, by `mapRef` or `links`, highlight the same rows, as after `setPlotSelection`. No `plot:selection` event reports it. A run refuses a position past the plot's last row. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1857
|
+
"items": {
|
|
1858
|
+
"description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
|
|
1859
|
+
"minimum": 0,
|
|
1860
|
+
"multipleOf": 1,
|
|
1861
|
+
"type": "number"
|
|
1862
|
+
},
|
|
1863
|
+
"type": "array"
|
|
1864
|
+
},
|
|
1865
|
+
"tickFormats": {
|
|
1866
|
+
"description": "d3-format specifiers of the tick labels of the plot's axes, `[x, y]`: a scatter plot's x and y axes; a bar or line chart's x axis, for labels that read as numbers, and its y axis; and every axis of numbers of parallel coordinates, which read only the first. Heat matrices and tables ignore it. Without it, `['~s', '~s']`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1867
|
+
"items": [
|
|
1868
|
+
{
|
|
1869
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
1870
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
1871
|
+
"title": "x",
|
|
1872
|
+
"type": "string"
|
|
1873
|
+
},
|
|
1874
|
+
{
|
|
1875
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
1876
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
1877
|
+
"title": "y",
|
|
1878
|
+
"type": "string"
|
|
1879
|
+
}
|
|
1880
|
+
],
|
|
1881
|
+
"maxItems": 2,
|
|
1882
|
+
"minItems": 2,
|
|
1883
|
+
"type": "array"
|
|
1884
|
+
},
|
|
1535
1885
|
"title": {
|
|
1536
1886
|
"type": "string"
|
|
1537
1887
|
},
|
|
@@ -2140,9 +2490,50 @@
|
|
|
2140
2490
|
"minItems": 1,
|
|
2141
2491
|
"type": "array"
|
|
2142
2492
|
},
|
|
2493
|
+
"axisLabels": {
|
|
2494
|
+
"description": "Titles of the plot's axes, in the order of `axis`, in place of the column names: the x and y axes' titles of a scatter plot, a bar chart, a line chart and a heat matrix, each axis's title of parallel coordinates, and a table's column headers. An axis without a title keeps its column's name, and an axis that holds a transform's output, `@transform`, is titled `value`. A run refuses more titles than `axis` has columns, and two titles alike, since a table finds the column to sort by its header. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
2495
|
+
"items": {
|
|
2496
|
+
"type": "string"
|
|
2497
|
+
},
|
|
2498
|
+
"type": "array",
|
|
2499
|
+
"uniqueItems": true
|
|
2500
|
+
},
|
|
2501
|
+
"categoricalColorMapInterpolator": {
|
|
2502
|
+
"$ref": "#/definitions/CategoricalColorMapInterpolator",
|
|
2503
|
+
"description": "Color scheme of marks colored by categories: a categorical `scheme*` scheme, `schemeObservable10` by default. The categories take the scheme's colors in the order they first appear, or in `colorMapDomain`'s order, and those past the scheme's last color take that one. A sequential or diverging `interpolate*` name is refused. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
2504
|
+
},
|
|
2143
2505
|
"color": {
|
|
2506
|
+
"description": "Column whose values color the marks: a scatter plot's points, a bar chart's bars, and the lines of parallel coordinates, which a click on an axis's title colors by that axis instead. When every value is a number, or a string that reads as one, the marks take `colorMapInterpolator`'s scheme; otherwise the values are categories, and take `categoricalColorMapInterpolator`'s. A heat matrix colors its cells by their values, which `@transform` names. Line charts and tables color no mark by value.",
|
|
2144
2507
|
"type": "string"
|
|
2145
2508
|
},
|
|
2509
|
+
"colorMapDomain": {
|
|
2510
|
+
"description": "Categories the plot is colored over, in order: the first takes the categorical scheme's first color, and so on. The values are read as categories, numbers too, and a mark whose value is not among them is drawn in the mark color. It cannot be set with `colorMapRange`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
2511
|
+
"items": {
|
|
2512
|
+
"type": "string"
|
|
2513
|
+
},
|
|
2514
|
+
"type": "array"
|
|
2515
|
+
},
|
|
2516
|
+
"colorMapInterpolator": {
|
|
2517
|
+
"$ref": "#/definitions/ContinuousColorMapInterpolator",
|
|
2518
|
+
"description": "Color scheme of marks colored by numbers: a sequential or diverging `interpolate*` scheme, `interpolateReds` by default. The scale's low end takes the scheme's first color and its high end its last: the lowest and highest values, unless `colorMapRange` or `normalization` sets them. A categorical `scheme*` name is refused, since categories take `categoricalColorMapInterpolator`. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
2519
|
+
},
|
|
2520
|
+
"colorMapRange": {
|
|
2521
|
+
"description": "Ends of the color scale of numbers, as `[low, high]` with low less than high. The plot is colored over this range instead of its lowest and highest values, so plots and map layers that set the same range color the same value alike. Values that are categories ignore it, as a layer with a categorical scheme does, and it cannot be set with `colorMapDomain`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
2522
|
+
"items": [
|
|
2523
|
+
{
|
|
2524
|
+
"title": "low",
|
|
2525
|
+
"type": "number"
|
|
2526
|
+
},
|
|
2527
|
+
{
|
|
2528
|
+
"title": "high",
|
|
2529
|
+
"type": "number"
|
|
2530
|
+
}
|
|
2531
|
+
],
|
|
2532
|
+
"maxItems": 2,
|
|
2533
|
+
"minItems": 2,
|
|
2534
|
+
"type": "array",
|
|
2535
|
+
"uniqueItems": true
|
|
2536
|
+
},
|
|
2146
2537
|
"dataRef": {
|
|
2147
2538
|
"description": "Name of the table to plot.",
|
|
2148
2539
|
"type": "string"
|
|
@@ -2157,6 +2548,10 @@
|
|
|
2157
2548
|
"height": {
|
|
2158
2549
|
"type": "number"
|
|
2159
2550
|
},
|
|
2551
|
+
"highlightColor": {
|
|
2552
|
+
"$ref": "#/definitions/HexColor",
|
|
2553
|
+
"description": "Color of the selected marks, and of a table's selected rows, as `#rrggbb`: `#5dade2` by default. autk-plot keeps one highlight color for the page, so every plot it draws there takes it: a run refuses two plots that set different ones, and a run whose plots set none gives back autk-plot's. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
2554
|
+
},
|
|
2160
2555
|
"id": {
|
|
2161
2556
|
"description": "Name of the plot, which a link in `links` uses as its `source`. Unique among the ids of the maps and plots. Without it a plot is known by its `dataRef`, so two plots of one table need ids: a run refuses two plots known by one name.",
|
|
2162
2557
|
"minLength": 1,
|
|
@@ -2193,6 +2588,28 @@
|
|
|
2193
2588
|
"const": "parallel-coordinates",
|
|
2194
2589
|
"type": "string"
|
|
2195
2590
|
},
|
|
2591
|
+
"markColor": {
|
|
2592
|
+
"$ref": "#/definitions/HexColor",
|
|
2593
|
+
"description": "Color of the marks that are neither colored by value nor selected, as `#rrggbb`: `#bfbfbf` by default. autk-plot keeps one mark color for the page, so every plot it draws there takes it: a run refuses two plots that set different ones, and a run whose plots set none gives back autk-plot's. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
2594
|
+
},
|
|
2595
|
+
"normalization": {
|
|
2596
|
+
"description": "How the ends of the color scale of numbers are found: `minMax`, the default, takes the lowest and highest values; `percentile` takes the values at the `lowerPercentile` and `upperPercentile` percentiles, 2 and 98 when it gives neither, else 0 and 100 for the one it leaves out. Categories ignore it. A map layer's `normalization` reads the same way. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
2597
|
+
"properties": {
|
|
2598
|
+
"lowerPercentile": {
|
|
2599
|
+
"type": "number"
|
|
2600
|
+
},
|
|
2601
|
+
"mode": {
|
|
2602
|
+
"$ref": "#/definitions/NormalizationMode"
|
|
2603
|
+
},
|
|
2604
|
+
"upperPercentile": {
|
|
2605
|
+
"type": "number"
|
|
2606
|
+
}
|
|
2607
|
+
},
|
|
2608
|
+
"required": [
|
|
2609
|
+
"mode"
|
|
2610
|
+
],
|
|
2611
|
+
"type": "object"
|
|
2612
|
+
},
|
|
2196
2613
|
"osmElements": {
|
|
2197
2614
|
"description": "Plot an OpenStreetMap layer table as one row per OSM element it was built from, each with the element's tags, `osm_type` and `osm_id` (and `building_id` in a buildings table), rather than one row per table row. A table that is not an OSM layer, a surface, and an OSM table an update changed are plotted row by row, as without it. Read by the Autark adapter only.",
|
|
2198
2615
|
"type": "boolean"
|
|
@@ -2205,6 +2622,36 @@
|
|
|
2205
2622
|
"minItems": 1,
|
|
2206
2623
|
"type": "array"
|
|
2207
2624
|
},
|
|
2625
|
+
"selection": {
|
|
2626
|
+
"description": "Rows selected when the plot is drawn, by their positions among the rows it draws, as `plot:selection` events and `setPlotSelection` name them. The plot draws them in its highlight color (a binned plot, the bins that hold them), and the map layers it is linked to, by `mapRef` or `links`, highlight the same rows, as after `setPlotSelection`. No `plot:selection` event reports it. A run refuses a position past the plot's last row. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
2627
|
+
"items": {
|
|
2628
|
+
"description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
|
|
2629
|
+
"minimum": 0,
|
|
2630
|
+
"multipleOf": 1,
|
|
2631
|
+
"type": "number"
|
|
2632
|
+
},
|
|
2633
|
+
"type": "array"
|
|
2634
|
+
},
|
|
2635
|
+
"tickFormats": {
|
|
2636
|
+
"description": "d3-format specifiers of the tick labels of the plot's axes, `[x, y]`: a scatter plot's x and y axes; a bar or line chart's x axis, for labels that read as numbers, and its y axis; and every axis of numbers of parallel coordinates, which read only the first. Heat matrices and tables ignore it. Without it, `['~s', '~s']`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
2637
|
+
"items": [
|
|
2638
|
+
{
|
|
2639
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
2640
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
2641
|
+
"title": "x",
|
|
2642
|
+
"type": "string"
|
|
2643
|
+
},
|
|
2644
|
+
{
|
|
2645
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
2646
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
2647
|
+
"title": "y",
|
|
2648
|
+
"type": "string"
|
|
2649
|
+
}
|
|
2650
|
+
],
|
|
2651
|
+
"maxItems": 2,
|
|
2652
|
+
"minItems": 2,
|
|
2653
|
+
"type": "array"
|
|
2654
|
+
},
|
|
2208
2655
|
"title": {
|
|
2209
2656
|
"type": "string"
|
|
2210
2657
|
},
|
|
@@ -2321,6 +2768,11 @@
|
|
|
2321
2768
|
}
|
|
2322
2769
|
],
|
|
2323
2770
|
"description": "A plot view. The `mark` field selects which transforms apply.",
|
|
2771
|
+
"if": {
|
|
2772
|
+
"required": [
|
|
2773
|
+
"colorMapRange"
|
|
2774
|
+
]
|
|
2775
|
+
},
|
|
2324
2776
|
"properties": {
|
|
2325
2777
|
"mark": {
|
|
2326
2778
|
"enum": [
|
|
@@ -2337,6 +2789,13 @@
|
|
|
2337
2789
|
"required": [
|
|
2338
2790
|
"mark"
|
|
2339
2791
|
],
|
|
2792
|
+
"then": {
|
|
2793
|
+
"not": {
|
|
2794
|
+
"required": [
|
|
2795
|
+
"colorMapDomain"
|
|
2796
|
+
]
|
|
2797
|
+
}
|
|
2798
|
+
},
|
|
2340
2799
|
"type": "object"
|
|
2341
2800
|
},
|
|
2342
2801
|
"PlotTransformPreset": {
|
|
@@ -2748,9 +3207,50 @@
|
|
|
2748
3207
|
"minItems": 2,
|
|
2749
3208
|
"type": "array"
|
|
2750
3209
|
},
|
|
3210
|
+
"axisLabels": {
|
|
3211
|
+
"description": "Titles of the plot's axes, in the order of `axis`, in place of the column names: the x and y axes' titles of a scatter plot, a bar chart, a line chart and a heat matrix, each axis's title of parallel coordinates, and a table's column headers. An axis without a title keeps its column's name, and an axis that holds a transform's output, `@transform`, is titled `value`. A run refuses more titles than `axis` has columns, and two titles alike, since a table finds the column to sort by its header. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3212
|
+
"items": {
|
|
3213
|
+
"type": "string"
|
|
3214
|
+
},
|
|
3215
|
+
"type": "array",
|
|
3216
|
+
"uniqueItems": true
|
|
3217
|
+
},
|
|
3218
|
+
"categoricalColorMapInterpolator": {
|
|
3219
|
+
"$ref": "#/definitions/CategoricalColorMapInterpolator",
|
|
3220
|
+
"description": "Color scheme of marks colored by categories: a categorical `scheme*` scheme, `schemeObservable10` by default. The categories take the scheme's colors in the order they first appear, or in `colorMapDomain`'s order, and those past the scheme's last color take that one. A sequential or diverging `interpolate*` name is refused. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
3221
|
+
},
|
|
2751
3222
|
"color": {
|
|
3223
|
+
"description": "Column whose values color the marks: a scatter plot's points, a bar chart's bars, and the lines of parallel coordinates, which a click on an axis's title colors by that axis instead. When every value is a number, or a string that reads as one, the marks take `colorMapInterpolator`'s scheme; otherwise the values are categories, and take `categoricalColorMapInterpolator`'s. A heat matrix colors its cells by their values, which `@transform` names. Line charts and tables color no mark by value.",
|
|
2752
3224
|
"type": "string"
|
|
2753
3225
|
},
|
|
3226
|
+
"colorMapDomain": {
|
|
3227
|
+
"description": "Categories the plot is colored over, in order: the first takes the categorical scheme's first color, and so on. The values are read as categories, numbers too, and a mark whose value is not among them is drawn in the mark color. It cannot be set with `colorMapRange`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3228
|
+
"items": {
|
|
3229
|
+
"type": "string"
|
|
3230
|
+
},
|
|
3231
|
+
"type": "array"
|
|
3232
|
+
},
|
|
3233
|
+
"colorMapInterpolator": {
|
|
3234
|
+
"$ref": "#/definitions/ContinuousColorMapInterpolator",
|
|
3235
|
+
"description": "Color scheme of marks colored by numbers: a sequential or diverging `interpolate*` scheme, `interpolateReds` by default. The scale's low end takes the scheme's first color and its high end its last: the lowest and highest values, unless `colorMapRange` or `normalization` sets them. A categorical `scheme*` name is refused, since categories take `categoricalColorMapInterpolator`. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
3236
|
+
},
|
|
3237
|
+
"colorMapRange": {
|
|
3238
|
+
"description": "Ends of the color scale of numbers, as `[low, high]` with low less than high. The plot is colored over this range instead of its lowest and highest values, so plots and map layers that set the same range color the same value alike. Values that are categories ignore it, as a layer with a categorical scheme does, and it cannot be set with `colorMapDomain`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3239
|
+
"items": [
|
|
3240
|
+
{
|
|
3241
|
+
"title": "low",
|
|
3242
|
+
"type": "number"
|
|
3243
|
+
},
|
|
3244
|
+
{
|
|
3245
|
+
"title": "high",
|
|
3246
|
+
"type": "number"
|
|
3247
|
+
}
|
|
3248
|
+
],
|
|
3249
|
+
"maxItems": 2,
|
|
3250
|
+
"minItems": 2,
|
|
3251
|
+
"type": "array",
|
|
3252
|
+
"uniqueItems": true
|
|
3253
|
+
},
|
|
2754
3254
|
"dataRef": {
|
|
2755
3255
|
"description": "Name of the table to plot.",
|
|
2756
3256
|
"type": "string"
|
|
@@ -2765,6 +3265,10 @@
|
|
|
2765
3265
|
"height": {
|
|
2766
3266
|
"type": "number"
|
|
2767
3267
|
},
|
|
3268
|
+
"highlightColor": {
|
|
3269
|
+
"$ref": "#/definitions/HexColor",
|
|
3270
|
+
"description": "Color of the selected marks, and of a table's selected rows, as `#rrggbb`: `#5dade2` by default. autk-plot keeps one highlight color for the page, so every plot it draws there takes it: a run refuses two plots that set different ones, and a run whose plots set none gives back autk-plot's. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
3271
|
+
},
|
|
2768
3272
|
"id": {
|
|
2769
3273
|
"description": "Name of the plot, which a link in `links` uses as its `source`. Unique among the ids of the maps and plots. Without it a plot is known by its `dataRef`, so two plots of one table need ids: a run refuses two plots known by one name.",
|
|
2770
3274
|
"minLength": 1,
|
|
@@ -2801,6 +3305,28 @@
|
|
|
2801
3305
|
"const": "scatter",
|
|
2802
3306
|
"type": "string"
|
|
2803
3307
|
},
|
|
3308
|
+
"markColor": {
|
|
3309
|
+
"$ref": "#/definitions/HexColor",
|
|
3310
|
+
"description": "Color of the marks that are neither colored by value nor selected, as `#rrggbb`: `#bfbfbf` by default. autk-plot keeps one mark color for the page, so every plot it draws there takes it: a run refuses two plots that set different ones, and a run whose plots set none gives back autk-plot's. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
3311
|
+
},
|
|
3312
|
+
"normalization": {
|
|
3313
|
+
"description": "How the ends of the color scale of numbers are found: `minMax`, the default, takes the lowest and highest values; `percentile` takes the values at the `lowerPercentile` and `upperPercentile` percentiles, 2 and 98 when it gives neither, else 0 and 100 for the one it leaves out. Categories ignore it. A map layer's `normalization` reads the same way. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3314
|
+
"properties": {
|
|
3315
|
+
"lowerPercentile": {
|
|
3316
|
+
"type": "number"
|
|
3317
|
+
},
|
|
3318
|
+
"mode": {
|
|
3319
|
+
"$ref": "#/definitions/NormalizationMode"
|
|
3320
|
+
},
|
|
3321
|
+
"upperPercentile": {
|
|
3322
|
+
"type": "number"
|
|
3323
|
+
}
|
|
3324
|
+
},
|
|
3325
|
+
"required": [
|
|
3326
|
+
"mode"
|
|
3327
|
+
],
|
|
3328
|
+
"type": "object"
|
|
3329
|
+
},
|
|
2804
3330
|
"osmElements": {
|
|
2805
3331
|
"description": "Plot an OpenStreetMap layer table as one row per OSM element it was built from, each with the element's tags, `osm_type` and `osm_id` (and `building_id` in a buildings table), rather than one row per table row. A table that is not an OSM layer, a surface, and an OSM table an update changed are plotted row by row, as without it. Read by the Autark adapter only.",
|
|
2806
3332
|
"type": "boolean"
|
|
@@ -2813,6 +3339,36 @@
|
|
|
2813
3339
|
"minItems": 1,
|
|
2814
3340
|
"type": "array"
|
|
2815
3341
|
},
|
|
3342
|
+
"selection": {
|
|
3343
|
+
"description": "Rows selected when the plot is drawn, by their positions among the rows it draws, as `plot:selection` events and `setPlotSelection` name them. The plot draws them in its highlight color (a binned plot, the bins that hold them), and the map layers it is linked to, by `mapRef` or `links`, highlight the same rows, as after `setPlotSelection`. No `plot:selection` event reports it. A run refuses a position past the plot's last row. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3344
|
+
"items": {
|
|
3345
|
+
"description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
|
|
3346
|
+
"minimum": 0,
|
|
3347
|
+
"multipleOf": 1,
|
|
3348
|
+
"type": "number"
|
|
3349
|
+
},
|
|
3350
|
+
"type": "array"
|
|
3351
|
+
},
|
|
3352
|
+
"tickFormats": {
|
|
3353
|
+
"description": "d3-format specifiers of the tick labels of the plot's axes, `[x, y]`: a scatter plot's x and y axes; a bar or line chart's x axis, for labels that read as numbers, and its y axis; and every axis of numbers of parallel coordinates, which read only the first. Heat matrices and tables ignore it. Without it, `['~s', '~s']`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3354
|
+
"items": [
|
|
3355
|
+
{
|
|
3356
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
3357
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
3358
|
+
"title": "x",
|
|
3359
|
+
"type": "string"
|
|
3360
|
+
},
|
|
3361
|
+
{
|
|
3362
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
3363
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
3364
|
+
"title": "y",
|
|
3365
|
+
"type": "string"
|
|
3366
|
+
}
|
|
3367
|
+
],
|
|
3368
|
+
"maxItems": 2,
|
|
3369
|
+
"minItems": 2,
|
|
3370
|
+
"type": "array"
|
|
3371
|
+
},
|
|
2816
3372
|
"title": {
|
|
2817
3373
|
"type": "string"
|
|
2818
3374
|
},
|
|
@@ -2877,9 +3433,50 @@
|
|
|
2877
3433
|
"minItems": 1,
|
|
2878
3434
|
"type": "array"
|
|
2879
3435
|
},
|
|
3436
|
+
"axisLabels": {
|
|
3437
|
+
"description": "Titles of the plot's axes, in the order of `axis`, in place of the column names: the x and y axes' titles of a scatter plot, a bar chart, a line chart and a heat matrix, each axis's title of parallel coordinates, and a table's column headers. An axis without a title keeps its column's name, and an axis that holds a transform's output, `@transform`, is titled `value`. A run refuses more titles than `axis` has columns, and two titles alike, since a table finds the column to sort by its header. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3438
|
+
"items": {
|
|
3439
|
+
"type": "string"
|
|
3440
|
+
},
|
|
3441
|
+
"type": "array",
|
|
3442
|
+
"uniqueItems": true
|
|
3443
|
+
},
|
|
3444
|
+
"categoricalColorMapInterpolator": {
|
|
3445
|
+
"$ref": "#/definitions/CategoricalColorMapInterpolator",
|
|
3446
|
+
"description": "Color scheme of marks colored by categories: a categorical `scheme*` scheme, `schemeObservable10` by default. The categories take the scheme's colors in the order they first appear, or in `colorMapDomain`'s order, and those past the scheme's last color take that one. A sequential or diverging `interpolate*` name is refused. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
3447
|
+
},
|
|
2880
3448
|
"color": {
|
|
3449
|
+
"description": "Column whose values color the marks: a scatter plot's points, a bar chart's bars, and the lines of parallel coordinates, which a click on an axis's title colors by that axis instead. When every value is a number, or a string that reads as one, the marks take `colorMapInterpolator`'s scheme; otherwise the values are categories, and take `categoricalColorMapInterpolator`'s. A heat matrix colors its cells by their values, which `@transform` names. Line charts and tables color no mark by value.",
|
|
2881
3450
|
"type": "string"
|
|
2882
3451
|
},
|
|
3452
|
+
"colorMapDomain": {
|
|
3453
|
+
"description": "Categories the plot is colored over, in order: the first takes the categorical scheme's first color, and so on. The values are read as categories, numbers too, and a mark whose value is not among them is drawn in the mark color. It cannot be set with `colorMapRange`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3454
|
+
"items": {
|
|
3455
|
+
"type": "string"
|
|
3456
|
+
},
|
|
3457
|
+
"type": "array"
|
|
3458
|
+
},
|
|
3459
|
+
"colorMapInterpolator": {
|
|
3460
|
+
"$ref": "#/definitions/ContinuousColorMapInterpolator",
|
|
3461
|
+
"description": "Color scheme of marks colored by numbers: a sequential or diverging `interpolate*` scheme, `interpolateReds` by default. The scale's low end takes the scheme's first color and its high end its last: the lowest and highest values, unless `colorMapRange` or `normalization` sets them. A categorical `scheme*` name is refused, since categories take `categoricalColorMapInterpolator`. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
3462
|
+
},
|
|
3463
|
+
"colorMapRange": {
|
|
3464
|
+
"description": "Ends of the color scale of numbers, as `[low, high]` with low less than high. The plot is colored over this range instead of its lowest and highest values, so plots and map layers that set the same range color the same value alike. Values that are categories ignore it, as a layer with a categorical scheme does, and it cannot be set with `colorMapDomain`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3465
|
+
"items": [
|
|
3466
|
+
{
|
|
3467
|
+
"title": "low",
|
|
3468
|
+
"type": "number"
|
|
3469
|
+
},
|
|
3470
|
+
{
|
|
3471
|
+
"title": "high",
|
|
3472
|
+
"type": "number"
|
|
3473
|
+
}
|
|
3474
|
+
],
|
|
3475
|
+
"maxItems": 2,
|
|
3476
|
+
"minItems": 2,
|
|
3477
|
+
"type": "array",
|
|
3478
|
+
"uniqueItems": true
|
|
3479
|
+
},
|
|
2883
3480
|
"dataRef": {
|
|
2884
3481
|
"description": "Name of the table to plot.",
|
|
2885
3482
|
"type": "string"
|
|
@@ -2894,6 +3491,10 @@
|
|
|
2894
3491
|
"height": {
|
|
2895
3492
|
"type": "number"
|
|
2896
3493
|
},
|
|
3494
|
+
"highlightColor": {
|
|
3495
|
+
"$ref": "#/definitions/HexColor",
|
|
3496
|
+
"description": "Color of the selected marks, and of a table's selected rows, as `#rrggbb`: `#5dade2` by default. autk-plot keeps one highlight color for the page, so every plot it draws there takes it: a run refuses two plots that set different ones, and a run whose plots set none gives back autk-plot's. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
3497
|
+
},
|
|
2897
3498
|
"id": {
|
|
2898
3499
|
"description": "Name of the plot, which a link in `links` uses as its `source`. Unique among the ids of the maps and plots. Without it a plot is known by its `dataRef`, so two plots of one table need ids: a run refuses two plots known by one name.",
|
|
2899
3500
|
"minLength": 1,
|
|
@@ -2930,6 +3531,28 @@
|
|
|
2930
3531
|
"const": "table",
|
|
2931
3532
|
"type": "string"
|
|
2932
3533
|
},
|
|
3534
|
+
"markColor": {
|
|
3535
|
+
"$ref": "#/definitions/HexColor",
|
|
3536
|
+
"description": "Color of the marks that are neither colored by value nor selected, as `#rrggbb`: `#bfbfbf` by default. autk-plot keeps one mark color for the page, so every plot it draws there takes it: a run refuses two plots that set different ones, and a run whose plots set none gives back autk-plot's. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
3537
|
+
},
|
|
3538
|
+
"normalization": {
|
|
3539
|
+
"description": "How the ends of the color scale of numbers are found: `minMax`, the default, takes the lowest and highest values; `percentile` takes the values at the `lowerPercentile` and `upperPercentile` percentiles, 2 and 98 when it gives neither, else 0 and 100 for the one it leaves out. Categories ignore it. A map layer's `normalization` reads the same way. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3540
|
+
"properties": {
|
|
3541
|
+
"lowerPercentile": {
|
|
3542
|
+
"type": "number"
|
|
3543
|
+
},
|
|
3544
|
+
"mode": {
|
|
3545
|
+
"$ref": "#/definitions/NormalizationMode"
|
|
3546
|
+
},
|
|
3547
|
+
"upperPercentile": {
|
|
3548
|
+
"type": "number"
|
|
3549
|
+
}
|
|
3550
|
+
},
|
|
3551
|
+
"required": [
|
|
3552
|
+
"mode"
|
|
3553
|
+
],
|
|
3554
|
+
"type": "object"
|
|
3555
|
+
},
|
|
2933
3556
|
"osmElements": {
|
|
2934
3557
|
"description": "Plot an OpenStreetMap layer table as one row per OSM element it was built from, each with the element's tags, `osm_type` and `osm_id` (and `building_id` in a buildings table), rather than one row per table row. A table that is not an OSM layer, a surface, and an OSM table an update changed are plotted row by row, as without it. Read by the Autark adapter only.",
|
|
2935
3558
|
"type": "boolean"
|
|
@@ -2942,6 +3565,36 @@
|
|
|
2942
3565
|
"minItems": 1,
|
|
2943
3566
|
"type": "array"
|
|
2944
3567
|
},
|
|
3568
|
+
"selection": {
|
|
3569
|
+
"description": "Rows selected when the plot is drawn, by their positions among the rows it draws, as `plot:selection` events and `setPlotSelection` name them. The plot draws them in its highlight color (a binned plot, the bins that hold them), and the map layers it is linked to, by `mapRef` or `links`, highlight the same rows, as after `setPlotSelection`. No `plot:selection` event reports it. A run refuses a position past the plot's last row. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3570
|
+
"items": {
|
|
3571
|
+
"description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
|
|
3572
|
+
"minimum": 0,
|
|
3573
|
+
"multipleOf": 1,
|
|
3574
|
+
"type": "number"
|
|
3575
|
+
},
|
|
3576
|
+
"type": "array"
|
|
3577
|
+
},
|
|
3578
|
+
"tickFormats": {
|
|
3579
|
+
"description": "d3-format specifiers of the tick labels of the plot's axes, `[x, y]`: a scatter plot's x and y axes; a bar or line chart's x axis, for labels that read as numbers, and its y axis; and every axis of numbers of parallel coordinates, which read only the first. Heat matrices and tables ignore it. Without it, `['~s', '~s']`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3580
|
+
"items": [
|
|
3581
|
+
{
|
|
3582
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
3583
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
3584
|
+
"title": "x",
|
|
3585
|
+
"type": "string"
|
|
3586
|
+
},
|
|
3587
|
+
{
|
|
3588
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
3589
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
3590
|
+
"title": "y",
|
|
3591
|
+
"type": "string"
|
|
3592
|
+
}
|
|
3593
|
+
],
|
|
3594
|
+
"maxItems": 2,
|
|
3595
|
+
"minItems": 2,
|
|
3596
|
+
"type": "array"
|
|
3597
|
+
},
|
|
2945
3598
|
"title": {
|
|
2946
3599
|
"type": "string"
|
|
2947
3600
|
},
|