@urban-toolkit/autk-grammar 5.1.0 → 5.3.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 +222 -1
- package/build/autk-grammar-schema.json +844 -24
- package/dist/autk-grammar.js +942 -671
- 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 +98 -94
- package/dist/data/autk-grammar-data.js.map +1 -1
- package/dist/index.d.ts +261 -13
- 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,14 +1852,44 @@
|
|
|
1532
1852
|
"minItems": 1,
|
|
1533
1853
|
"type": "array"
|
|
1534
1854
|
},
|
|
1535
|
-
"
|
|
1536
|
-
"
|
|
1537
|
-
|
|
1538
|
-
|
|
1539
|
-
|
|
1540
|
-
|
|
1541
|
-
|
|
1542
|
-
|
|
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
|
+
},
|
|
1885
|
+
"title": {
|
|
1886
|
+
"type": "string"
|
|
1887
|
+
},
|
|
1888
|
+
"transform": {
|
|
1889
|
+
"$ref": "#/definitions/PlotTransformSpec%3C(%22reduce-series%22%7C%22binning-events%22)%3E"
|
|
1890
|
+
},
|
|
1891
|
+
"width": {
|
|
1892
|
+
"type": "number"
|
|
1543
1893
|
},
|
|
1544
1894
|
"workspace": {
|
|
1545
1895
|
"$ref": "#/definitions/WorkspaceName",
|
|
@@ -1607,11 +1957,13 @@
|
|
|
1607
1957
|
"MapLayerSpec": {
|
|
1608
1958
|
"description": "One layer drawn by a map.",
|
|
1609
1959
|
"if": {
|
|
1610
|
-
"
|
|
1611
|
-
"colorMapRange"
|
|
1612
|
-
]
|
|
1960
|
+
"type": "object"
|
|
1613
1961
|
},
|
|
1614
1962
|
"properties": {
|
|
1963
|
+
"buildingsZeroHeight": {
|
|
1964
|
+
"description": "Draw the parts of a buildings layer that have no height, each with a random height of 3 to 7 floors of 3.4 m (10.2 to 23.8 m), rather than leave them out: autk-map's `buildingsZeroHeight`. A part has no height when it has none of `height`, `building:height`, `levels` and `building:levels`; a part with one of them whose height is not above its minimum, such as `0`, is still left out. The heights change at each run. Read by the Autark adapter for buildings layers; other layers and the deck.gl adapter ignore it.",
|
|
1965
|
+
"type": "boolean"
|
|
1966
|
+
},
|
|
1615
1967
|
"catchAllCategory": {
|
|
1616
1968
|
"type": "string"
|
|
1617
1969
|
},
|
|
@@ -1635,7 +1987,7 @@
|
|
|
1635
1987
|
"description": "Color scheme used when `isColorMap` is set."
|
|
1636
1988
|
},
|
|
1637
1989
|
"colorMapLabels": {
|
|
1638
|
-
"description": "Legend labels.
|
|
1990
|
+
"description": "Legend labels. Neither adapter reads it.",
|
|
1639
1991
|
"items": {
|
|
1640
1992
|
"type": "string"
|
|
1641
1993
|
},
|
|
@@ -1674,7 +2026,7 @@
|
|
|
1674
2026
|
]
|
|
1675
2027
|
},
|
|
1676
2028
|
"getFnv": {
|
|
1677
|
-
"description": "Dot path to the thematic value, relative to `feature.properties` (for example `tags.highway` or `compute.result`).",
|
|
2029
|
+
"description": "Dot path to the thematic value, relative to `feature.properties` (for example `tags.highway` or `compute.result`). On a raster layer, the band to draw, by its id (`band_1`, ...) or its label (`count.noise` for a heatmap band labeled `count_noise`), the first band without it; on a raster of several bands, one that names none of them is refused.",
|
|
1678
2030
|
"type": "string"
|
|
1679
2031
|
},
|
|
1680
2032
|
"getFnvType": {
|
|
@@ -1690,13 +2042,21 @@
|
|
|
1690
2042
|
"type": "boolean"
|
|
1691
2043
|
},
|
|
1692
2044
|
"isPick": {
|
|
1693
|
-
"description": "Allow picking features on this layer.",
|
|
2045
|
+
"description": "Allow picking features on this layer. autk-map lets one layer of a map pick: the last layer that sets it, unless a link or a plot's `mapRef` makes another layer of the map pick.",
|
|
1694
2046
|
"type": "boolean"
|
|
1695
2047
|
},
|
|
1696
2048
|
"isSkip": {
|
|
1697
2049
|
"description": "Load the layer without drawing it.",
|
|
1698
2050
|
"type": "boolean"
|
|
1699
2051
|
},
|
|
2052
|
+
"layerType": {
|
|
2053
|
+
"$ref": "#/definitions/LayerType",
|
|
2054
|
+
"description": "How the map draws the layer's table, in place of the table's own type, among the types of its kind of geometry: a table of polygons as `polygons`, `surface`, `parks`, `water` or `buildings` (raised by its heights), a table of lines as `polylines` or `roads`, a table of points as `points`, and a raster as `raster`. autk-map draws surface, parks, water and roads layers below the others, in that order, whatever the order of `layerRefs`. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
2055
|
+
},
|
|
2056
|
+
"legend": {
|
|
2057
|
+
"description": "Show this layer's color scale in the map's legend, which otherwise shows the last layer whose colors autk-map set, about the last layer colored by value. One layer of a map at most; a layer colored by value, or a raster, whose legend it shows; and a map that shows its controls. The layers pick as their `isPick` says. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
2058
|
+
"type": "boolean"
|
|
2059
|
+
},
|
|
1700
2060
|
"normalization": {
|
|
1701
2061
|
"description": "How values are rescaled before coloring.",
|
|
1702
2062
|
"properties": {
|
|
@@ -1724,8 +2084,11 @@
|
|
|
1724
2084
|
"type": "boolean"
|
|
1725
2085
|
},
|
|
1726
2086
|
"pickedComps": {
|
|
1727
|
-
"description": "
|
|
2087
|
+
"description": "Features drawn as picked from the start, in the map's highlight color, as if the user had picked them: their positions among the features the layer draws, as `map:picking` events give them. autk-map draws picked features only on the layer of a map that picks, so the layer sets `isPick: true`, and no later layer of its map sets it, nor does a link or a plot's `mapRef` make another layer of its map pick. The plots linked to the layer select the same rows. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1728
2088
|
"items": {
|
|
2089
|
+
"description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
|
|
2090
|
+
"minimum": 0,
|
|
2091
|
+
"multipleOf": 1,
|
|
1729
2092
|
"type": "number"
|
|
1730
2093
|
},
|
|
1731
2094
|
"type": "array"
|
|
@@ -1743,6 +2106,16 @@
|
|
|
1743
2106
|
"minItems": 1,
|
|
1744
2107
|
"type": "array"
|
|
1745
2108
|
},
|
|
2109
|
+
"skippedComps": {
|
|
2110
|
+
"description": "Features the layer hides, by their positions among the features it draws, as `map:picking` events give them. A hidden feature of a polygons or buildings layer can still be picked with autk-map 4.1.1. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
2111
|
+
"items": {
|
|
2112
|
+
"description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
|
|
2113
|
+
"minimum": 0,
|
|
2114
|
+
"multipleOf": 1,
|
|
2115
|
+
"type": "number"
|
|
2116
|
+
},
|
|
2117
|
+
"type": "array"
|
|
2118
|
+
},
|
|
1746
2119
|
"stroke": {
|
|
1747
2120
|
"anyOf": [
|
|
1748
2121
|
{
|
|
@@ -1765,20 +2138,69 @@
|
|
|
1765
2138
|
"description": "How opaque a raster layer's cells are by value, as autk-map's transfer function: for example `{ opacityMin: 1, opacityMax: 1 }` draws every cell with a value fully opaque. Read by the Autark adapter for raster layers; other layers and the deck.gl adapter ignore it."
|
|
1766
2139
|
},
|
|
1767
2140
|
"width": {
|
|
1768
|
-
"description": "Width of the lines of a polylines or roads layer, in the map's planar units (about meters). It replaces the widths a roads layer gives each kind of road. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
2141
|
+
"description": "Width of the lines of a polylines or roads layer, in the map's planar units (about meters). It replaces the widths a roads layer gives each kind of road. Not with `widthBy`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1769
2142
|
"exclusiveMinimum": 0,
|
|
1770
2143
|
"type": "number"
|
|
2144
|
+
},
|
|
2145
|
+
"widthBy": {
|
|
2146
|
+
"description": "Dot path to the width of each line of a roads layer, relative to `feature.properties`, in the map's planar units (about meters), as `width` gives every line one: autk-map's widths by feature. A line without a positive number there keeps the width of its kind of road. autk-map draws every line of a polylines layer at one width, so a table of lines takes it drawn as roads, with `layerType: 'roads'`. Not with `width`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
2147
|
+
"minLength": 1,
|
|
2148
|
+
"type": "string"
|
|
1771
2149
|
}
|
|
1772
2150
|
},
|
|
1773
2151
|
"required": [
|
|
1774
2152
|
"dataRef"
|
|
1775
2153
|
],
|
|
1776
2154
|
"then": {
|
|
1777
|
-
"
|
|
1778
|
-
|
|
1779
|
-
"
|
|
1780
|
-
|
|
1781
|
-
|
|
2155
|
+
"allOf": [
|
|
2156
|
+
{
|
|
2157
|
+
"if": {
|
|
2158
|
+
"required": [
|
|
2159
|
+
"colorMapRange"
|
|
2160
|
+
]
|
|
2161
|
+
},
|
|
2162
|
+
"then": {
|
|
2163
|
+
"not": {
|
|
2164
|
+
"required": [
|
|
2165
|
+
"colorMapDomain"
|
|
2166
|
+
]
|
|
2167
|
+
}
|
|
2168
|
+
}
|
|
2169
|
+
},
|
|
2170
|
+
{
|
|
2171
|
+
"if": {
|
|
2172
|
+
"required": [
|
|
2173
|
+
"pickedComps"
|
|
2174
|
+
]
|
|
2175
|
+
},
|
|
2176
|
+
"then": {
|
|
2177
|
+
"not": {
|
|
2178
|
+
"properties": {
|
|
2179
|
+
"isPick": {
|
|
2180
|
+
"const": false
|
|
2181
|
+
}
|
|
2182
|
+
}
|
|
2183
|
+
},
|
|
2184
|
+
"required": [
|
|
2185
|
+
"isPick"
|
|
2186
|
+
]
|
|
2187
|
+
}
|
|
2188
|
+
},
|
|
2189
|
+
{
|
|
2190
|
+
"if": {
|
|
2191
|
+
"required": [
|
|
2192
|
+
"widthBy"
|
|
2193
|
+
]
|
|
2194
|
+
},
|
|
2195
|
+
"then": {
|
|
2196
|
+
"not": {
|
|
2197
|
+
"required": [
|
|
2198
|
+
"width"
|
|
2199
|
+
]
|
|
2200
|
+
}
|
|
2201
|
+
}
|
|
2202
|
+
}
|
|
2203
|
+
]
|
|
1782
2204
|
},
|
|
1783
2205
|
"type": "object"
|
|
1784
2206
|
},
|
|
@@ -1789,11 +2211,19 @@
|
|
|
1789
2211
|
"$ref": "#/definitions/CameraSpec",
|
|
1790
2212
|
"description": "Where the map looks from."
|
|
1791
2213
|
},
|
|
2214
|
+
"highlightColor": {
|
|
2215
|
+
"$ref": "#/definitions/HexColor",
|
|
2216
|
+
"description": "The color of the features the map draws as picked, by the user, a layer's `pickedComps`, a link or a call such as `highlightOnMap`, `#rrggbb`. Each map has its own; autk-map's is `#5dade2`. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
2217
|
+
},
|
|
1792
2218
|
"id": {
|
|
1793
2219
|
"description": "Name of the map, which a link in `links` uses as its `target`. Unique among the ids of the maps and plots.",
|
|
1794
2220
|
"minLength": 1,
|
|
1795
2221
|
"type": "string"
|
|
1796
2222
|
},
|
|
2223
|
+
"invalidValueColor": {
|
|
2224
|
+
"$ref": "#/definitions/HexColor",
|
|
2225
|
+
"description": "The color of the features of a layer colored by value whose value autk-map cannot color: one without a value, or with one that is not on the layer's scale, `#rrggbb`. Each map has its own; autk-map's is `#ffffff`. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
2226
|
+
},
|
|
1797
2227
|
"layerRefs": {
|
|
1798
2228
|
"description": "Layers to draw, bottom first. Each names a table with `dataRef`.",
|
|
1799
2229
|
"items": {
|
|
@@ -1801,9 +2231,24 @@
|
|
|
1801
2231
|
},
|
|
1802
2232
|
"type": "array"
|
|
1803
2233
|
},
|
|
2234
|
+
"showUi": {
|
|
2235
|
+
"description": "Whether autk-map shows its floating controls on the map: the menu of its layers and the legend. `false` hides them, and the \"made with autark\" credit stays. Defaults to `true`. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
2236
|
+
"type": "boolean"
|
|
2237
|
+
},
|
|
1804
2238
|
"style": {
|
|
1805
|
-
"
|
|
1806
|
-
|
|
2239
|
+
"anyOf": [
|
|
2240
|
+
{
|
|
2241
|
+
"type": "string"
|
|
2242
|
+
},
|
|
2243
|
+
{
|
|
2244
|
+
"$ref": "#/definitions/MapStyleColors"
|
|
2245
|
+
}
|
|
2246
|
+
],
|
|
2247
|
+
"description": "Map style: the name of one of autk-map's styles, such as `apple`, its default, or `light` (a name autk-map does not know draws in `apple`), or the colors of a style of the spec's own. A layer with a `color` is drawn in it instead, and a layer colored by value in its scheme. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
2248
|
+
},
|
|
2249
|
+
"terrain": {
|
|
2250
|
+
"$ref": "#/definitions/TerrainSpec",
|
|
2251
|
+
"description": "A 3D ground from an elevation raster: autk-map raises the ground the raster covers to its heights, drapes the map's flat layers over it, stands its buildings on it, and fits the view to it, from which `camera` moves. Read by the Autark adapter; the deck.gl adapter ignores it."
|
|
1807
2252
|
},
|
|
1808
2253
|
"workspace": {
|
|
1809
2254
|
"$ref": "#/definitions/WorkspaceName",
|
|
@@ -1815,6 +2260,59 @@
|
|
|
1815
2260
|
],
|
|
1816
2261
|
"type": "object"
|
|
1817
2262
|
},
|
|
2263
|
+
"MapStyleColors": {
|
|
2264
|
+
"description": "The colors of a map style of the spec's own, each `#rrggbb`: the background, and the color of each kind of layer drawn in one color. autk-map takes a style only whole, so each of the nine is given. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
2265
|
+
"properties": {
|
|
2266
|
+
"background": {
|
|
2267
|
+
"$ref": "#/definitions/HexColor",
|
|
2268
|
+
"description": "The map's background, where no layer is drawn."
|
|
2269
|
+
},
|
|
2270
|
+
"buildings": {
|
|
2271
|
+
"$ref": "#/definitions/HexColor",
|
|
2272
|
+
"description": "Buildings layers."
|
|
2273
|
+
},
|
|
2274
|
+
"parks": {
|
|
2275
|
+
"$ref": "#/definitions/HexColor",
|
|
2276
|
+
"description": "Parks layers."
|
|
2277
|
+
},
|
|
2278
|
+
"points": {
|
|
2279
|
+
"$ref": "#/definitions/HexColor",
|
|
2280
|
+
"description": "Points layers."
|
|
2281
|
+
},
|
|
2282
|
+
"polygons": {
|
|
2283
|
+
"$ref": "#/definitions/HexColor",
|
|
2284
|
+
"description": "Polygons layers."
|
|
2285
|
+
},
|
|
2286
|
+
"polylines": {
|
|
2287
|
+
"$ref": "#/definitions/HexColor",
|
|
2288
|
+
"description": "Polylines layers."
|
|
2289
|
+
},
|
|
2290
|
+
"roads": {
|
|
2291
|
+
"$ref": "#/definitions/HexColor",
|
|
2292
|
+
"description": "Roads layers."
|
|
2293
|
+
},
|
|
2294
|
+
"surface": {
|
|
2295
|
+
"$ref": "#/definitions/HexColor",
|
|
2296
|
+
"description": "Surface layers: the ground of an area."
|
|
2297
|
+
},
|
|
2298
|
+
"water": {
|
|
2299
|
+
"$ref": "#/definitions/HexColor",
|
|
2300
|
+
"description": "Water layers."
|
|
2301
|
+
}
|
|
2302
|
+
},
|
|
2303
|
+
"required": [
|
|
2304
|
+
"background",
|
|
2305
|
+
"surface",
|
|
2306
|
+
"parks",
|
|
2307
|
+
"water",
|
|
2308
|
+
"roads",
|
|
2309
|
+
"buildings",
|
|
2310
|
+
"points",
|
|
2311
|
+
"polylines",
|
|
2312
|
+
"polygons"
|
|
2313
|
+
],
|
|
2314
|
+
"type": "object"
|
|
2315
|
+
},
|
|
1818
2316
|
"MultiLineString": {
|
|
1819
2317
|
"description": "MultiLineString geometry object. https://tools.ietf.org/html/rfc7946#section-3.1.5",
|
|
1820
2318
|
"properties": {
|
|
@@ -2140,9 +2638,50 @@
|
|
|
2140
2638
|
"minItems": 1,
|
|
2141
2639
|
"type": "array"
|
|
2142
2640
|
},
|
|
2641
|
+
"axisLabels": {
|
|
2642
|
+
"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.",
|
|
2643
|
+
"items": {
|
|
2644
|
+
"type": "string"
|
|
2645
|
+
},
|
|
2646
|
+
"type": "array",
|
|
2647
|
+
"uniqueItems": true
|
|
2648
|
+
},
|
|
2649
|
+
"categoricalColorMapInterpolator": {
|
|
2650
|
+
"$ref": "#/definitions/CategoricalColorMapInterpolator",
|
|
2651
|
+
"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."
|
|
2652
|
+
},
|
|
2143
2653
|
"color": {
|
|
2654
|
+
"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
2655
|
"type": "string"
|
|
2145
2656
|
},
|
|
2657
|
+
"colorMapDomain": {
|
|
2658
|
+
"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.",
|
|
2659
|
+
"items": {
|
|
2660
|
+
"type": "string"
|
|
2661
|
+
},
|
|
2662
|
+
"type": "array"
|
|
2663
|
+
},
|
|
2664
|
+
"colorMapInterpolator": {
|
|
2665
|
+
"$ref": "#/definitions/ContinuousColorMapInterpolator",
|
|
2666
|
+
"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."
|
|
2667
|
+
},
|
|
2668
|
+
"colorMapRange": {
|
|
2669
|
+
"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.",
|
|
2670
|
+
"items": [
|
|
2671
|
+
{
|
|
2672
|
+
"title": "low",
|
|
2673
|
+
"type": "number"
|
|
2674
|
+
},
|
|
2675
|
+
{
|
|
2676
|
+
"title": "high",
|
|
2677
|
+
"type": "number"
|
|
2678
|
+
}
|
|
2679
|
+
],
|
|
2680
|
+
"maxItems": 2,
|
|
2681
|
+
"minItems": 2,
|
|
2682
|
+
"type": "array",
|
|
2683
|
+
"uniqueItems": true
|
|
2684
|
+
},
|
|
2146
2685
|
"dataRef": {
|
|
2147
2686
|
"description": "Name of the table to plot.",
|
|
2148
2687
|
"type": "string"
|
|
@@ -2157,6 +2696,10 @@
|
|
|
2157
2696
|
"height": {
|
|
2158
2697
|
"type": "number"
|
|
2159
2698
|
},
|
|
2699
|
+
"highlightColor": {
|
|
2700
|
+
"$ref": "#/definitions/HexColor",
|
|
2701
|
+
"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."
|
|
2702
|
+
},
|
|
2160
2703
|
"id": {
|
|
2161
2704
|
"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
2705
|
"minLength": 1,
|
|
@@ -2193,6 +2736,28 @@
|
|
|
2193
2736
|
"const": "parallel-coordinates",
|
|
2194
2737
|
"type": "string"
|
|
2195
2738
|
},
|
|
2739
|
+
"markColor": {
|
|
2740
|
+
"$ref": "#/definitions/HexColor",
|
|
2741
|
+
"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."
|
|
2742
|
+
},
|
|
2743
|
+
"normalization": {
|
|
2744
|
+
"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.",
|
|
2745
|
+
"properties": {
|
|
2746
|
+
"lowerPercentile": {
|
|
2747
|
+
"type": "number"
|
|
2748
|
+
},
|
|
2749
|
+
"mode": {
|
|
2750
|
+
"$ref": "#/definitions/NormalizationMode"
|
|
2751
|
+
},
|
|
2752
|
+
"upperPercentile": {
|
|
2753
|
+
"type": "number"
|
|
2754
|
+
}
|
|
2755
|
+
},
|
|
2756
|
+
"required": [
|
|
2757
|
+
"mode"
|
|
2758
|
+
],
|
|
2759
|
+
"type": "object"
|
|
2760
|
+
},
|
|
2196
2761
|
"osmElements": {
|
|
2197
2762
|
"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
2763
|
"type": "boolean"
|
|
@@ -2205,6 +2770,36 @@
|
|
|
2205
2770
|
"minItems": 1,
|
|
2206
2771
|
"type": "array"
|
|
2207
2772
|
},
|
|
2773
|
+
"selection": {
|
|
2774
|
+
"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.",
|
|
2775
|
+
"items": {
|
|
2776
|
+
"description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
|
|
2777
|
+
"minimum": 0,
|
|
2778
|
+
"multipleOf": 1,
|
|
2779
|
+
"type": "number"
|
|
2780
|
+
},
|
|
2781
|
+
"type": "array"
|
|
2782
|
+
},
|
|
2783
|
+
"tickFormats": {
|
|
2784
|
+
"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.",
|
|
2785
|
+
"items": [
|
|
2786
|
+
{
|
|
2787
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
2788
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
2789
|
+
"title": "x",
|
|
2790
|
+
"type": "string"
|
|
2791
|
+
},
|
|
2792
|
+
{
|
|
2793
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
2794
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
2795
|
+
"title": "y",
|
|
2796
|
+
"type": "string"
|
|
2797
|
+
}
|
|
2798
|
+
],
|
|
2799
|
+
"maxItems": 2,
|
|
2800
|
+
"minItems": 2,
|
|
2801
|
+
"type": "array"
|
|
2802
|
+
},
|
|
2208
2803
|
"title": {
|
|
2209
2804
|
"type": "string"
|
|
2210
2805
|
},
|
|
@@ -2321,6 +2916,11 @@
|
|
|
2321
2916
|
}
|
|
2322
2917
|
],
|
|
2323
2918
|
"description": "A plot view. The `mark` field selects which transforms apply.",
|
|
2919
|
+
"if": {
|
|
2920
|
+
"required": [
|
|
2921
|
+
"colorMapRange"
|
|
2922
|
+
]
|
|
2923
|
+
},
|
|
2324
2924
|
"properties": {
|
|
2325
2925
|
"mark": {
|
|
2326
2926
|
"enum": [
|
|
@@ -2337,6 +2937,13 @@
|
|
|
2337
2937
|
"required": [
|
|
2338
2938
|
"mark"
|
|
2339
2939
|
],
|
|
2940
|
+
"then": {
|
|
2941
|
+
"not": {
|
|
2942
|
+
"required": [
|
|
2943
|
+
"colorMapDomain"
|
|
2944
|
+
]
|
|
2945
|
+
}
|
|
2946
|
+
},
|
|
2340
2947
|
"type": "object"
|
|
2341
2948
|
},
|
|
2342
2949
|
"PlotTransformPreset": {
|
|
@@ -2748,9 +3355,50 @@
|
|
|
2748
3355
|
"minItems": 2,
|
|
2749
3356
|
"type": "array"
|
|
2750
3357
|
},
|
|
3358
|
+
"axisLabels": {
|
|
3359
|
+
"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.",
|
|
3360
|
+
"items": {
|
|
3361
|
+
"type": "string"
|
|
3362
|
+
},
|
|
3363
|
+
"type": "array",
|
|
3364
|
+
"uniqueItems": true
|
|
3365
|
+
},
|
|
3366
|
+
"categoricalColorMapInterpolator": {
|
|
3367
|
+
"$ref": "#/definitions/CategoricalColorMapInterpolator",
|
|
3368
|
+
"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."
|
|
3369
|
+
},
|
|
2751
3370
|
"color": {
|
|
3371
|
+
"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
3372
|
"type": "string"
|
|
2753
3373
|
},
|
|
3374
|
+
"colorMapDomain": {
|
|
3375
|
+
"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.",
|
|
3376
|
+
"items": {
|
|
3377
|
+
"type": "string"
|
|
3378
|
+
},
|
|
3379
|
+
"type": "array"
|
|
3380
|
+
},
|
|
3381
|
+
"colorMapInterpolator": {
|
|
3382
|
+
"$ref": "#/definitions/ContinuousColorMapInterpolator",
|
|
3383
|
+
"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."
|
|
3384
|
+
},
|
|
3385
|
+
"colorMapRange": {
|
|
3386
|
+
"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.",
|
|
3387
|
+
"items": [
|
|
3388
|
+
{
|
|
3389
|
+
"title": "low",
|
|
3390
|
+
"type": "number"
|
|
3391
|
+
},
|
|
3392
|
+
{
|
|
3393
|
+
"title": "high",
|
|
3394
|
+
"type": "number"
|
|
3395
|
+
}
|
|
3396
|
+
],
|
|
3397
|
+
"maxItems": 2,
|
|
3398
|
+
"minItems": 2,
|
|
3399
|
+
"type": "array",
|
|
3400
|
+
"uniqueItems": true
|
|
3401
|
+
},
|
|
2754
3402
|
"dataRef": {
|
|
2755
3403
|
"description": "Name of the table to plot.",
|
|
2756
3404
|
"type": "string"
|
|
@@ -2765,6 +3413,10 @@
|
|
|
2765
3413
|
"height": {
|
|
2766
3414
|
"type": "number"
|
|
2767
3415
|
},
|
|
3416
|
+
"highlightColor": {
|
|
3417
|
+
"$ref": "#/definitions/HexColor",
|
|
3418
|
+
"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."
|
|
3419
|
+
},
|
|
2768
3420
|
"id": {
|
|
2769
3421
|
"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
3422
|
"minLength": 1,
|
|
@@ -2801,6 +3453,28 @@
|
|
|
2801
3453
|
"const": "scatter",
|
|
2802
3454
|
"type": "string"
|
|
2803
3455
|
},
|
|
3456
|
+
"markColor": {
|
|
3457
|
+
"$ref": "#/definitions/HexColor",
|
|
3458
|
+
"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."
|
|
3459
|
+
},
|
|
3460
|
+
"normalization": {
|
|
3461
|
+
"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.",
|
|
3462
|
+
"properties": {
|
|
3463
|
+
"lowerPercentile": {
|
|
3464
|
+
"type": "number"
|
|
3465
|
+
},
|
|
3466
|
+
"mode": {
|
|
3467
|
+
"$ref": "#/definitions/NormalizationMode"
|
|
3468
|
+
},
|
|
3469
|
+
"upperPercentile": {
|
|
3470
|
+
"type": "number"
|
|
3471
|
+
}
|
|
3472
|
+
},
|
|
3473
|
+
"required": [
|
|
3474
|
+
"mode"
|
|
3475
|
+
],
|
|
3476
|
+
"type": "object"
|
|
3477
|
+
},
|
|
2804
3478
|
"osmElements": {
|
|
2805
3479
|
"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
3480
|
"type": "boolean"
|
|
@@ -2813,6 +3487,36 @@
|
|
|
2813
3487
|
"minItems": 1,
|
|
2814
3488
|
"type": "array"
|
|
2815
3489
|
},
|
|
3490
|
+
"selection": {
|
|
3491
|
+
"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.",
|
|
3492
|
+
"items": {
|
|
3493
|
+
"description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
|
|
3494
|
+
"minimum": 0,
|
|
3495
|
+
"multipleOf": 1,
|
|
3496
|
+
"type": "number"
|
|
3497
|
+
},
|
|
3498
|
+
"type": "array"
|
|
3499
|
+
},
|
|
3500
|
+
"tickFormats": {
|
|
3501
|
+
"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.",
|
|
3502
|
+
"items": [
|
|
3503
|
+
{
|
|
3504
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
3505
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
3506
|
+
"title": "x",
|
|
3507
|
+
"type": "string"
|
|
3508
|
+
},
|
|
3509
|
+
{
|
|
3510
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
3511
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
3512
|
+
"title": "y",
|
|
3513
|
+
"type": "string"
|
|
3514
|
+
}
|
|
3515
|
+
],
|
|
3516
|
+
"maxItems": 2,
|
|
3517
|
+
"minItems": 2,
|
|
3518
|
+
"type": "array"
|
|
3519
|
+
},
|
|
2816
3520
|
"title": {
|
|
2817
3521
|
"type": "string"
|
|
2818
3522
|
},
|
|
@@ -2877,9 +3581,50 @@
|
|
|
2877
3581
|
"minItems": 1,
|
|
2878
3582
|
"type": "array"
|
|
2879
3583
|
},
|
|
3584
|
+
"axisLabels": {
|
|
3585
|
+
"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.",
|
|
3586
|
+
"items": {
|
|
3587
|
+
"type": "string"
|
|
3588
|
+
},
|
|
3589
|
+
"type": "array",
|
|
3590
|
+
"uniqueItems": true
|
|
3591
|
+
},
|
|
3592
|
+
"categoricalColorMapInterpolator": {
|
|
3593
|
+
"$ref": "#/definitions/CategoricalColorMapInterpolator",
|
|
3594
|
+
"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."
|
|
3595
|
+
},
|
|
2880
3596
|
"color": {
|
|
3597
|
+
"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
3598
|
"type": "string"
|
|
2882
3599
|
},
|
|
3600
|
+
"colorMapDomain": {
|
|
3601
|
+
"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.",
|
|
3602
|
+
"items": {
|
|
3603
|
+
"type": "string"
|
|
3604
|
+
},
|
|
3605
|
+
"type": "array"
|
|
3606
|
+
},
|
|
3607
|
+
"colorMapInterpolator": {
|
|
3608
|
+
"$ref": "#/definitions/ContinuousColorMapInterpolator",
|
|
3609
|
+
"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."
|
|
3610
|
+
},
|
|
3611
|
+
"colorMapRange": {
|
|
3612
|
+
"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.",
|
|
3613
|
+
"items": [
|
|
3614
|
+
{
|
|
3615
|
+
"title": "low",
|
|
3616
|
+
"type": "number"
|
|
3617
|
+
},
|
|
3618
|
+
{
|
|
3619
|
+
"title": "high",
|
|
3620
|
+
"type": "number"
|
|
3621
|
+
}
|
|
3622
|
+
],
|
|
3623
|
+
"maxItems": 2,
|
|
3624
|
+
"minItems": 2,
|
|
3625
|
+
"type": "array",
|
|
3626
|
+
"uniqueItems": true
|
|
3627
|
+
},
|
|
2883
3628
|
"dataRef": {
|
|
2884
3629
|
"description": "Name of the table to plot.",
|
|
2885
3630
|
"type": "string"
|
|
@@ -2894,6 +3639,10 @@
|
|
|
2894
3639
|
"height": {
|
|
2895
3640
|
"type": "number"
|
|
2896
3641
|
},
|
|
3642
|
+
"highlightColor": {
|
|
3643
|
+
"$ref": "#/definitions/HexColor",
|
|
3644
|
+
"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."
|
|
3645
|
+
},
|
|
2897
3646
|
"id": {
|
|
2898
3647
|
"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
3648
|
"minLength": 1,
|
|
@@ -2930,6 +3679,28 @@
|
|
|
2930
3679
|
"const": "table",
|
|
2931
3680
|
"type": "string"
|
|
2932
3681
|
},
|
|
3682
|
+
"markColor": {
|
|
3683
|
+
"$ref": "#/definitions/HexColor",
|
|
3684
|
+
"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."
|
|
3685
|
+
},
|
|
3686
|
+
"normalization": {
|
|
3687
|
+
"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.",
|
|
3688
|
+
"properties": {
|
|
3689
|
+
"lowerPercentile": {
|
|
3690
|
+
"type": "number"
|
|
3691
|
+
},
|
|
3692
|
+
"mode": {
|
|
3693
|
+
"$ref": "#/definitions/NormalizationMode"
|
|
3694
|
+
},
|
|
3695
|
+
"upperPercentile": {
|
|
3696
|
+
"type": "number"
|
|
3697
|
+
}
|
|
3698
|
+
},
|
|
3699
|
+
"required": [
|
|
3700
|
+
"mode"
|
|
3701
|
+
],
|
|
3702
|
+
"type": "object"
|
|
3703
|
+
},
|
|
2933
3704
|
"osmElements": {
|
|
2934
3705
|
"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
3706
|
"type": "boolean"
|
|
@@ -2942,6 +3713,36 @@
|
|
|
2942
3713
|
"minItems": 1,
|
|
2943
3714
|
"type": "array"
|
|
2944
3715
|
},
|
|
3716
|
+
"selection": {
|
|
3717
|
+
"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.",
|
|
3718
|
+
"items": {
|
|
3719
|
+
"description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
|
|
3720
|
+
"minimum": 0,
|
|
3721
|
+
"multipleOf": 1,
|
|
3722
|
+
"type": "number"
|
|
3723
|
+
},
|
|
3724
|
+
"type": "array"
|
|
3725
|
+
},
|
|
3726
|
+
"tickFormats": {
|
|
3727
|
+
"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.",
|
|
3728
|
+
"items": [
|
|
3729
|
+
{
|
|
3730
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
3731
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
3732
|
+
"title": "x",
|
|
3733
|
+
"type": "string"
|
|
3734
|
+
},
|
|
3735
|
+
{
|
|
3736
|
+
"description": "A d3-format specifier, such as `~s`, `,d`, `.2f` or `.0%`: d3-format's `[[fill]align][sign][symbol][0][width][,][.precision][~][type]`.",
|
|
3737
|
+
"pattern": "^(?:.?[<>=^])?[-+( ]?[$#]?0?\\d*,?(?:\\.\\d+)?~?[a-zA-Z%]?$",
|
|
3738
|
+
"title": "y",
|
|
3739
|
+
"type": "string"
|
|
3740
|
+
}
|
|
3741
|
+
],
|
|
3742
|
+
"maxItems": 2,
|
|
3743
|
+
"minItems": 2,
|
|
3744
|
+
"type": "array"
|
|
3745
|
+
},
|
|
2945
3746
|
"title": {
|
|
2946
3747
|
"type": "string"
|
|
2947
3748
|
},
|
|
@@ -2963,6 +3764,25 @@
|
|
|
2963
3764
|
],
|
|
2964
3765
|
"type": "object"
|
|
2965
3766
|
},
|
|
3767
|
+
"TerrainSpec": {
|
|
3768
|
+
"description": "The ground of a map in 3D, raised to the heights a raster band gives. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
3769
|
+
"properties": {
|
|
3770
|
+
"band": {
|
|
3771
|
+
"description": "The band of heights, by its id (`band_1`, ...) or its label, as a raster layer's `getFnv` names one. Defaults to the first band. On a raster of several bands, a band that names none of them is refused.",
|
|
3772
|
+
"minLength": 1,
|
|
3773
|
+
"type": "string"
|
|
3774
|
+
},
|
|
3775
|
+
"dataRef": {
|
|
3776
|
+
"description": "Name of the raster table whose band gives the ground's height in each of its cells, in the workspace's units, such as a `geotiff` source of an elevation model in meters. It is a table of the map's workspace. A cell without a value lies at height 0.",
|
|
3777
|
+
"minLength": 1,
|
|
3778
|
+
"type": "string"
|
|
3779
|
+
}
|
|
3780
|
+
},
|
|
3781
|
+
"required": [
|
|
3782
|
+
"dataRef"
|
|
3783
|
+
],
|
|
3784
|
+
"type": "object"
|
|
3785
|
+
},
|
|
2966
3786
|
"UpdateSourceSpec": {
|
|
2967
3787
|
"description": "Replaces or changes the rows of a table already loaded, with rows given inline: a FeatureCollection for a table with a geometry, an array of objects for a table without one. Read by the Autark adapter only.",
|
|
2968
3788
|
"else": {
|