@urban-toolkit/autk-grammar 5.0.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 +245 -8
- package/build/autk-grammar-schema.json +999 -4
- package/dist/autk-grammar.js +833 -597
- 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.d.ts +172 -5
- package/dist/data/autk-grammar-data.js +220 -116
- package/dist/data/autk-grammar-data.js.map +1 -1
- package/dist/index.d.ts +315 -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,32 @@
|
|
|
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
|
+
},
|
|
171
|
+
"osmElements": {
|
|
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.",
|
|
173
|
+
"type": "boolean"
|
|
174
|
+
},
|
|
104
175
|
"selectFields": {
|
|
105
176
|
"description": "Columns whose values name the rows a selection in this plot selects, so an app can link the selection to other tables that hold those columns. Neither adapter reads it: the Autark adapter's `plot:selection` events still report feature ids.",
|
|
106
177
|
"items": {
|
|
@@ -109,6 +180,36 @@
|
|
|
109
180
|
"minItems": 1,
|
|
110
181
|
"type": "array"
|
|
111
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
|
+
},
|
|
112
213
|
"title": {
|
|
113
214
|
"type": "string"
|
|
114
215
|
},
|
|
@@ -163,8 +264,8 @@
|
|
|
163
264
|
"type": "number"
|
|
164
265
|
},
|
|
165
266
|
"pitch": {
|
|
166
|
-
"description": "Tilt from straight down, in degrees.",
|
|
167
|
-
"
|
|
267
|
+
"description": "Tilt from straight down, in degrees, less than 90: at 90 the eye would sit on the ground, edge-on to the map's flat layers, and the map could not pan.",
|
|
268
|
+
"exclusiveMaximum": 90,
|
|
168
269
|
"minimum": 0,
|
|
169
270
|
"type": "number"
|
|
170
271
|
},
|
|
@@ -176,6 +277,23 @@
|
|
|
176
277
|
},
|
|
177
278
|
"type": "object"
|
|
178
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
|
+
},
|
|
179
297
|
"ColorMapInterpolator": {
|
|
180
298
|
"description": "Color scheme for a colored map layer: `scheme*` names are categorical, `interpolate*` names are sequential or diverging.",
|
|
181
299
|
"enum": [
|
|
@@ -240,6 +358,48 @@
|
|
|
240
358
|
],
|
|
241
359
|
"description": "One entry of `compute`. A pass with `type: 'render'` is a {@link RenderComputeSpec } , any other a {@link GpgpuComputeSpec } ."
|
|
242
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
|
+
},
|
|
243
403
|
"CsvDataSourceSpec": {
|
|
244
404
|
"description": "Loads a CSV table from exactly one of `csvFileUrl` or `csvObject`.",
|
|
245
405
|
"else": {
|
|
@@ -440,6 +600,45 @@
|
|
|
440
600
|
"then": {
|
|
441
601
|
"$ref": "#/definitions/JoinSourceSpec"
|
|
442
602
|
}
|
|
603
|
+
},
|
|
604
|
+
{
|
|
605
|
+
"if": {
|
|
606
|
+
"properties": {
|
|
607
|
+
"type": {
|
|
608
|
+
"const": "sql",
|
|
609
|
+
"type": "string"
|
|
610
|
+
}
|
|
611
|
+
}
|
|
612
|
+
},
|
|
613
|
+
"then": {
|
|
614
|
+
"$ref": "#/definitions/SqlSourceSpec"
|
|
615
|
+
}
|
|
616
|
+
},
|
|
617
|
+
{
|
|
618
|
+
"if": {
|
|
619
|
+
"properties": {
|
|
620
|
+
"type": {
|
|
621
|
+
"const": "update",
|
|
622
|
+
"type": "string"
|
|
623
|
+
}
|
|
624
|
+
}
|
|
625
|
+
},
|
|
626
|
+
"then": {
|
|
627
|
+
"$ref": "#/definitions/UpdateSourceSpec"
|
|
628
|
+
}
|
|
629
|
+
},
|
|
630
|
+
{
|
|
631
|
+
"if": {
|
|
632
|
+
"properties": {
|
|
633
|
+
"type": {
|
|
634
|
+
"const": "drop",
|
|
635
|
+
"type": "string"
|
|
636
|
+
}
|
|
637
|
+
}
|
|
638
|
+
},
|
|
639
|
+
"then": {
|
|
640
|
+
"$ref": "#/definitions/DropSourceSpec"
|
|
641
|
+
}
|
|
443
642
|
}
|
|
444
643
|
],
|
|
445
644
|
"description": "One entry of `data`. The `type` field selects which fields apply.",
|
|
@@ -452,7 +651,10 @@
|
|
|
452
651
|
"geojson",
|
|
453
652
|
"geotiff",
|
|
454
653
|
"heatmap",
|
|
455
|
-
"join"
|
|
654
|
+
"join",
|
|
655
|
+
"sql",
|
|
656
|
+
"update",
|
|
657
|
+
"drop"
|
|
456
658
|
]
|
|
457
659
|
}
|
|
458
660
|
},
|
|
@@ -461,6 +663,28 @@
|
|
|
461
663
|
],
|
|
462
664
|
"type": "object"
|
|
463
665
|
},
|
|
666
|
+
"DropSourceSpec": {
|
|
667
|
+
"description": "Drops a table, so the sources, compute passes, maps and plots after it no longer find it, and `AutkGrammar.data` no longer lists it. Read by the Autark adapter only.",
|
|
668
|
+
"properties": {
|
|
669
|
+
"dataRef": {
|
|
670
|
+
"description": "The table to drop.",
|
|
671
|
+
"type": "string"
|
|
672
|
+
},
|
|
673
|
+
"type": {
|
|
674
|
+
"const": "drop",
|
|
675
|
+
"type": "string"
|
|
676
|
+
},
|
|
677
|
+
"workspace": {
|
|
678
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
679
|
+
"description": "Workspace of the table."
|
|
680
|
+
}
|
|
681
|
+
},
|
|
682
|
+
"required": [
|
|
683
|
+
"type",
|
|
684
|
+
"dataRef"
|
|
685
|
+
],
|
|
686
|
+
"type": "object"
|
|
687
|
+
},
|
|
464
688
|
"FromFeatureDirective": {
|
|
465
689
|
"description": "Reads a uniform's value from a feature of a loaded table instead of writing it inline.",
|
|
466
690
|
"properties": {
|
|
@@ -500,7 +724,7 @@
|
|
|
500
724
|
"type": "string"
|
|
501
725
|
},
|
|
502
726
|
"layer": {
|
|
503
|
-
"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.",
|
|
504
728
|
"type": "string"
|
|
505
729
|
},
|
|
506
730
|
"path": {
|
|
@@ -991,6 +1215,10 @@
|
|
|
991
1215
|
},
|
|
992
1216
|
"column": {
|
|
993
1217
|
"type": "string"
|
|
1218
|
+
},
|
|
1219
|
+
"normalize": {
|
|
1220
|
+
"description": "Rescale the band's values from 0 to 1 across the grid's cells. It needs an autk-db with urban-toolkit/autark#132, which also adds `_norm` to the band's label; autk-db 4.1.1 builds the band from the values as they are.",
|
|
1221
|
+
"type": "boolean"
|
|
994
1222
|
}
|
|
995
1223
|
},
|
|
996
1224
|
"required": [
|
|
@@ -1054,9 +1282,50 @@
|
|
|
1054
1282
|
"minItems": 1,
|
|
1055
1283
|
"type": "array"
|
|
1056
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
|
+
},
|
|
1057
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.",
|
|
1058
1299
|
"type": "string"
|
|
1059
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
|
+
},
|
|
1060
1329
|
"dataRef": {
|
|
1061
1330
|
"description": "Name of the table to plot.",
|
|
1062
1331
|
"type": "string"
|
|
@@ -1071,6 +1340,10 @@
|
|
|
1071
1340
|
"height": {
|
|
1072
1341
|
"type": "number"
|
|
1073
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
|
+
},
|
|
1074
1347
|
"id": {
|
|
1075
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.",
|
|
1076
1349
|
"minLength": 1,
|
|
@@ -1107,6 +1380,32 @@
|
|
|
1107
1380
|
"const": "heatmatrix",
|
|
1108
1381
|
"type": "string"
|
|
1109
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
|
+
},
|
|
1405
|
+
"osmElements": {
|
|
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.",
|
|
1407
|
+
"type": "boolean"
|
|
1408
|
+
},
|
|
1110
1409
|
"selectFields": {
|
|
1111
1410
|
"description": "Columns whose values name the rows a selection in this plot selects, so an app can link the selection to other tables that hold those columns. Neither adapter reads it: the Autark adapter's `plot:selection` events still report feature ids.",
|
|
1112
1411
|
"items": {
|
|
@@ -1115,6 +1414,36 @@
|
|
|
1115
1414
|
"minItems": 1,
|
|
1116
1415
|
"type": "array"
|
|
1117
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
|
+
},
|
|
1118
1447
|
"title": {
|
|
1119
1448
|
"type": "string"
|
|
1120
1449
|
},
|
|
@@ -1388,9 +1717,50 @@
|
|
|
1388
1717
|
"minItems": 1,
|
|
1389
1718
|
"type": "array"
|
|
1390
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
|
+
},
|
|
1391
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.",
|
|
1392
1734
|
"type": "string"
|
|
1393
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
|
+
},
|
|
1394
1764
|
"dataRef": {
|
|
1395
1765
|
"description": "Name of the table to plot.",
|
|
1396
1766
|
"type": "string"
|
|
@@ -1405,6 +1775,10 @@
|
|
|
1405
1775
|
"height": {
|
|
1406
1776
|
"type": "number"
|
|
1407
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
|
+
},
|
|
1408
1782
|
"id": {
|
|
1409
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.",
|
|
1410
1784
|
"minLength": 1,
|
|
@@ -1444,6 +1818,32 @@
|
|
|
1444
1818
|
],
|
|
1445
1819
|
"type": "string"
|
|
1446
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
|
+
},
|
|
1843
|
+
"osmElements": {
|
|
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.",
|
|
1845
|
+
"type": "boolean"
|
|
1846
|
+
},
|
|
1447
1847
|
"selectFields": {
|
|
1448
1848
|
"description": "Columns whose values name the rows a selection in this plot selects, so an app can link the selection to other tables that hold those columns. Neither adapter reads it: the Autark adapter's `plot:selection` events still report feature ids.",
|
|
1449
1849
|
"items": {
|
|
@@ -1452,6 +1852,36 @@
|
|
|
1452
1852
|
"minItems": 1,
|
|
1453
1853
|
"type": "array"
|
|
1454
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
|
+
},
|
|
1455
1885
|
"title": {
|
|
1456
1886
|
"type": "string"
|
|
1457
1887
|
},
|
|
@@ -1639,6 +2069,10 @@
|
|
|
1639
2069
|
"description": "Layer opacity, from 0 to 1.",
|
|
1640
2070
|
"type": "number"
|
|
1641
2071
|
},
|
|
2072
|
+
"osmElements": {
|
|
2073
|
+
"description": "Draw an OpenStreetMap layer table as one feature per OSM element it was built from, each with the element's tags, `osm_type` and `osm_id` as its properties (and `building_id` in a buildings table, whose parts are elements of their own), rather than one feature per row. A table that is not an OSM layer, a surface, and an OSM table an update changed are drawn row by row, as without it. Read by the Autark adapter only.",
|
|
2074
|
+
"type": "boolean"
|
|
2075
|
+
},
|
|
1642
2076
|
"pickedComps": {
|
|
1643
2077
|
"description": "Feature ids drawn as picked. Read by the deck.gl adapter; the Autark adapter ignores it.",
|
|
1644
2078
|
"items": {
|
|
@@ -1878,10 +2312,19 @@
|
|
|
1878
2312
|
},
|
|
1879
2313
|
"OsmDataSourceSpec": {
|
|
1880
2314
|
"description": "Loads OpenStreetMap data for a named area or a box, from Overpass or from a PBF extract.",
|
|
2315
|
+
"if": {
|
|
2316
|
+
"required": [
|
|
2317
|
+
"pbfFileUrl"
|
|
2318
|
+
]
|
|
2319
|
+
},
|
|
1881
2320
|
"properties": {
|
|
1882
2321
|
"autoLoadLayers": {
|
|
1883
2322
|
"description": "Split the raw OSM table into one table per layer, named `<outputTableName>_<layer>`.",
|
|
1884
2323
|
"properties": {
|
|
2324
|
+
"coordinateFormat": {
|
|
2325
|
+
"description": "CRS of the OpenStreetMap data's coordinates, as an EPSG string. Defaults to `'EPSG:4326'`, the degrees the Overpass API and OpenStreetMap's extracts give. The layers and the tag sets are read in it. Read by the Autark adapter only.",
|
|
2326
|
+
"type": "string"
|
|
2327
|
+
},
|
|
1885
2328
|
"dropOsmTable": {
|
|
1886
2329
|
"description": "Currently ignored by both adapters.",
|
|
1887
2330
|
"type": "boolean"
|
|
@@ -1898,6 +2341,10 @@
|
|
|
1898
2341
|
],
|
|
1899
2342
|
"type": "object"
|
|
1900
2343
|
},
|
|
2344
|
+
"forceRefresh": {
|
|
2345
|
+
"description": "Query the Overpass API again rather than read the answer the browser cached for this area, its layers and its tag sets, which autk-db keeps for 24 hours. A source with `pbfFileUrl` reads its file each time and ignores it. Read by the Autark adapter only.",
|
|
2346
|
+
"type": "boolean"
|
|
2347
|
+
},
|
|
1901
2348
|
"outputTableName": {
|
|
1902
2349
|
"description": "Name of the table this source creates. Later sources, compute passes, maps and plots refer to it by this name.",
|
|
1903
2350
|
"type": "string"
|
|
@@ -1917,6 +2364,14 @@
|
|
|
1917
2364
|
],
|
|
1918
2365
|
"description": "Area to load: sub-areas inside a geocoded region (`geocodeArea` with `areas`), or a box (`bbox`), not both."
|
|
1919
2366
|
},
|
|
2367
|
+
"tagSets": {
|
|
2368
|
+
"description": "Features chosen by their tags, each set as a table of its own, `<outputTableName>_<name>_<type>`, cut to the area. A set that matches no feature in the area makes no table. Read from the Overpass API only: a source with `pbfFileUrl` cannot take them. Read by the Autark adapter only.",
|
|
2369
|
+
"items": {
|
|
2370
|
+
"$ref": "#/definitions/OsmTagSet"
|
|
2371
|
+
},
|
|
2372
|
+
"maxItems": 8,
|
|
2373
|
+
"type": "array"
|
|
2374
|
+
},
|
|
1920
2375
|
"type": {
|
|
1921
2376
|
"const": "osm",
|
|
1922
2377
|
"type": "string"
|
|
@@ -1931,6 +2386,18 @@
|
|
|
1931
2386
|
"queryArea",
|
|
1932
2387
|
"type"
|
|
1933
2388
|
],
|
|
2389
|
+
"then": {
|
|
2390
|
+
"not": {
|
|
2391
|
+
"properties": {
|
|
2392
|
+
"tagSets": {
|
|
2393
|
+
"minItems": 1
|
|
2394
|
+
}
|
|
2395
|
+
},
|
|
2396
|
+
"required": [
|
|
2397
|
+
"tagSets"
|
|
2398
|
+
]
|
|
2399
|
+
}
|
|
2400
|
+
},
|
|
1934
2401
|
"type": "object"
|
|
1935
2402
|
},
|
|
1936
2403
|
"OsmNamedArea": {
|
|
@@ -1958,6 +2425,60 @@
|
|
|
1958
2425
|
],
|
|
1959
2426
|
"type": "object"
|
|
1960
2427
|
},
|
|
2428
|
+
"OsmTagFilter": {
|
|
2429
|
+
"description": "An OpenStreetMap tag a tag set matches: the tag `key` with the value `value`, or with any value when `value` is omitted.",
|
|
2430
|
+
"properties": {
|
|
2431
|
+
"key": {
|
|
2432
|
+
"description": "The tag's key, such as `amenity` or `addr:street`: letters, digits, `_`, `:`, `.` and `-`, starting with a letter or a digit.",
|
|
2433
|
+
"pattern": "^[A-Za-z0-9][A-Za-z0-9_:.-]{0,254}$",
|
|
2434
|
+
"type": "string"
|
|
2435
|
+
},
|
|
2436
|
+
"value": {
|
|
2437
|
+
"description": "The tag's value, such as `cafe`. Without it, the key with any value matches.",
|
|
2438
|
+
"maxLength": 255,
|
|
2439
|
+
"minLength": 1,
|
|
2440
|
+
"type": "string"
|
|
2441
|
+
}
|
|
2442
|
+
},
|
|
2443
|
+
"required": [
|
|
2444
|
+
"key"
|
|
2445
|
+
],
|
|
2446
|
+
"type": "object"
|
|
2447
|
+
},
|
|
2448
|
+
"OsmTagSet": {
|
|
2449
|
+
"description": "OpenStreetMap features chosen by their tags, as one table of one geometry type.",
|
|
2450
|
+
"properties": {
|
|
2451
|
+
"name": {
|
|
2452
|
+
"description": "Names the set's table, `<outputTableName>_<name>_<type>`: a lowercase letter, then up to 31 lowercase letters, digits or `_`. No two sets of a source share a name.",
|
|
2453
|
+
"pattern": "^[a-z][a-z0-9_]{0,31}$",
|
|
2454
|
+
"type": "string"
|
|
2455
|
+
},
|
|
2456
|
+
"tags": {
|
|
2457
|
+
"description": "The tags a feature is chosen by: it is in the set when it has any one of them.",
|
|
2458
|
+
"items": {
|
|
2459
|
+
"$ref": "#/definitions/OsmTagFilter"
|
|
2460
|
+
},
|
|
2461
|
+
"maxItems": 64,
|
|
2462
|
+
"minItems": 1,
|
|
2463
|
+
"type": "array"
|
|
2464
|
+
},
|
|
2465
|
+
"type": {
|
|
2466
|
+
"description": "The geometry the table holds: `points`, the tagged nodes; `polylines`, the open ways and the ways tagged as lines (`highway`, `barrier`, `railway`, `waterway`, or `area=no`); `polygons`, the other closed ways and the multipolygon relations.",
|
|
2467
|
+
"enum": [
|
|
2468
|
+
"points",
|
|
2469
|
+
"polylines",
|
|
2470
|
+
"polygons"
|
|
2471
|
+
],
|
|
2472
|
+
"type": "string"
|
|
2473
|
+
}
|
|
2474
|
+
},
|
|
2475
|
+
"required": [
|
|
2476
|
+
"name",
|
|
2477
|
+
"type",
|
|
2478
|
+
"tags"
|
|
2479
|
+
],
|
|
2480
|
+
"type": "object"
|
|
2481
|
+
},
|
|
1961
2482
|
"ParallelCoordinatesPlotSpec": {
|
|
1962
2483
|
"description": "Parallel coordinates over the plotted columns.",
|
|
1963
2484
|
"properties": {
|
|
@@ -1969,9 +2490,50 @@
|
|
|
1969
2490
|
"minItems": 1,
|
|
1970
2491
|
"type": "array"
|
|
1971
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
|
+
},
|
|
1972
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.",
|
|
1973
2507
|
"type": "string"
|
|
1974
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
|
+
},
|
|
1975
2537
|
"dataRef": {
|
|
1976
2538
|
"description": "Name of the table to plot.",
|
|
1977
2539
|
"type": "string"
|
|
@@ -1986,6 +2548,10 @@
|
|
|
1986
2548
|
"height": {
|
|
1987
2549
|
"type": "number"
|
|
1988
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
|
+
},
|
|
1989
2555
|
"id": {
|
|
1990
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.",
|
|
1991
2557
|
"minLength": 1,
|
|
@@ -2022,6 +2588,32 @@
|
|
|
2022
2588
|
"const": "parallel-coordinates",
|
|
2023
2589
|
"type": "string"
|
|
2024
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
|
+
},
|
|
2613
|
+
"osmElements": {
|
|
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.",
|
|
2615
|
+
"type": "boolean"
|
|
2616
|
+
},
|
|
2025
2617
|
"selectFields": {
|
|
2026
2618
|
"description": "Columns whose values name the rows a selection in this plot selects, so an app can link the selection to other tables that hold those columns. Neither adapter reads it: the Autark adapter's `plot:selection` events still report feature ids.",
|
|
2027
2619
|
"items": {
|
|
@@ -2030,6 +2622,36 @@
|
|
|
2030
2622
|
"minItems": 1,
|
|
2031
2623
|
"type": "array"
|
|
2032
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
|
+
},
|
|
2033
2655
|
"title": {
|
|
2034
2656
|
"type": "string"
|
|
2035
2657
|
},
|
|
@@ -2146,6 +2768,11 @@
|
|
|
2146
2768
|
}
|
|
2147
2769
|
],
|
|
2148
2770
|
"description": "A plot view. The `mark` field selects which transforms apply.",
|
|
2771
|
+
"if": {
|
|
2772
|
+
"required": [
|
|
2773
|
+
"colorMapRange"
|
|
2774
|
+
]
|
|
2775
|
+
},
|
|
2149
2776
|
"properties": {
|
|
2150
2777
|
"mark": {
|
|
2151
2778
|
"enum": [
|
|
@@ -2162,6 +2789,13 @@
|
|
|
2162
2789
|
"required": [
|
|
2163
2790
|
"mark"
|
|
2164
2791
|
],
|
|
2792
|
+
"then": {
|
|
2793
|
+
"not": {
|
|
2794
|
+
"required": [
|
|
2795
|
+
"colorMapDomain"
|
|
2796
|
+
]
|
|
2797
|
+
}
|
|
2798
|
+
},
|
|
2165
2799
|
"type": "object"
|
|
2166
2800
|
},
|
|
2167
2801
|
"PlotTransformPreset": {
|
|
@@ -2573,9 +3207,50 @@
|
|
|
2573
3207
|
"minItems": 2,
|
|
2574
3208
|
"type": "array"
|
|
2575
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
|
+
},
|
|
2576
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.",
|
|
2577
3224
|
"type": "string"
|
|
2578
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
|
+
},
|
|
2579
3254
|
"dataRef": {
|
|
2580
3255
|
"description": "Name of the table to plot.",
|
|
2581
3256
|
"type": "string"
|
|
@@ -2590,6 +3265,10 @@
|
|
|
2590
3265
|
"height": {
|
|
2591
3266
|
"type": "number"
|
|
2592
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
|
+
},
|
|
2593
3272
|
"id": {
|
|
2594
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.",
|
|
2595
3274
|
"minLength": 1,
|
|
@@ -2626,6 +3305,32 @@
|
|
|
2626
3305
|
"const": "scatter",
|
|
2627
3306
|
"type": "string"
|
|
2628
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
|
+
},
|
|
3330
|
+
"osmElements": {
|
|
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.",
|
|
3332
|
+
"type": "boolean"
|
|
3333
|
+
},
|
|
2629
3334
|
"selectFields": {
|
|
2630
3335
|
"description": "Columns whose values name the rows a selection in this plot selects, so an app can link the selection to other tables that hold those columns. Neither adapter reads it: the Autark adapter's `plot:selection` events still report feature ids.",
|
|
2631
3336
|
"items": {
|
|
@@ -2634,6 +3339,36 @@
|
|
|
2634
3339
|
"minItems": 1,
|
|
2635
3340
|
"type": "array"
|
|
2636
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
|
+
},
|
|
2637
3372
|
"title": {
|
|
2638
3373
|
"type": "string"
|
|
2639
3374
|
},
|
|
@@ -2655,6 +3390,38 @@
|
|
|
2655
3390
|
],
|
|
2656
3391
|
"type": "object"
|
|
2657
3392
|
},
|
|
3393
|
+
"SqlSourceSpec": {
|
|
3394
|
+
"description": "Saves the rows of a SQL query over the workspace's tables as a new table. Read by the Autark adapter only.",
|
|
3395
|
+
"properties": {
|
|
3396
|
+
"layerType": {
|
|
3397
|
+
"$ref": "#/definitions/LayerType",
|
|
3398
|
+
"description": "How a map draws the new table, whose geometry must then be in a column named `geometry`, in the workspace's CRS, as the workspace's tables hold it. Without it, the table has no layer type: a plot draws its rows, while a map does not draw it and `AutkGrammar.data` does not list it."
|
|
3399
|
+
},
|
|
3400
|
+
"outputTableName": {
|
|
3401
|
+
"description": "Name of the table this source creates. Later sources, compute passes, maps and plots refer to it by this name.",
|
|
3402
|
+
"type": "string"
|
|
3403
|
+
},
|
|
3404
|
+
"query": {
|
|
3405
|
+
"description": "A `SELECT`, or a `WITH` query that ends in one, in DuckDB's SQL, over the tables of the source's workspace by their names. autk-db refuses any other statement, and any query in which `insert`, `update`, `delete`, `create`, `alter`, `drop`, `truncate` or `replace` appears as a word, even inside a string.",
|
|
3406
|
+
"minLength": 1,
|
|
3407
|
+
"type": "string"
|
|
3408
|
+
},
|
|
3409
|
+
"type": {
|
|
3410
|
+
"const": "sql",
|
|
3411
|
+
"type": "string"
|
|
3412
|
+
},
|
|
3413
|
+
"workspace": {
|
|
3414
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
3415
|
+
"description": "Workspace the table is created in."
|
|
3416
|
+
}
|
|
3417
|
+
},
|
|
3418
|
+
"required": [
|
|
3419
|
+
"outputTableName",
|
|
3420
|
+
"query",
|
|
3421
|
+
"type"
|
|
3422
|
+
],
|
|
3423
|
+
"type": "object"
|
|
3424
|
+
},
|
|
2658
3425
|
"TablePlotSpec": {
|
|
2659
3426
|
"description": "A table. A transform, when given, must be `sort`.",
|
|
2660
3427
|
"properties": {
|
|
@@ -2666,9 +3433,50 @@
|
|
|
2666
3433
|
"minItems": 1,
|
|
2667
3434
|
"type": "array"
|
|
2668
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
|
+
},
|
|
2669
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.",
|
|
2670
3450
|
"type": "string"
|
|
2671
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
|
+
},
|
|
2672
3480
|
"dataRef": {
|
|
2673
3481
|
"description": "Name of the table to plot.",
|
|
2674
3482
|
"type": "string"
|
|
@@ -2683,6 +3491,10 @@
|
|
|
2683
3491
|
"height": {
|
|
2684
3492
|
"type": "number"
|
|
2685
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
|
+
},
|
|
2686
3498
|
"id": {
|
|
2687
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.",
|
|
2688
3500
|
"minLength": 1,
|
|
@@ -2719,6 +3531,32 @@
|
|
|
2719
3531
|
"const": "table",
|
|
2720
3532
|
"type": "string"
|
|
2721
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
|
+
},
|
|
3556
|
+
"osmElements": {
|
|
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.",
|
|
3558
|
+
"type": "boolean"
|
|
3559
|
+
},
|
|
2722
3560
|
"selectFields": {
|
|
2723
3561
|
"description": "Columns whose values name the rows a selection in this plot selects, so an app can link the selection to other tables that hold those columns. Neither adapter reads it: the Autark adapter's `plot:selection` events still report feature ids.",
|
|
2724
3562
|
"items": {
|
|
@@ -2727,6 +3565,36 @@
|
|
|
2727
3565
|
"minItems": 1,
|
|
2728
3566
|
"type": "array"
|
|
2729
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
|
+
},
|
|
2730
3598
|
"title": {
|
|
2731
3599
|
"type": "string"
|
|
2732
3600
|
},
|
|
@@ -2748,6 +3616,102 @@
|
|
|
2748
3616
|
],
|
|
2749
3617
|
"type": "object"
|
|
2750
3618
|
},
|
|
3619
|
+
"UpdateSourceSpec": {
|
|
3620
|
+
"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.",
|
|
3621
|
+
"else": {
|
|
3622
|
+
"if": {
|
|
3623
|
+
"properties": {
|
|
3624
|
+
"strategy": {
|
|
3625
|
+
"const": "update"
|
|
3626
|
+
}
|
|
3627
|
+
},
|
|
3628
|
+
"required": [
|
|
3629
|
+
"strategy"
|
|
3630
|
+
]
|
|
3631
|
+
},
|
|
3632
|
+
"required": [
|
|
3633
|
+
"jsonObject"
|
|
3634
|
+
],
|
|
3635
|
+
"then": {
|
|
3636
|
+
"required": [
|
|
3637
|
+
"idColumn"
|
|
3638
|
+
]
|
|
3639
|
+
}
|
|
3640
|
+
},
|
|
3641
|
+
"if": {
|
|
3642
|
+
"required": [
|
|
3643
|
+
"geojsonObject"
|
|
3644
|
+
]
|
|
3645
|
+
},
|
|
3646
|
+
"properties": {
|
|
3647
|
+
"dataRef": {
|
|
3648
|
+
"description": "The table to change.",
|
|
3649
|
+
"type": "string"
|
|
3650
|
+
},
|
|
3651
|
+
"geojsonObject": {
|
|
3652
|
+
"$ref": "#/definitions/InlineFeatureCollection",
|
|
3653
|
+
"description": "The rows of a table with a geometry. autk-db stores their coordinates as they come, so they are in the workspace's CRS, as `AutkGrammar.data` gives a table's features."
|
|
3654
|
+
},
|
|
3655
|
+
"idColumn": {
|
|
3656
|
+
"description": "With `update`, the column that matches a given row to the table's rows: a column such as `month`, or a feature property as `properties.<name>`, such as `properties.parcel_id`.",
|
|
3657
|
+
"minLength": 1,
|
|
3658
|
+
"type": "string"
|
|
3659
|
+
},
|
|
3660
|
+
"jsonObject": {
|
|
3661
|
+
"description": "The rows of a table without a geometry, such as a CSV or JSON table loaded without `geometryColumns`.",
|
|
3662
|
+
"items": {
|
|
3663
|
+
"additionalProperties": {},
|
|
3664
|
+
"type": "object"
|
|
3665
|
+
},
|
|
3666
|
+
"minItems": 1,
|
|
3667
|
+
"type": "array"
|
|
3668
|
+
},
|
|
3669
|
+
"strategy": {
|
|
3670
|
+
"description": "`replace` swaps every row of the table for the given rows. `update` changes the rows whose `idColumn` value a given row has: in a table with a geometry, each takes the given row's geometry and properties, and no row is added; in a table without one, the given rows replace them, and those that match no row are added.",
|
|
3671
|
+
"enum": [
|
|
3672
|
+
"replace",
|
|
3673
|
+
"update"
|
|
3674
|
+
],
|
|
3675
|
+
"type": "string"
|
|
3676
|
+
},
|
|
3677
|
+
"type": {
|
|
3678
|
+
"const": "update",
|
|
3679
|
+
"type": "string"
|
|
3680
|
+
},
|
|
3681
|
+
"workspace": {
|
|
3682
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
3683
|
+
"description": "Workspace of the table."
|
|
3684
|
+
}
|
|
3685
|
+
},
|
|
3686
|
+
"required": [
|
|
3687
|
+
"type",
|
|
3688
|
+
"dataRef",
|
|
3689
|
+
"strategy"
|
|
3690
|
+
],
|
|
3691
|
+
"then": {
|
|
3692
|
+
"if": {
|
|
3693
|
+
"properties": {
|
|
3694
|
+
"strategy": {
|
|
3695
|
+
"const": "update"
|
|
3696
|
+
}
|
|
3697
|
+
},
|
|
3698
|
+
"required": [
|
|
3699
|
+
"strategy"
|
|
3700
|
+
]
|
|
3701
|
+
},
|
|
3702
|
+
"not": {
|
|
3703
|
+
"required": [
|
|
3704
|
+
"jsonObject"
|
|
3705
|
+
]
|
|
3706
|
+
},
|
|
3707
|
+
"then": {
|
|
3708
|
+
"required": [
|
|
3709
|
+
"idColumn"
|
|
3710
|
+
]
|
|
3711
|
+
}
|
|
3712
|
+
},
|
|
3713
|
+
"type": "object"
|
|
3714
|
+
},
|
|
2751
3715
|
"UrbanSpec": {
|
|
2752
3716
|
"description": "An Autark grammar specification. It names at least one of `data`, `compute`, `map` or `plot`.",
|
|
2753
3717
|
"properties": {
|
|
@@ -2807,6 +3771,13 @@
|
|
|
2807
3771
|
}
|
|
2808
3772
|
],
|
|
2809
3773
|
"description": "One plot, or several."
|
|
3774
|
+
},
|
|
3775
|
+
"workspaces": {
|
|
3776
|
+
"description": "How workspaces store their tables, one entry per workspace, set before the first source loads. A workspace without an entry keeps autk-db's CRS and grid. Read by the Autark adapter only.",
|
|
3777
|
+
"items": {
|
|
3778
|
+
"$ref": "#/definitions/WorkspaceSpec"
|
|
3779
|
+
},
|
|
3780
|
+
"type": "array"
|
|
2810
3781
|
}
|
|
2811
3782
|
},
|
|
2812
3783
|
"type": "object"
|
|
@@ -2831,6 +3802,30 @@
|
|
|
2831
3802
|
"description": "Name of a workspace: an isolated set of tables with its own extent. The first source loaded into a workspace sets its extent and later sources are cut to it, so two areas that must not clip each other go in two workspaces. A table is found by its name inside its workspace, so two workspaces may hold tables of the same name. Entries without a workspace use the default one. Read by the Autark adapter only.",
|
|
2832
3803
|
"minLength": 1,
|
|
2833
3804
|
"type": "string"
|
|
3805
|
+
},
|
|
3806
|
+
"WorkspaceSpec": {
|
|
3807
|
+
"description": "How a workspace stores its tables: the coordinate system they are kept in, and the grid their coordinates are rounded to. Read by the Autark adapter only.",
|
|
3808
|
+
"properties": {
|
|
3809
|
+
"coordinateFormat": {
|
|
3810
|
+
"description": "CRS the workspace stores its tables in, as an EPSG string such as `'EPSG:3857'`. Each source is transformed to it as it loads, its maps draw in its units, and so are the lengths given in workspace units, such as a join's `near.distance`. autk-db's default is `'EPSG:3395'`, World Mercator, in meters.",
|
|
3811
|
+
"minLength": 1,
|
|
3812
|
+
"type": "string"
|
|
3813
|
+
},
|
|
3814
|
+
"name": {
|
|
3815
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
3816
|
+
"description": "The workspace, by the name sources, compute passes, maps and plots give as their `workspace`. Without it, the default workspace."
|
|
3817
|
+
},
|
|
3818
|
+
"precisionGrid": {
|
|
3819
|
+
"description": "Grid every stored coordinate is rounded to, in the CRS's units. autk-db's default is `0.01`, a centimeter in World Mercator. A geometry the grid collapses is refused as it loads.",
|
|
3820
|
+
"exclusiveMinimum": 0,
|
|
3821
|
+
"type": "number"
|
|
3822
|
+
}
|
|
3823
|
+
},
|
|
3824
|
+
"required": [
|
|
3825
|
+
"coordinateFormat",
|
|
3826
|
+
"precisionGrid"
|
|
3827
|
+
],
|
|
3828
|
+
"type": "object"
|
|
2834
3829
|
}
|
|
2835
3830
|
}
|
|
2836
3831
|
}
|