@urban-toolkit/autk-grammar 4.4.1 → 5.1.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 +424 -5
- package/build/autk-grammar-schema.json +1367 -505
- package/dist/autk-grammar.js +872 -430
- 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 +2 -0
- package/dist/data/autk-grammar-data.cjs.map +1 -0
- package/dist/data/autk-grammar-data.d.ts +516 -0
- package/dist/data/autk-grammar-data.js +265 -0
- package/dist/data/autk-grammar-data.js.map +1 -0
- package/dist/index.d.ts +744 -76
- package/package.json +7 -2
|
@@ -65,8 +65,13 @@
|
|
|
65
65
|
"height": {
|
|
66
66
|
"type": "number"
|
|
67
67
|
},
|
|
68
|
+
"id": {
|
|
69
|
+
"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
|
+
"minLength": 1,
|
|
71
|
+
"type": "string"
|
|
72
|
+
},
|
|
68
73
|
"mapRef": {
|
|
69
|
-
"description": "`dataRef` of the map layer this plot links its selection to.",
|
|
74
|
+
"description": "`dataRef` of the map layer this plot links its selection to. A shorthand for a link in `links`.",
|
|
70
75
|
"type": "string"
|
|
71
76
|
},
|
|
72
77
|
"margins": {
|
|
@@ -96,6 +101,10 @@
|
|
|
96
101
|
"const": "bar",
|
|
97
102
|
"type": "string"
|
|
98
103
|
},
|
|
104
|
+
"osmElements": {
|
|
105
|
+
"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
|
+
"type": "boolean"
|
|
107
|
+
},
|
|
99
108
|
"selectFields": {
|
|
100
109
|
"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.",
|
|
101
110
|
"items": {
|
|
@@ -112,6 +121,10 @@
|
|
|
112
121
|
},
|
|
113
122
|
"width": {
|
|
114
123
|
"type": "number"
|
|
124
|
+
},
|
|
125
|
+
"workspace": {
|
|
126
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
127
|
+
"description": "Workspace the table is read from."
|
|
115
128
|
}
|
|
116
129
|
},
|
|
117
130
|
"required": [
|
|
@@ -144,6 +157,29 @@
|
|
|
144
157
|
],
|
|
145
158
|
"type": "object"
|
|
146
159
|
},
|
|
160
|
+
"CameraSpec": {
|
|
161
|
+
"description": "Where a map looks from. Each field is optional; an omitted field keeps the view that fits the map's layers. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
162
|
+
"properties": {
|
|
163
|
+
"bearing": {
|
|
164
|
+
"description": "Compass heading the view faces, in degrees clockwise from north: the map turns around the point it looks at.",
|
|
165
|
+
"maximum": 360,
|
|
166
|
+
"minimum": 0,
|
|
167
|
+
"type": "number"
|
|
168
|
+
},
|
|
169
|
+
"pitch": {
|
|
170
|
+
"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.",
|
|
171
|
+
"exclusiveMaximum": 90,
|
|
172
|
+
"minimum": 0,
|
|
173
|
+
"type": "number"
|
|
174
|
+
},
|
|
175
|
+
"zoom": {
|
|
176
|
+
"description": "Zoom level: the eye sits `10000 / 2^(zoom - 10)` workspace units from the point the map looks at (straight above it without `pitch`), so each step doubles the scale.",
|
|
177
|
+
"minimum": 0,
|
|
178
|
+
"type": "number"
|
|
179
|
+
}
|
|
180
|
+
},
|
|
181
|
+
"type": "object"
|
|
182
|
+
},
|
|
147
183
|
"ColorMapInterpolator": {
|
|
148
184
|
"description": "Color scheme for a colored map layer: `scheme*` names are categorical, `interpolate*` names are sequential or diverging.",
|
|
149
185
|
"enum": [
|
|
@@ -200,374 +236,124 @@
|
|
|
200
236
|
"ComputeSpec": {
|
|
201
237
|
"anyOf": [
|
|
202
238
|
{
|
|
203
|
-
"
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
"type": "object"
|
|
233
|
-
},
|
|
234
|
-
"type": "object"
|
|
235
|
-
},
|
|
236
|
-
"attributes": {
|
|
237
|
-
"additionalProperties": {
|
|
238
|
-
"type": "string"
|
|
239
|
-
},
|
|
240
|
-
"description": "Maps WGSL variable names to feature property paths.",
|
|
241
|
-
"type": "object"
|
|
242
|
-
},
|
|
243
|
-
"dataRef": {
|
|
244
|
-
"description": "Name of the table the shader runs over, one invocation per feature.",
|
|
245
|
-
"type": "string"
|
|
246
|
-
},
|
|
247
|
-
"outputColumnName": {
|
|
248
|
-
"description": "Column written when the shader returns one value.",
|
|
249
|
-
"type": "string"
|
|
250
|
-
},
|
|
251
|
-
"outputColumns": {
|
|
252
|
-
"items": {
|
|
253
|
-
"type": "string"
|
|
254
|
-
},
|
|
255
|
-
"minItems": 1,
|
|
256
|
-
"type": "array"
|
|
257
|
-
},
|
|
258
|
-
"uniformArrays": {
|
|
259
|
-
"additionalProperties": {
|
|
260
|
-
"items": {
|
|
261
|
-
"type": "number"
|
|
262
|
-
},
|
|
263
|
-
"type": "array"
|
|
264
|
-
},
|
|
265
|
-
"type": "object"
|
|
266
|
-
},
|
|
267
|
-
"uniformMatrices": {
|
|
268
|
-
"additionalProperties": {
|
|
269
|
-
"anyOf": [
|
|
270
|
-
{
|
|
271
|
-
"properties": {
|
|
272
|
-
"cols": {
|
|
273
|
-
"type": "number"
|
|
274
|
-
},
|
|
275
|
-
"data": {
|
|
276
|
-
"items": {
|
|
277
|
-
"items": {
|
|
278
|
-
"type": "number"
|
|
279
|
-
},
|
|
280
|
-
"type": "array"
|
|
281
|
-
},
|
|
282
|
-
"type": "array"
|
|
283
|
-
}
|
|
284
|
-
},
|
|
285
|
-
"required": [
|
|
286
|
-
"data",
|
|
287
|
-
"cols"
|
|
288
|
-
],
|
|
289
|
-
"type": "object"
|
|
290
|
-
},
|
|
291
|
-
{
|
|
292
|
-
"$ref": "#/definitions/FromFeatureDirective"
|
|
293
|
-
}
|
|
294
|
-
]
|
|
295
|
-
},
|
|
296
|
-
"description": "Matrix constants shared by every invocation, written inline or read from a feature.",
|
|
297
|
-
"type": "object"
|
|
298
|
-
},
|
|
299
|
-
"uniforms": {
|
|
300
|
-
"additionalProperties": {
|
|
301
|
-
"anyOf": [
|
|
302
|
-
{
|
|
303
|
-
"type": "number"
|
|
304
|
-
},
|
|
305
|
-
{
|
|
306
|
-
"$ref": "#/definitions/FromFeatureDirective"
|
|
307
|
-
}
|
|
308
|
-
]
|
|
309
|
-
},
|
|
310
|
-
"description": "Scalar constants shared by every invocation, written inline or read from a feature.",
|
|
311
|
-
"type": "object"
|
|
312
|
-
},
|
|
313
|
-
"wglsFunction": {
|
|
314
|
-
"anyOf": [
|
|
315
|
-
{
|
|
316
|
-
"type": "string"
|
|
317
|
-
},
|
|
318
|
-
{
|
|
319
|
-
"items": {
|
|
320
|
-
"type": "string"
|
|
321
|
-
},
|
|
322
|
-
"type": "array"
|
|
323
|
-
}
|
|
324
|
-
],
|
|
325
|
-
"description": "WGSL body of the compute function. An array is joined with newlines, which keeps long shaders readable in JSON."
|
|
326
|
-
}
|
|
239
|
+
"$ref": "#/definitions/GpgpuComputeSpec"
|
|
240
|
+
},
|
|
241
|
+
{
|
|
242
|
+
"$ref": "#/definitions/RenderComputeSpec"
|
|
243
|
+
}
|
|
244
|
+
],
|
|
245
|
+
"description": "One entry of `compute`. A pass with `type: 'render'` is a {@link RenderComputeSpec } , any other a {@link GpgpuComputeSpec } ."
|
|
246
|
+
},
|
|
247
|
+
"CsvDataSourceSpec": {
|
|
248
|
+
"description": "Loads a CSV table from exactly one of `csvFileUrl` or `csvObject`.",
|
|
249
|
+
"else": {
|
|
250
|
+
"required": [
|
|
251
|
+
"csvObject"
|
|
252
|
+
]
|
|
253
|
+
},
|
|
254
|
+
"if": {
|
|
255
|
+
"required": [
|
|
256
|
+
"csvFileUrl"
|
|
257
|
+
]
|
|
258
|
+
},
|
|
259
|
+
"properties": {
|
|
260
|
+
"csvFileUrl": {
|
|
261
|
+
"type": "string"
|
|
262
|
+
},
|
|
263
|
+
"csvObject": {
|
|
264
|
+
"description": "Rows as arrays; the first row holds the column names.",
|
|
265
|
+
"items": {
|
|
266
|
+
"items": {},
|
|
267
|
+
"type": "array"
|
|
327
268
|
},
|
|
269
|
+
"type": "array"
|
|
270
|
+
},
|
|
271
|
+
"delimiter": {
|
|
272
|
+
"type": "string"
|
|
273
|
+
},
|
|
274
|
+
"geometryColumns": {
|
|
275
|
+
"$ref": "#/definitions/GeometryColumns"
|
|
276
|
+
},
|
|
277
|
+
"outputTableName": {
|
|
278
|
+
"description": "Name of the table this source creates. Later sources, compute passes, maps and plots refer to it by this name.",
|
|
279
|
+
"type": "string"
|
|
280
|
+
},
|
|
281
|
+
"type": {
|
|
282
|
+
"const": "csv",
|
|
283
|
+
"type": "string"
|
|
284
|
+
},
|
|
285
|
+
"workspace": {
|
|
286
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
287
|
+
"description": "Workspace the table is created in."
|
|
288
|
+
}
|
|
289
|
+
},
|
|
290
|
+
"required": [
|
|
291
|
+
"outputTableName",
|
|
292
|
+
"type"
|
|
293
|
+
],
|
|
294
|
+
"then": {
|
|
295
|
+
"not": {
|
|
328
296
|
"required": [
|
|
329
|
-
"
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
297
|
+
"csvObject"
|
|
298
|
+
]
|
|
299
|
+
}
|
|
300
|
+
},
|
|
301
|
+
"type": "object"
|
|
302
|
+
},
|
|
303
|
+
"CustomDataSourceSpec": {
|
|
304
|
+
"description": "Loads a GeoJSON FeatureCollection from `geojsonFileUrl` or `geojsonObject`. When both are given, the Autark adapter reads the URL.",
|
|
305
|
+
"if": {
|
|
306
|
+
"not": {
|
|
307
|
+
"required": [
|
|
308
|
+
"geojsonFileUrl"
|
|
309
|
+
]
|
|
310
|
+
}
|
|
311
|
+
},
|
|
312
|
+
"properties": {
|
|
313
|
+
"boundingBox": {
|
|
314
|
+
"$ref": "#/definitions/BoundingBox"
|
|
315
|
+
},
|
|
316
|
+
"coordinateFormat": {
|
|
317
|
+
"description": "Source coordinate reference system of the input data, expressed as an EPSG string (e.g. `'EPSG:4326'`, `'EPSG:3395'`).\n\nDefaults to `'EPSG:4326'` (WGS84) when omitted, which is the correct value for standards-compliant GeoJSON. Only set this when the source data deviates from RFC 7946.",
|
|
318
|
+
"type": "string"
|
|
319
|
+
},
|
|
320
|
+
"geojsonFileUrl": {
|
|
321
|
+
"type": "string"
|
|
322
|
+
},
|
|
323
|
+
"geojsonObject": {
|
|
324
|
+
"$ref": "#/definitions/InlineFeatureCollection",
|
|
325
|
+
"description": "GeoJSON FeatureCollection to load directly.\n\nPer RFC 7946, GeoJSON coordinates MUST be in WGS84 (EPSG:4326) longitude/latitude. This is the default assumption when `coordinateFormat` is omitted.\n\nIf your FeatureCollection is in a different CRS (e.g. a projected system such as EPSG:3395), you MUST set `coordinateFormat` explicitly to match the actual CRS of the input data. Omitting `coordinateFormat` when the data is not in EPSG:4326 will cause the spatial transform to produce invalid geometry."
|
|
326
|
+
},
|
|
327
|
+
"layerType": {
|
|
328
|
+
"$ref": "#/definitions/LayerType",
|
|
329
|
+
"description": "How the map draws the layer. When omitted, autk-db reads it from the first feature's geometry. Set it to draw lines as `polylines` or polygons as a `buildings` layer, for example. Read by the Autark adapter only."
|
|
330
|
+
},
|
|
331
|
+
"outputTableName": {
|
|
332
|
+
"description": "Name of the table this source creates. Later sources, compute passes, maps and plots refer to it by this name.",
|
|
333
|
+
"type": "string"
|
|
335
334
|
},
|
|
336
|
-
{
|
|
337
|
-
"
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
}
|
|
359
|
-
]
|
|
360
|
-
}
|
|
361
|
-
},
|
|
362
|
-
"required": [
|
|
363
|
-
"rows",
|
|
364
|
-
"cols"
|
|
365
|
-
],
|
|
366
|
-
"type": "object"
|
|
367
|
-
},
|
|
368
|
-
"type": "object"
|
|
369
|
-
},
|
|
370
|
-
"attributes": {
|
|
371
|
-
"additionalProperties": {
|
|
372
|
-
"type": "string"
|
|
373
|
-
},
|
|
374
|
-
"description": "Maps WGSL variable names to feature property paths.",
|
|
375
|
-
"type": "object"
|
|
376
|
-
},
|
|
377
|
-
"dataRef": {
|
|
378
|
-
"description": "Name of the table the shader runs over, one invocation per feature.",
|
|
379
|
-
"type": "string"
|
|
380
|
-
},
|
|
381
|
-
"outputColumnName": {
|
|
382
|
-
"type": "string"
|
|
383
|
-
},
|
|
384
|
-
"outputColumns": {
|
|
385
|
-
"description": "Columns written when the shader returns several values, in order.",
|
|
386
|
-
"items": {
|
|
387
|
-
"type": "string"
|
|
388
|
-
},
|
|
389
|
-
"minItems": 1,
|
|
390
|
-
"type": "array"
|
|
391
|
-
},
|
|
392
|
-
"uniformArrays": {
|
|
393
|
-
"additionalProperties": {
|
|
394
|
-
"items": {
|
|
395
|
-
"type": "number"
|
|
396
|
-
},
|
|
397
|
-
"type": "array"
|
|
398
|
-
},
|
|
399
|
-
"type": "object"
|
|
400
|
-
},
|
|
401
|
-
"uniformMatrices": {
|
|
402
|
-
"additionalProperties": {
|
|
403
|
-
"anyOf": [
|
|
404
|
-
{
|
|
405
|
-
"properties": {
|
|
406
|
-
"cols": {
|
|
407
|
-
"type": "number"
|
|
408
|
-
},
|
|
409
|
-
"data": {
|
|
410
|
-
"items": {
|
|
411
|
-
"items": {
|
|
412
|
-
"type": "number"
|
|
413
|
-
},
|
|
414
|
-
"type": "array"
|
|
415
|
-
},
|
|
416
|
-
"type": "array"
|
|
417
|
-
}
|
|
418
|
-
},
|
|
419
|
-
"required": [
|
|
420
|
-
"data",
|
|
421
|
-
"cols"
|
|
422
|
-
],
|
|
423
|
-
"type": "object"
|
|
424
|
-
},
|
|
425
|
-
{
|
|
426
|
-
"$ref": "#/definitions/FromFeatureDirective"
|
|
427
|
-
}
|
|
428
|
-
]
|
|
429
|
-
},
|
|
430
|
-
"description": "Matrix constants shared by every invocation, written inline or read from a feature.",
|
|
431
|
-
"type": "object"
|
|
432
|
-
},
|
|
433
|
-
"uniforms": {
|
|
434
|
-
"additionalProperties": {
|
|
435
|
-
"anyOf": [
|
|
436
|
-
{
|
|
437
|
-
"type": "number"
|
|
438
|
-
},
|
|
439
|
-
{
|
|
440
|
-
"$ref": "#/definitions/FromFeatureDirective"
|
|
441
|
-
}
|
|
442
|
-
]
|
|
443
|
-
},
|
|
444
|
-
"description": "Scalar constants shared by every invocation, written inline or read from a feature.",
|
|
445
|
-
"type": "object"
|
|
446
|
-
},
|
|
447
|
-
"wglsFunction": {
|
|
448
|
-
"anyOf": [
|
|
449
|
-
{
|
|
450
|
-
"type": "string"
|
|
451
|
-
},
|
|
452
|
-
{
|
|
453
|
-
"items": {
|
|
454
|
-
"type": "string"
|
|
455
|
-
},
|
|
456
|
-
"type": "array"
|
|
457
|
-
}
|
|
458
|
-
],
|
|
459
|
-
"description": "WGSL body of the compute function. An array is joined with newlines, which keeps long shaders readable in JSON."
|
|
460
|
-
}
|
|
461
|
-
},
|
|
462
|
-
"required": [
|
|
463
|
-
"attributes",
|
|
464
|
-
"dataRef",
|
|
465
|
-
"outputColumns",
|
|
466
|
-
"wglsFunction"
|
|
467
|
-
],
|
|
468
|
-
"type": "object"
|
|
469
|
-
}
|
|
470
|
-
],
|
|
471
|
-
"description": "A GPU compute pass over a table. Results are written to `feature.properties.compute.<column>`. It needs `outputColumnName` for a single result or `outputColumns` for several."
|
|
472
|
-
},
|
|
473
|
-
"CsvDataSourceSpec": {
|
|
474
|
-
"description": "Loads a CSV table from exactly one of `csvFileUrl` or `csvObject`.",
|
|
475
|
-
"else": {
|
|
476
|
-
"required": [
|
|
477
|
-
"csvObject"
|
|
478
|
-
]
|
|
479
|
-
},
|
|
480
|
-
"if": {
|
|
481
|
-
"required": [
|
|
482
|
-
"csvFileUrl"
|
|
483
|
-
]
|
|
484
|
-
},
|
|
485
|
-
"properties": {
|
|
486
|
-
"csvFileUrl": {
|
|
487
|
-
"type": "string"
|
|
488
|
-
},
|
|
489
|
-
"csvObject": {
|
|
490
|
-
"description": "Rows as arrays; the first row holds the column names.",
|
|
491
|
-
"items": {
|
|
492
|
-
"items": {},
|
|
493
|
-
"type": "array"
|
|
494
|
-
},
|
|
495
|
-
"type": "array"
|
|
496
|
-
},
|
|
497
|
-
"delimiter": {
|
|
498
|
-
"type": "string"
|
|
499
|
-
},
|
|
500
|
-
"geometryColumns": {
|
|
501
|
-
"$ref": "#/definitions/GeometryColumns"
|
|
502
|
-
},
|
|
503
|
-
"outputTableName": {
|
|
504
|
-
"description": "Name of the table this source creates. Later sources, compute passes, maps and plots refer to it by this name.",
|
|
505
|
-
"type": "string"
|
|
506
|
-
},
|
|
507
|
-
"type": {
|
|
508
|
-
"const": "csv",
|
|
509
|
-
"type": "string"
|
|
510
|
-
}
|
|
511
|
-
},
|
|
512
|
-
"required": [
|
|
513
|
-
"outputTableName",
|
|
514
|
-
"type"
|
|
515
|
-
],
|
|
516
|
-
"then": {
|
|
517
|
-
"not": {
|
|
518
|
-
"required": [
|
|
519
|
-
"csvObject"
|
|
520
|
-
]
|
|
521
|
-
}
|
|
522
|
-
},
|
|
523
|
-
"type": "object"
|
|
524
|
-
},
|
|
525
|
-
"CustomDataSourceSpec": {
|
|
526
|
-
"description": "Loads a GeoJSON FeatureCollection from `geojsonFileUrl` or `geojsonObject`. When both are given, the Autark adapter reads the URL.",
|
|
527
|
-
"if": {
|
|
528
|
-
"not": {
|
|
529
|
-
"required": [
|
|
530
|
-
"geojsonFileUrl"
|
|
531
|
-
]
|
|
532
|
-
}
|
|
533
|
-
},
|
|
534
|
-
"properties": {
|
|
535
|
-
"boundingBox": {
|
|
536
|
-
"$ref": "#/definitions/BoundingBox"
|
|
537
|
-
},
|
|
538
|
-
"coordinateFormat": {
|
|
539
|
-
"description": "Source coordinate reference system of the input data, expressed as an EPSG string (e.g. `'EPSG:4326'`, `'EPSG:3395'`).\n\nDefaults to `'EPSG:4326'` (WGS84) when omitted, which is the correct value for standards-compliant GeoJSON. Only set this when the source data deviates from RFC 7946.",
|
|
540
|
-
"type": "string"
|
|
541
|
-
},
|
|
542
|
-
"geojsonFileUrl": {
|
|
543
|
-
"type": "string"
|
|
544
|
-
},
|
|
545
|
-
"geojsonObject": {
|
|
546
|
-
"$ref": "#/definitions/InlineFeatureCollection",
|
|
547
|
-
"description": "GeoJSON FeatureCollection to load directly.\n\nPer RFC 7946, GeoJSON coordinates MUST be in WGS84 (EPSG:4326) longitude/latitude. This is the default assumption when `coordinateFormat` is omitted.\n\nIf your FeatureCollection is in a different CRS (e.g. a projected system such as EPSG:3395), you MUST set `coordinateFormat` explicitly to match the actual CRS of the input data. Omitting `coordinateFormat` when the data is not in EPSG:4326 will cause the spatial transform to produce invalid geometry."
|
|
548
|
-
},
|
|
549
|
-
"outputTableName": {
|
|
550
|
-
"description": "Name of the table this source creates. Later sources, compute passes, maps and plots refer to it by this name.",
|
|
551
|
-
"type": "string"
|
|
552
|
-
},
|
|
553
|
-
"type": {
|
|
554
|
-
"const": "geojson",
|
|
555
|
-
"type": "string"
|
|
556
|
-
}
|
|
557
|
-
},
|
|
558
|
-
"required": [
|
|
559
|
-
"outputTableName",
|
|
560
|
-
"type"
|
|
561
|
-
],
|
|
562
|
-
"then": {
|
|
563
|
-
"required": [
|
|
564
|
-
"geojsonObject"
|
|
565
|
-
]
|
|
566
|
-
},
|
|
567
|
-
"type": "object"
|
|
568
|
-
},
|
|
569
|
-
"DataSourceSpec": {
|
|
570
|
-
"allOf": [
|
|
335
|
+
"type": {
|
|
336
|
+
"const": "geojson",
|
|
337
|
+
"type": "string"
|
|
338
|
+
},
|
|
339
|
+
"workspace": {
|
|
340
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
341
|
+
"description": "Workspace the table is created in."
|
|
342
|
+
}
|
|
343
|
+
},
|
|
344
|
+
"required": [
|
|
345
|
+
"outputTableName",
|
|
346
|
+
"type"
|
|
347
|
+
],
|
|
348
|
+
"then": {
|
|
349
|
+
"required": [
|
|
350
|
+
"geojsonObject"
|
|
351
|
+
]
|
|
352
|
+
},
|
|
353
|
+
"type": "object"
|
|
354
|
+
},
|
|
355
|
+
"DataSourceSpec": {
|
|
356
|
+
"allOf": [
|
|
571
357
|
{
|
|
572
358
|
"if": {
|
|
573
359
|
"properties": {
|
|
@@ -620,6 +406,19 @@
|
|
|
620
406
|
"$ref": "#/definitions/CustomDataSourceSpec"
|
|
621
407
|
}
|
|
622
408
|
},
|
|
409
|
+
{
|
|
410
|
+
"if": {
|
|
411
|
+
"properties": {
|
|
412
|
+
"type": {
|
|
413
|
+
"const": "geotiff",
|
|
414
|
+
"type": "string"
|
|
415
|
+
}
|
|
416
|
+
}
|
|
417
|
+
},
|
|
418
|
+
"then": {
|
|
419
|
+
"$ref": "#/definitions/GeoTiffDataSourceSpec"
|
|
420
|
+
}
|
|
421
|
+
},
|
|
623
422
|
{
|
|
624
423
|
"if": {
|
|
625
424
|
"properties": {
|
|
@@ -645,25 +444,90 @@
|
|
|
645
444
|
"then": {
|
|
646
445
|
"$ref": "#/definitions/JoinSourceSpec"
|
|
647
446
|
}
|
|
648
|
-
}
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
"
|
|
660
|
-
|
|
661
|
-
}
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
447
|
+
},
|
|
448
|
+
{
|
|
449
|
+
"if": {
|
|
450
|
+
"properties": {
|
|
451
|
+
"type": {
|
|
452
|
+
"const": "sql",
|
|
453
|
+
"type": "string"
|
|
454
|
+
}
|
|
455
|
+
}
|
|
456
|
+
},
|
|
457
|
+
"then": {
|
|
458
|
+
"$ref": "#/definitions/SqlSourceSpec"
|
|
459
|
+
}
|
|
460
|
+
},
|
|
461
|
+
{
|
|
462
|
+
"if": {
|
|
463
|
+
"properties": {
|
|
464
|
+
"type": {
|
|
465
|
+
"const": "update",
|
|
466
|
+
"type": "string"
|
|
467
|
+
}
|
|
468
|
+
}
|
|
469
|
+
},
|
|
470
|
+
"then": {
|
|
471
|
+
"$ref": "#/definitions/UpdateSourceSpec"
|
|
472
|
+
}
|
|
473
|
+
},
|
|
474
|
+
{
|
|
475
|
+
"if": {
|
|
476
|
+
"properties": {
|
|
477
|
+
"type": {
|
|
478
|
+
"const": "drop",
|
|
479
|
+
"type": "string"
|
|
480
|
+
}
|
|
481
|
+
}
|
|
482
|
+
},
|
|
483
|
+
"then": {
|
|
484
|
+
"$ref": "#/definitions/DropSourceSpec"
|
|
485
|
+
}
|
|
486
|
+
}
|
|
487
|
+
],
|
|
488
|
+
"description": "One entry of `data`. The `type` field selects which fields apply.",
|
|
489
|
+
"properties": {
|
|
490
|
+
"type": {
|
|
491
|
+
"enum": [
|
|
492
|
+
"osm",
|
|
493
|
+
"csv",
|
|
494
|
+
"json",
|
|
495
|
+
"geojson",
|
|
496
|
+
"geotiff",
|
|
497
|
+
"heatmap",
|
|
498
|
+
"join",
|
|
499
|
+
"sql",
|
|
500
|
+
"update",
|
|
501
|
+
"drop"
|
|
502
|
+
]
|
|
503
|
+
}
|
|
504
|
+
},
|
|
505
|
+
"required": [
|
|
506
|
+
"type"
|
|
507
|
+
],
|
|
508
|
+
"type": "object"
|
|
509
|
+
},
|
|
510
|
+
"DropSourceSpec": {
|
|
511
|
+
"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.",
|
|
512
|
+
"properties": {
|
|
513
|
+
"dataRef": {
|
|
514
|
+
"description": "The table to drop.",
|
|
515
|
+
"type": "string"
|
|
516
|
+
},
|
|
517
|
+
"type": {
|
|
518
|
+
"const": "drop",
|
|
519
|
+
"type": "string"
|
|
520
|
+
},
|
|
521
|
+
"workspace": {
|
|
522
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
523
|
+
"description": "Workspace of the table."
|
|
524
|
+
}
|
|
525
|
+
},
|
|
526
|
+
"required": [
|
|
527
|
+
"type",
|
|
528
|
+
"dataRef"
|
|
529
|
+
],
|
|
530
|
+
"type": "object"
|
|
667
531
|
},
|
|
668
532
|
"FromFeatureDirective": {
|
|
669
533
|
"description": "Reads a uniform's value from a feature of a loaded table instead of writing it inline.",
|
|
@@ -707,102 +571,464 @@
|
|
|
707
571
|
"description": "Table to read from.",
|
|
708
572
|
"type": "string"
|
|
709
573
|
},
|
|
710
|
-
"path": {
|
|
711
|
-
"description": "Dot path from the feature root, for example `properties.height` or `geometry.coordinates.0`.",
|
|
712
|
-
"type": "string"
|
|
574
|
+
"path": {
|
|
575
|
+
"description": "Dot path from the feature root, for example `properties.height` or `geometry.coordinates.0`.",
|
|
576
|
+
"type": "string"
|
|
577
|
+
},
|
|
578
|
+
"required": {
|
|
579
|
+
"description": "With `iterate: 'batched'`, drop features whose `path` does not resolve to a finite value.",
|
|
580
|
+
"type": "boolean"
|
|
581
|
+
}
|
|
582
|
+
},
|
|
583
|
+
"required": [
|
|
584
|
+
"layer",
|
|
585
|
+
"path"
|
|
586
|
+
],
|
|
587
|
+
"type": "object"
|
|
588
|
+
}
|
|
589
|
+
},
|
|
590
|
+
"required": [
|
|
591
|
+
"fromFeature"
|
|
592
|
+
],
|
|
593
|
+
"type": "object"
|
|
594
|
+
},
|
|
595
|
+
"GeoJsonProperties": {
|
|
596
|
+
"anyOf": [
|
|
597
|
+
{
|
|
598
|
+
"type": "object"
|
|
599
|
+
},
|
|
600
|
+
{
|
|
601
|
+
"type": "null"
|
|
602
|
+
}
|
|
603
|
+
]
|
|
604
|
+
},
|
|
605
|
+
"GeoTiffDataSourceSpec": {
|
|
606
|
+
"description": "Loads a GeoTIFF raster from `geotiffFileUrl` as a raster table: one feature, with one band per value. Read by the Autark adapter only.",
|
|
607
|
+
"properties": {
|
|
608
|
+
"coordinateFormat": {
|
|
609
|
+
"description": "CRS of the file, as an EPSG string. Defaults to `'EPSG:4326'`.",
|
|
610
|
+
"type": "string"
|
|
611
|
+
},
|
|
612
|
+
"geotiffFileUrl": {
|
|
613
|
+
"description": "URL of the GeoTIFF file, relative to the page or absolute, which autk-db fetches. The file's first image is read: each of its bands becomes a band of the table (`band_1`, `band_2`, ...), where the file's no-data value reads as no value. A rotated or sheared grid is refused.",
|
|
614
|
+
"type": "string"
|
|
615
|
+
},
|
|
616
|
+
"maxRasterCells": {
|
|
617
|
+
"description": "Most cells to decode; a larger raster is downsampled to fit. Defaults to 1 000 000.",
|
|
618
|
+
"type": "number"
|
|
619
|
+
},
|
|
620
|
+
"outputTableName": {
|
|
621
|
+
"description": "Name of the table this source creates. Later sources, compute passes, maps and plots refer to it by this name.",
|
|
622
|
+
"type": "string"
|
|
623
|
+
},
|
|
624
|
+
"resampleMethod": {
|
|
625
|
+
"description": "How a larger raster is downsampled. Defaults to `'bilinear'`.",
|
|
626
|
+
"enum": [
|
|
627
|
+
"nearest",
|
|
628
|
+
"bilinear"
|
|
629
|
+
],
|
|
630
|
+
"type": "string"
|
|
631
|
+
},
|
|
632
|
+
"type": {
|
|
633
|
+
"const": "geotiff",
|
|
634
|
+
"type": "string"
|
|
635
|
+
},
|
|
636
|
+
"workspace": {
|
|
637
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
638
|
+
"description": "Workspace the table is created in."
|
|
639
|
+
}
|
|
640
|
+
},
|
|
641
|
+
"required": [
|
|
642
|
+
"geotiffFileUrl",
|
|
643
|
+
"outputTableName",
|
|
644
|
+
"type"
|
|
645
|
+
],
|
|
646
|
+
"type": "object"
|
|
647
|
+
},
|
|
648
|
+
"Geometry": {
|
|
649
|
+
"anyOf": [
|
|
650
|
+
{
|
|
651
|
+
"$ref": "#/definitions/Point"
|
|
652
|
+
},
|
|
653
|
+
{
|
|
654
|
+
"$ref": "#/definitions/MultiPoint"
|
|
655
|
+
},
|
|
656
|
+
{
|
|
657
|
+
"$ref": "#/definitions/LineString"
|
|
658
|
+
},
|
|
659
|
+
{
|
|
660
|
+
"$ref": "#/definitions/MultiLineString"
|
|
661
|
+
},
|
|
662
|
+
{
|
|
663
|
+
"$ref": "#/definitions/Polygon"
|
|
664
|
+
},
|
|
665
|
+
{
|
|
666
|
+
"$ref": "#/definitions/MultiPolygon"
|
|
667
|
+
},
|
|
668
|
+
{
|
|
669
|
+
"$ref": "#/definitions/GeometryCollection"
|
|
670
|
+
}
|
|
671
|
+
],
|
|
672
|
+
"description": "Geometry object. https://tools.ietf.org/html/rfc7946#section-3"
|
|
673
|
+
},
|
|
674
|
+
"GeometryCollection": {
|
|
675
|
+
"description": "Geometry Collection https://tools.ietf.org/html/rfc7946#section-3.1.8",
|
|
676
|
+
"properties": {
|
|
677
|
+
"bbox": {
|
|
678
|
+
"$ref": "#/definitions/BBox",
|
|
679
|
+
"description": "Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections. The value of the bbox member is an array of length 2*n where n is the number of dimensions represented in the contained geometries, with all axes of the most southwesterly point followed by all axes of the more northeasterly point. The axes order of a bbox follows the axes order of geometries. https://tools.ietf.org/html/rfc7946#section-5"
|
|
680
|
+
},
|
|
681
|
+
"geometries": {
|
|
682
|
+
"items": {
|
|
683
|
+
"$ref": "#/definitions/Geometry"
|
|
684
|
+
},
|
|
685
|
+
"type": "array"
|
|
686
|
+
},
|
|
687
|
+
"type": {
|
|
688
|
+
"const": "GeometryCollection",
|
|
689
|
+
"description": "Specifies the type of GeoJSON object.",
|
|
690
|
+
"type": "string"
|
|
691
|
+
}
|
|
692
|
+
},
|
|
693
|
+
"required": [
|
|
694
|
+
"geometries",
|
|
695
|
+
"type"
|
|
696
|
+
],
|
|
697
|
+
"type": "object"
|
|
698
|
+
},
|
|
699
|
+
"GeometryColumns": {
|
|
700
|
+
"anyOf": [
|
|
701
|
+
{
|
|
702
|
+
"const": true,
|
|
703
|
+
"type": "boolean"
|
|
704
|
+
},
|
|
705
|
+
{
|
|
706
|
+
"$ref": "#/definitions/LatLongGeometryColumns"
|
|
707
|
+
},
|
|
708
|
+
{
|
|
709
|
+
"$ref": "#/definitions/WktGeometryColumns"
|
|
710
|
+
}
|
|
711
|
+
],
|
|
712
|
+
"description": "How rows become features: `true` reads the `Latitude` and `Longitude` columns, or name the columns."
|
|
713
|
+
},
|
|
714
|
+
"GpgpuComputeSpec": {
|
|
715
|
+
"anyOf": [
|
|
716
|
+
{
|
|
717
|
+
"properties": {
|
|
718
|
+
"attributeArrays": {
|
|
719
|
+
"additionalProperties": {
|
|
720
|
+
"type": "number"
|
|
721
|
+
},
|
|
722
|
+
"type": "object"
|
|
723
|
+
},
|
|
724
|
+
"attributeMatrices": {
|
|
725
|
+
"additionalProperties": {
|
|
726
|
+
"properties": {
|
|
727
|
+
"cols": {
|
|
728
|
+
"type": "number"
|
|
729
|
+
},
|
|
730
|
+
"rows": {
|
|
731
|
+
"anyOf": [
|
|
732
|
+
{
|
|
733
|
+
"type": "number"
|
|
734
|
+
},
|
|
735
|
+
{
|
|
736
|
+
"const": "auto",
|
|
737
|
+
"type": "string"
|
|
738
|
+
}
|
|
739
|
+
]
|
|
740
|
+
}
|
|
741
|
+
},
|
|
742
|
+
"required": [
|
|
743
|
+
"rows",
|
|
744
|
+
"cols"
|
|
745
|
+
],
|
|
746
|
+
"type": "object"
|
|
747
|
+
},
|
|
748
|
+
"type": "object"
|
|
749
|
+
},
|
|
750
|
+
"attributes": {
|
|
751
|
+
"additionalProperties": {
|
|
752
|
+
"type": "string"
|
|
753
|
+
},
|
|
754
|
+
"description": "Maps WGSL variable names to feature property paths.",
|
|
755
|
+
"type": "object"
|
|
756
|
+
},
|
|
757
|
+
"dataRef": {
|
|
758
|
+
"description": "Name of the table the shader runs over, one invocation per feature.",
|
|
759
|
+
"type": "string"
|
|
760
|
+
},
|
|
761
|
+
"layerType": {
|
|
762
|
+
"$ref": "#/definitions/LayerType",
|
|
763
|
+
"description": "How the map draws the new table. Defaults to the type of the table it was computed from. Only used with `outputTableName`."
|
|
764
|
+
},
|
|
765
|
+
"outputColumnName": {
|
|
766
|
+
"description": "Column written when the shader returns one value.",
|
|
767
|
+
"type": "string"
|
|
768
|
+
},
|
|
769
|
+
"outputColumns": {
|
|
770
|
+
"items": {
|
|
771
|
+
"type": "string"
|
|
772
|
+
},
|
|
773
|
+
"minItems": 1,
|
|
774
|
+
"type": "array"
|
|
775
|
+
},
|
|
776
|
+
"outputTableName": {
|
|
777
|
+
"description": "Name of a new table that receives the result, so the source table stays as it is and later passes, maps and plots can read both. Without it, the pass writes into its `dataRef` table.",
|
|
778
|
+
"type": "string"
|
|
779
|
+
},
|
|
780
|
+
"type": {
|
|
781
|
+
"const": "gpgpu",
|
|
782
|
+
"description": "`gpgpu` is the default, so existing specifications need not set it.",
|
|
783
|
+
"type": "string"
|
|
784
|
+
},
|
|
785
|
+
"uniformArrays": {
|
|
786
|
+
"additionalProperties": {
|
|
787
|
+
"items": {
|
|
788
|
+
"type": "number"
|
|
789
|
+
},
|
|
790
|
+
"type": "array"
|
|
791
|
+
},
|
|
792
|
+
"type": "object"
|
|
793
|
+
},
|
|
794
|
+
"uniformMatrices": {
|
|
795
|
+
"additionalProperties": {
|
|
796
|
+
"anyOf": [
|
|
797
|
+
{
|
|
798
|
+
"properties": {
|
|
799
|
+
"cols": {
|
|
800
|
+
"type": "number"
|
|
801
|
+
},
|
|
802
|
+
"data": {
|
|
803
|
+
"items": {
|
|
804
|
+
"items": {
|
|
805
|
+
"type": "number"
|
|
806
|
+
},
|
|
807
|
+
"type": "array"
|
|
808
|
+
},
|
|
809
|
+
"type": "array"
|
|
810
|
+
}
|
|
811
|
+
},
|
|
812
|
+
"required": [
|
|
813
|
+
"data",
|
|
814
|
+
"cols"
|
|
815
|
+
],
|
|
816
|
+
"type": "object"
|
|
817
|
+
},
|
|
818
|
+
{
|
|
819
|
+
"$ref": "#/definitions/FromFeatureDirective"
|
|
820
|
+
}
|
|
821
|
+
]
|
|
822
|
+
},
|
|
823
|
+
"description": "Matrix constants shared by every invocation, written inline or read from a feature.",
|
|
824
|
+
"type": "object"
|
|
825
|
+
},
|
|
826
|
+
"uniforms": {
|
|
827
|
+
"additionalProperties": {
|
|
828
|
+
"anyOf": [
|
|
829
|
+
{
|
|
830
|
+
"type": "number"
|
|
831
|
+
},
|
|
832
|
+
{
|
|
833
|
+
"$ref": "#/definitions/FromFeatureDirective"
|
|
834
|
+
}
|
|
835
|
+
]
|
|
836
|
+
},
|
|
837
|
+
"description": "Scalar constants shared by every invocation, written inline or read from a feature.",
|
|
838
|
+
"type": "object"
|
|
839
|
+
},
|
|
840
|
+
"wgslFunction": {
|
|
841
|
+
"anyOf": [
|
|
842
|
+
{
|
|
843
|
+
"type": "string"
|
|
844
|
+
},
|
|
845
|
+
{
|
|
846
|
+
"items": {
|
|
847
|
+
"type": "string"
|
|
848
|
+
},
|
|
849
|
+
"type": "array"
|
|
850
|
+
}
|
|
851
|
+
],
|
|
852
|
+
"description": "WGSL body of the compute function. An array is joined with newlines, which keeps long shaders readable in JSON."
|
|
853
|
+
},
|
|
854
|
+
"workspace": {
|
|
855
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
856
|
+
"description": "Workspace of the tables the pass reads and writes."
|
|
857
|
+
}
|
|
858
|
+
},
|
|
859
|
+
"required": [
|
|
860
|
+
"attributes",
|
|
861
|
+
"dataRef",
|
|
862
|
+
"outputColumnName",
|
|
863
|
+
"wgslFunction"
|
|
864
|
+
],
|
|
865
|
+
"type": "object"
|
|
866
|
+
},
|
|
867
|
+
{
|
|
868
|
+
"properties": {
|
|
869
|
+
"attributeArrays": {
|
|
870
|
+
"additionalProperties": {
|
|
871
|
+
"type": "number"
|
|
872
|
+
},
|
|
873
|
+
"type": "object"
|
|
874
|
+
},
|
|
875
|
+
"attributeMatrices": {
|
|
876
|
+
"additionalProperties": {
|
|
877
|
+
"properties": {
|
|
878
|
+
"cols": {
|
|
879
|
+
"type": "number"
|
|
880
|
+
},
|
|
881
|
+
"rows": {
|
|
882
|
+
"anyOf": [
|
|
883
|
+
{
|
|
884
|
+
"type": "number"
|
|
885
|
+
},
|
|
886
|
+
{
|
|
887
|
+
"const": "auto",
|
|
888
|
+
"type": "string"
|
|
889
|
+
}
|
|
890
|
+
]
|
|
891
|
+
}
|
|
892
|
+
},
|
|
893
|
+
"required": [
|
|
894
|
+
"rows",
|
|
895
|
+
"cols"
|
|
896
|
+
],
|
|
897
|
+
"type": "object"
|
|
898
|
+
},
|
|
899
|
+
"type": "object"
|
|
900
|
+
},
|
|
901
|
+
"attributes": {
|
|
902
|
+
"additionalProperties": {
|
|
903
|
+
"type": "string"
|
|
904
|
+
},
|
|
905
|
+
"description": "Maps WGSL variable names to feature property paths.",
|
|
906
|
+
"type": "object"
|
|
907
|
+
},
|
|
908
|
+
"dataRef": {
|
|
909
|
+
"description": "Name of the table the shader runs over, one invocation per feature.",
|
|
910
|
+
"type": "string"
|
|
911
|
+
},
|
|
912
|
+
"layerType": {
|
|
913
|
+
"$ref": "#/definitions/LayerType",
|
|
914
|
+
"description": "How the map draws the new table. Defaults to the type of the table it was computed from. Only used with `outputTableName`."
|
|
915
|
+
},
|
|
916
|
+
"outputColumnName": {
|
|
917
|
+
"type": "string"
|
|
918
|
+
},
|
|
919
|
+
"outputColumns": {
|
|
920
|
+
"description": "Columns written when the shader returns several values, in order.",
|
|
921
|
+
"items": {
|
|
922
|
+
"type": "string"
|
|
923
|
+
},
|
|
924
|
+
"minItems": 1,
|
|
925
|
+
"type": "array"
|
|
926
|
+
},
|
|
927
|
+
"outputTableName": {
|
|
928
|
+
"description": "Name of a new table that receives the result, so the source table stays as it is and later passes, maps and plots can read both. Without it, the pass writes into its `dataRef` table.",
|
|
929
|
+
"type": "string"
|
|
930
|
+
},
|
|
931
|
+
"type": {
|
|
932
|
+
"const": "gpgpu",
|
|
933
|
+
"description": "`gpgpu` is the default, so existing specifications need not set it.",
|
|
934
|
+
"type": "string"
|
|
935
|
+
},
|
|
936
|
+
"uniformArrays": {
|
|
937
|
+
"additionalProperties": {
|
|
938
|
+
"items": {
|
|
939
|
+
"type": "number"
|
|
940
|
+
},
|
|
941
|
+
"type": "array"
|
|
942
|
+
},
|
|
943
|
+
"type": "object"
|
|
944
|
+
},
|
|
945
|
+
"uniformMatrices": {
|
|
946
|
+
"additionalProperties": {
|
|
947
|
+
"anyOf": [
|
|
948
|
+
{
|
|
949
|
+
"properties": {
|
|
950
|
+
"cols": {
|
|
951
|
+
"type": "number"
|
|
952
|
+
},
|
|
953
|
+
"data": {
|
|
954
|
+
"items": {
|
|
955
|
+
"items": {
|
|
956
|
+
"type": "number"
|
|
957
|
+
},
|
|
958
|
+
"type": "array"
|
|
959
|
+
},
|
|
960
|
+
"type": "array"
|
|
961
|
+
}
|
|
962
|
+
},
|
|
963
|
+
"required": [
|
|
964
|
+
"data",
|
|
965
|
+
"cols"
|
|
966
|
+
],
|
|
967
|
+
"type": "object"
|
|
968
|
+
},
|
|
969
|
+
{
|
|
970
|
+
"$ref": "#/definitions/FromFeatureDirective"
|
|
971
|
+
}
|
|
972
|
+
]
|
|
973
|
+
},
|
|
974
|
+
"description": "Matrix constants shared by every invocation, written inline or read from a feature.",
|
|
975
|
+
"type": "object"
|
|
976
|
+
},
|
|
977
|
+
"uniforms": {
|
|
978
|
+
"additionalProperties": {
|
|
979
|
+
"anyOf": [
|
|
980
|
+
{
|
|
981
|
+
"type": "number"
|
|
982
|
+
},
|
|
983
|
+
{
|
|
984
|
+
"$ref": "#/definitions/FromFeatureDirective"
|
|
985
|
+
}
|
|
986
|
+
]
|
|
987
|
+
},
|
|
988
|
+
"description": "Scalar constants shared by every invocation, written inline or read from a feature.",
|
|
989
|
+
"type": "object"
|
|
990
|
+
},
|
|
991
|
+
"wgslFunction": {
|
|
992
|
+
"anyOf": [
|
|
993
|
+
{
|
|
994
|
+
"type": "string"
|
|
995
|
+
},
|
|
996
|
+
{
|
|
997
|
+
"items": {
|
|
998
|
+
"type": "string"
|
|
999
|
+
},
|
|
1000
|
+
"type": "array"
|
|
1001
|
+
}
|
|
1002
|
+
],
|
|
1003
|
+
"description": "WGSL body of the compute function. An array is joined with newlines, which keeps long shaders readable in JSON."
|
|
713
1004
|
},
|
|
714
|
-
"
|
|
715
|
-
"
|
|
716
|
-
"
|
|
1005
|
+
"workspace": {
|
|
1006
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
1007
|
+
"description": "Workspace of the tables the pass reads and writes."
|
|
717
1008
|
}
|
|
718
1009
|
},
|
|
719
1010
|
"required": [
|
|
720
|
-
"
|
|
721
|
-
"
|
|
1011
|
+
"attributes",
|
|
1012
|
+
"dataRef",
|
|
1013
|
+
"outputColumns",
|
|
1014
|
+
"wgslFunction"
|
|
722
1015
|
],
|
|
723
1016
|
"type": "object"
|
|
724
1017
|
}
|
|
725
|
-
},
|
|
726
|
-
"required": [
|
|
727
|
-
"fromFeature"
|
|
728
|
-
],
|
|
729
|
-
"type": "object"
|
|
730
|
-
},
|
|
731
|
-
"GeoJsonProperties": {
|
|
732
|
-
"anyOf": [
|
|
733
|
-
{
|
|
734
|
-
"type": "object"
|
|
735
|
-
},
|
|
736
|
-
{
|
|
737
|
-
"type": "null"
|
|
738
|
-
}
|
|
739
|
-
]
|
|
740
|
-
},
|
|
741
|
-
"Geometry": {
|
|
742
|
-
"anyOf": [
|
|
743
|
-
{
|
|
744
|
-
"$ref": "#/definitions/Point"
|
|
745
|
-
},
|
|
746
|
-
{
|
|
747
|
-
"$ref": "#/definitions/MultiPoint"
|
|
748
|
-
},
|
|
749
|
-
{
|
|
750
|
-
"$ref": "#/definitions/LineString"
|
|
751
|
-
},
|
|
752
|
-
{
|
|
753
|
-
"$ref": "#/definitions/MultiLineString"
|
|
754
|
-
},
|
|
755
|
-
{
|
|
756
|
-
"$ref": "#/definitions/Polygon"
|
|
757
|
-
},
|
|
758
|
-
{
|
|
759
|
-
"$ref": "#/definitions/MultiPolygon"
|
|
760
|
-
},
|
|
761
|
-
{
|
|
762
|
-
"$ref": "#/definitions/GeometryCollection"
|
|
763
|
-
}
|
|
764
|
-
],
|
|
765
|
-
"description": "Geometry object. https://tools.ietf.org/html/rfc7946#section-3"
|
|
766
|
-
},
|
|
767
|
-
"GeometryCollection": {
|
|
768
|
-
"description": "Geometry Collection https://tools.ietf.org/html/rfc7946#section-3.1.8",
|
|
769
|
-
"properties": {
|
|
770
|
-
"bbox": {
|
|
771
|
-
"$ref": "#/definitions/BBox",
|
|
772
|
-
"description": "Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections. The value of the bbox member is an array of length 2*n where n is the number of dimensions represented in the contained geometries, with all axes of the most southwesterly point followed by all axes of the more northeasterly point. The axes order of a bbox follows the axes order of geometries. https://tools.ietf.org/html/rfc7946#section-5"
|
|
773
|
-
},
|
|
774
|
-
"geometries": {
|
|
775
|
-
"items": {
|
|
776
|
-
"$ref": "#/definitions/Geometry"
|
|
777
|
-
},
|
|
778
|
-
"type": "array"
|
|
779
|
-
},
|
|
780
|
-
"type": {
|
|
781
|
-
"const": "GeometryCollection",
|
|
782
|
-
"description": "Specifies the type of GeoJSON object.",
|
|
783
|
-
"type": "string"
|
|
784
|
-
}
|
|
785
|
-
},
|
|
786
|
-
"required": [
|
|
787
|
-
"geometries",
|
|
788
|
-
"type"
|
|
789
1018
|
],
|
|
790
|
-
"
|
|
1019
|
+
"description": "A GPGPU compute pass over a table. Results are written to `feature.properties.compute.<column>`. It needs `outputColumnName` for a single result or `outputColumns` for several."
|
|
791
1020
|
},
|
|
792
|
-
"
|
|
793
|
-
"
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
{
|
|
802
|
-
"$ref": "#/definitions/WktGeometryColumns"
|
|
803
|
-
}
|
|
1021
|
+
"HeatmapAggregateFunction": {
|
|
1022
|
+
"description": "How the rows near a heatmap cell are combined into its value: any aggregate function but `collect`, which lists the rows, while a cell holds one value.",
|
|
1023
|
+
"enum": [
|
|
1024
|
+
"sum",
|
|
1025
|
+
"avg",
|
|
1026
|
+
"count",
|
|
1027
|
+
"min",
|
|
1028
|
+
"max",
|
|
1029
|
+
"weighted"
|
|
804
1030
|
],
|
|
805
|
-
"
|
|
1031
|
+
"type": "string"
|
|
806
1032
|
},
|
|
807
1033
|
"HeatmapSourceSpec": {
|
|
808
1034
|
"description": "Aggregates a table onto a regular grid, producing a raster heatmap table.",
|
|
@@ -824,13 +1050,19 @@
|
|
|
824
1050
|
"type": "object"
|
|
825
1051
|
},
|
|
826
1052
|
"groupBy": {
|
|
1053
|
+
"description": "Aggregate the rows near each cell, one raster band per entry.",
|
|
827
1054
|
"items": {
|
|
828
1055
|
"properties": {
|
|
829
1056
|
"aggregateFn": {
|
|
830
|
-
"$ref": "#/definitions/
|
|
1057
|
+
"$ref": "#/definitions/HeatmapAggregateFunction",
|
|
1058
|
+
"description": "How the rows combine into the cell's value: any aggregate but `collect`, which lists rows, while a cell holds one value."
|
|
831
1059
|
},
|
|
832
1060
|
"column": {
|
|
833
1061
|
"type": "string"
|
|
1062
|
+
},
|
|
1063
|
+
"normalize": {
|
|
1064
|
+
"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.",
|
|
1065
|
+
"type": "boolean"
|
|
834
1066
|
}
|
|
835
1067
|
},
|
|
836
1068
|
"required": [
|
|
@@ -840,11 +1072,20 @@
|
|
|
840
1072
|
},
|
|
841
1073
|
"type": "array"
|
|
842
1074
|
},
|
|
1075
|
+
"joinDataRef": {
|
|
1076
|
+
"description": "Table whose rows are aggregated onto the grid.",
|
|
1077
|
+
"type": "string"
|
|
1078
|
+
},
|
|
843
1079
|
"near": {
|
|
844
|
-
"description": "
|
|
1080
|
+
"description": "Which rows count toward a grid cell: those within `distance` of the cell's center.",
|
|
845
1081
|
"properties": {
|
|
846
1082
|
"distance": {
|
|
1083
|
+
"description": "Radius around each cell's center, in workspace units.",
|
|
847
1084
|
"type": "number"
|
|
1085
|
+
},
|
|
1086
|
+
"useCentroid": {
|
|
1087
|
+
"description": "Measure from the cell's center to each row's centroid, the default. With `false`, measure to the nearest point of the row's geometry, so a long road counts in every cell within `distance` of any part of it.",
|
|
1088
|
+
"type": "boolean"
|
|
848
1089
|
}
|
|
849
1090
|
},
|
|
850
1091
|
"required": [
|
|
@@ -856,20 +1097,20 @@
|
|
|
856
1097
|
"description": "Name of the table this source creates. Later sources, compute passes, maps and plots refer to it by this name.",
|
|
857
1098
|
"type": "string"
|
|
858
1099
|
},
|
|
859
|
-
"tableJoinName": {
|
|
860
|
-
"description": "Table whose rows are aggregated onto the grid.",
|
|
861
|
-
"type": "string"
|
|
862
|
-
},
|
|
863
1100
|
"type": {
|
|
864
1101
|
"const": "heatmap",
|
|
865
1102
|
"type": "string"
|
|
1103
|
+
},
|
|
1104
|
+
"workspace": {
|
|
1105
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
1106
|
+
"description": "Workspace the table is created in."
|
|
866
1107
|
}
|
|
867
1108
|
},
|
|
868
1109
|
"required": [
|
|
869
1110
|
"grid",
|
|
1111
|
+
"joinDataRef",
|
|
870
1112
|
"near",
|
|
871
1113
|
"outputTableName",
|
|
872
|
-
"tableJoinName",
|
|
873
1114
|
"type"
|
|
874
1115
|
],
|
|
875
1116
|
"type": "object"
|
|
@@ -902,8 +1143,13 @@
|
|
|
902
1143
|
"height": {
|
|
903
1144
|
"type": "number"
|
|
904
1145
|
},
|
|
1146
|
+
"id": {
|
|
1147
|
+
"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
|
+
"minLength": 1,
|
|
1149
|
+
"type": "string"
|
|
1150
|
+
},
|
|
905
1151
|
"mapRef": {
|
|
906
|
-
"description": "`dataRef` of the map layer this plot links its selection to.",
|
|
1152
|
+
"description": "`dataRef` of the map layer this plot links its selection to. A shorthand for a link in `links`.",
|
|
907
1153
|
"type": "string"
|
|
908
1154
|
},
|
|
909
1155
|
"margins": {
|
|
@@ -933,6 +1179,10 @@
|
|
|
933
1179
|
"const": "heatmatrix",
|
|
934
1180
|
"type": "string"
|
|
935
1181
|
},
|
|
1182
|
+
"osmElements": {
|
|
1183
|
+
"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
|
+
"type": "boolean"
|
|
1185
|
+
},
|
|
936
1186
|
"selectFields": {
|
|
937
1187
|
"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.",
|
|
938
1188
|
"items": {
|
|
@@ -949,6 +1199,10 @@
|
|
|
949
1199
|
},
|
|
950
1200
|
"width": {
|
|
951
1201
|
"type": "number"
|
|
1202
|
+
},
|
|
1203
|
+
"workspace": {
|
|
1204
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
1205
|
+
"description": "Workspace the table is read from."
|
|
952
1206
|
}
|
|
953
1207
|
},
|
|
954
1208
|
"required": [
|
|
@@ -1027,6 +1281,10 @@
|
|
|
1027
1281
|
"JoinSourceSpec": {
|
|
1028
1282
|
"description": "Spatially joins one table onto another. The result replaces the root table.",
|
|
1029
1283
|
"properties": {
|
|
1284
|
+
"dataRef": {
|
|
1285
|
+
"description": "Table that receives the joined columns.",
|
|
1286
|
+
"type": "string"
|
|
1287
|
+
},
|
|
1030
1288
|
"groupBy": {
|
|
1031
1289
|
"description": "Aggregate the joined rows per root feature.",
|
|
1032
1290
|
"items": {
|
|
@@ -1048,13 +1306,19 @@
|
|
|
1048
1306
|
},
|
|
1049
1307
|
"type": "array"
|
|
1050
1308
|
},
|
|
1309
|
+
"joinDataRef": {
|
|
1310
|
+
"description": "Table whose rows are joined onto the root table.",
|
|
1311
|
+
"type": "string"
|
|
1312
|
+
},
|
|
1051
1313
|
"near": {
|
|
1052
|
-
"description": "Join rows within `distance`
|
|
1314
|
+
"description": "Join the rows within `distance` of each root feature instead of the rows that intersect it.",
|
|
1053
1315
|
"properties": {
|
|
1054
1316
|
"distance": {
|
|
1317
|
+
"description": "Greatest distance from a root feature to a row it receives, in workspace units.",
|
|
1055
1318
|
"type": "number"
|
|
1056
1319
|
},
|
|
1057
1320
|
"useCentroid": {
|
|
1321
|
+
"description": "Measure from the root feature's centroid to the row's centroid, the default. With `false`, measure between the geometries themselves, from their nearest points, so features that touch are 0 apart.",
|
|
1058
1322
|
"type": "boolean"
|
|
1059
1323
|
}
|
|
1060
1324
|
},
|
|
@@ -1063,23 +1327,19 @@
|
|
|
1063
1327
|
],
|
|
1064
1328
|
"type": "object"
|
|
1065
1329
|
},
|
|
1066
|
-
"tableJoinName": {
|
|
1067
|
-
"description": "Table whose rows are joined onto the root table.",
|
|
1068
|
-
"type": "string"
|
|
1069
|
-
},
|
|
1070
|
-
"tableRootName": {
|
|
1071
|
-
"description": "Table that receives the joined columns.",
|
|
1072
|
-
"type": "string"
|
|
1073
|
-
},
|
|
1074
1330
|
"type": {
|
|
1075
1331
|
"const": "join",
|
|
1076
1332
|
"type": "string"
|
|
1333
|
+
},
|
|
1334
|
+
"workspace": {
|
|
1335
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
1336
|
+
"description": "Workspace of the two tables."
|
|
1077
1337
|
}
|
|
1078
1338
|
},
|
|
1079
1339
|
"required": [
|
|
1080
1340
|
"type",
|
|
1081
|
-
"
|
|
1082
|
-
"
|
|
1341
|
+
"dataRef",
|
|
1342
|
+
"joinDataRef"
|
|
1083
1343
|
],
|
|
1084
1344
|
"type": "object"
|
|
1085
1345
|
},
|
|
@@ -1113,6 +1373,10 @@
|
|
|
1113
1373
|
"type": {
|
|
1114
1374
|
"const": "json",
|
|
1115
1375
|
"type": "string"
|
|
1376
|
+
},
|
|
1377
|
+
"workspace": {
|
|
1378
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
1379
|
+
"description": "Workspace the table is created in."
|
|
1116
1380
|
}
|
|
1117
1381
|
},
|
|
1118
1382
|
"required": [
|
|
@@ -1163,6 +1427,32 @@
|
|
|
1163
1427
|
],
|
|
1164
1428
|
"type": "string"
|
|
1165
1429
|
},
|
|
1430
|
+
"LayoutSpec": {
|
|
1431
|
+
"description": "How the maps and plots of a specification are arranged on the page.\n\nThe engine does not read it: the host that creates the map canvases and the plot elements does, through `arrangeViews`, which gives each view its pane.",
|
|
1432
|
+
"properties": {
|
|
1433
|
+
"columns": {
|
|
1434
|
+
"description": "Number of columns of a `grid`, a whole number. Defaults to 2.",
|
|
1435
|
+
"minimum": 1,
|
|
1436
|
+
"multipleOf": 1,
|
|
1437
|
+
"type": "number"
|
|
1438
|
+
},
|
|
1439
|
+
"gap": {
|
|
1440
|
+
"description": "Space between views, in pixels. Defaults to 0.",
|
|
1441
|
+
"minimum": 0,
|
|
1442
|
+
"type": "number"
|
|
1443
|
+
},
|
|
1444
|
+
"type": {
|
|
1445
|
+
"description": "`vertical` stacks the views, `horizontal` puts them side by side, `grid` fills `columns` columns. Defaults to `vertical`.",
|
|
1446
|
+
"enum": [
|
|
1447
|
+
"vertical",
|
|
1448
|
+
"horizontal",
|
|
1449
|
+
"grid"
|
|
1450
|
+
],
|
|
1451
|
+
"type": "string"
|
|
1452
|
+
}
|
|
1453
|
+
},
|
|
1454
|
+
"type": "object"
|
|
1455
|
+
},
|
|
1166
1456
|
"LinePlotSpec": {
|
|
1167
1457
|
"description": "A line chart over a `reduce-series` or `binning-events` transform, which it requires.",
|
|
1168
1458
|
"properties": {
|
|
@@ -1191,8 +1481,13 @@
|
|
|
1191
1481
|
"height": {
|
|
1192
1482
|
"type": "number"
|
|
1193
1483
|
},
|
|
1484
|
+
"id": {
|
|
1485
|
+
"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
|
+
"minLength": 1,
|
|
1487
|
+
"type": "string"
|
|
1488
|
+
},
|
|
1194
1489
|
"mapRef": {
|
|
1195
|
-
"description": "`dataRef` of the map layer this plot links its selection to.",
|
|
1490
|
+
"description": "`dataRef` of the map layer this plot links its selection to. A shorthand for a link in `links`.",
|
|
1196
1491
|
"type": "string"
|
|
1197
1492
|
},
|
|
1198
1493
|
"margins": {
|
|
@@ -1225,6 +1520,10 @@
|
|
|
1225
1520
|
],
|
|
1226
1521
|
"type": "string"
|
|
1227
1522
|
},
|
|
1523
|
+
"osmElements": {
|
|
1524
|
+
"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
|
+
"type": "boolean"
|
|
1526
|
+
},
|
|
1228
1527
|
"selectFields": {
|
|
1229
1528
|
"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.",
|
|
1230
1529
|
"items": {
|
|
@@ -1241,6 +1540,10 @@
|
|
|
1241
1540
|
},
|
|
1242
1541
|
"width": {
|
|
1243
1542
|
"type": "number"
|
|
1543
|
+
},
|
|
1544
|
+
"workspace": {
|
|
1545
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
1546
|
+
"description": "Workspace the table is read from."
|
|
1244
1547
|
}
|
|
1245
1548
|
},
|
|
1246
1549
|
"required": [
|
|
@@ -1276,6 +1579,31 @@
|
|
|
1276
1579
|
],
|
|
1277
1580
|
"type": "object"
|
|
1278
1581
|
},
|
|
1582
|
+
"LinkSpec": {
|
|
1583
|
+
"description": "Links a plot to a layer of a map: selecting in the plot highlights the same features on the layer, and picking on the layer selects them in the plot. Read by the Autark adapter; the deck.gl adapter ignores it.",
|
|
1584
|
+
"properties": {
|
|
1585
|
+
"layer": {
|
|
1586
|
+
"description": "Layer of the target map, by its `title`, else its `dataRef`. Defaults to the layer that draws the plot's `dataRef`.",
|
|
1587
|
+
"minLength": 1,
|
|
1588
|
+
"type": "string"
|
|
1589
|
+
},
|
|
1590
|
+
"source": {
|
|
1591
|
+
"description": "`id` of the plot, or its `dataRef` when it has no id.",
|
|
1592
|
+
"minLength": 1,
|
|
1593
|
+
"type": "string"
|
|
1594
|
+
},
|
|
1595
|
+
"target": {
|
|
1596
|
+
"description": "`id` of the map that highlights.",
|
|
1597
|
+
"minLength": 1,
|
|
1598
|
+
"type": "string"
|
|
1599
|
+
}
|
|
1600
|
+
},
|
|
1601
|
+
"required": [
|
|
1602
|
+
"source",
|
|
1603
|
+
"target"
|
|
1604
|
+
],
|
|
1605
|
+
"type": "object"
|
|
1606
|
+
},
|
|
1279
1607
|
"MapLayerSpec": {
|
|
1280
1608
|
"description": "One layer drawn by a map.",
|
|
1281
1609
|
"if": {
|
|
@@ -1391,6 +1719,10 @@
|
|
|
1391
1719
|
"description": "Layer opacity, from 0 to 1.",
|
|
1392
1720
|
"type": "number"
|
|
1393
1721
|
},
|
|
1722
|
+
"osmElements": {
|
|
1723
|
+
"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.",
|
|
1724
|
+
"type": "boolean"
|
|
1725
|
+
},
|
|
1394
1726
|
"pickedComps": {
|
|
1395
1727
|
"description": "Feature ids drawn as picked. Read by the deck.gl adapter; the Autark adapter ignores it.",
|
|
1396
1728
|
"items": {
|
|
@@ -1398,6 +1730,11 @@
|
|
|
1398
1730
|
},
|
|
1399
1731
|
"type": "array"
|
|
1400
1732
|
},
|
|
1733
|
+
"pointSize": {
|
|
1734
|
+
"description": "Radius of each point of a points layer, in meters on the ground. The Autark adapter converts it to the workspace's planar units at the middle of the layer's extent, where World Mercator, the default, stretches a meter by about 1.34 at Chicago, and passes it as autk-map's `pointSize`. Without it, autk-map's radius of 64 planar units applies. Other layers and the deck.gl adapter ignore it.",
|
|
1735
|
+
"exclusiveMinimum": 0,
|
|
1736
|
+
"type": "number"
|
|
1737
|
+
},
|
|
1401
1738
|
"selectFields": {
|
|
1402
1739
|
"description": "Columns whose values name the rows a pick on this layer selects, so an app can link the selection to other tables that hold those columns. Neither adapter reads it: the Autark adapter's `map:picking` events still report feature ids.",
|
|
1403
1740
|
"items": {
|
|
@@ -1448,6 +1785,15 @@
|
|
|
1448
1785
|
"MapSpec": {
|
|
1449
1786
|
"description": "A map view.",
|
|
1450
1787
|
"properties": {
|
|
1788
|
+
"camera": {
|
|
1789
|
+
"$ref": "#/definitions/CameraSpec",
|
|
1790
|
+
"description": "Where the map looks from."
|
|
1791
|
+
},
|
|
1792
|
+
"id": {
|
|
1793
|
+
"description": "Name of the map, which a link in `links` uses as its `target`. Unique among the ids of the maps and plots.",
|
|
1794
|
+
"minLength": 1,
|
|
1795
|
+
"type": "string"
|
|
1796
|
+
},
|
|
1451
1797
|
"layerRefs": {
|
|
1452
1798
|
"description": "Layers to draw, bottom first. Each names a table with `dataRef`.",
|
|
1453
1799
|
"items": {
|
|
@@ -1458,6 +1804,10 @@
|
|
|
1458
1804
|
"style": {
|
|
1459
1805
|
"description": "Map style.",
|
|
1460
1806
|
"type": "string"
|
|
1807
|
+
},
|
|
1808
|
+
"workspace": {
|
|
1809
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
1810
|
+
"description": "Workspace the map reads its layers' tables from."
|
|
1461
1811
|
}
|
|
1462
1812
|
},
|
|
1463
1813
|
"required": [
|
|
@@ -1612,10 +1962,19 @@
|
|
|
1612
1962
|
},
|
|
1613
1963
|
"OsmDataSourceSpec": {
|
|
1614
1964
|
"description": "Loads OpenStreetMap data for a named area or a box, from Overpass or from a PBF extract.",
|
|
1965
|
+
"if": {
|
|
1966
|
+
"required": [
|
|
1967
|
+
"pbfFileUrl"
|
|
1968
|
+
]
|
|
1969
|
+
},
|
|
1615
1970
|
"properties": {
|
|
1616
1971
|
"autoLoadLayers": {
|
|
1617
1972
|
"description": "Split the raw OSM table into one table per layer, named `<outputTableName>_<layer>`.",
|
|
1618
1973
|
"properties": {
|
|
1974
|
+
"coordinateFormat": {
|
|
1975
|
+
"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.",
|
|
1976
|
+
"type": "string"
|
|
1977
|
+
},
|
|
1619
1978
|
"dropOsmTable": {
|
|
1620
1979
|
"description": "Currently ignored by both adapters.",
|
|
1621
1980
|
"type": "boolean"
|
|
@@ -1632,6 +1991,10 @@
|
|
|
1632
1991
|
],
|
|
1633
1992
|
"type": "object"
|
|
1634
1993
|
},
|
|
1994
|
+
"forceRefresh": {
|
|
1995
|
+
"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.",
|
|
1996
|
+
"type": "boolean"
|
|
1997
|
+
},
|
|
1635
1998
|
"outputTableName": {
|
|
1636
1999
|
"description": "Name of the table this source creates. Later sources, compute passes, maps and plots refer to it by this name.",
|
|
1637
2000
|
"type": "string"
|
|
@@ -1651,9 +2014,21 @@
|
|
|
1651
2014
|
],
|
|
1652
2015
|
"description": "Area to load: sub-areas inside a geocoded region (`geocodeArea` with `areas`), or a box (`bbox`), not both."
|
|
1653
2016
|
},
|
|
2017
|
+
"tagSets": {
|
|
2018
|
+
"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.",
|
|
2019
|
+
"items": {
|
|
2020
|
+
"$ref": "#/definitions/OsmTagSet"
|
|
2021
|
+
},
|
|
2022
|
+
"maxItems": 8,
|
|
2023
|
+
"type": "array"
|
|
2024
|
+
},
|
|
1654
2025
|
"type": {
|
|
1655
2026
|
"const": "osm",
|
|
1656
2027
|
"type": "string"
|
|
2028
|
+
},
|
|
2029
|
+
"workspace": {
|
|
2030
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
2031
|
+
"description": "Workspace the table is created in."
|
|
1657
2032
|
}
|
|
1658
2033
|
},
|
|
1659
2034
|
"required": [
|
|
@@ -1661,30 +2036,96 @@
|
|
|
1661
2036
|
"queryArea",
|
|
1662
2037
|
"type"
|
|
1663
2038
|
],
|
|
2039
|
+
"then": {
|
|
2040
|
+
"not": {
|
|
2041
|
+
"properties": {
|
|
2042
|
+
"tagSets": {
|
|
2043
|
+
"minItems": 1
|
|
2044
|
+
}
|
|
2045
|
+
},
|
|
2046
|
+
"required": [
|
|
2047
|
+
"tagSets"
|
|
2048
|
+
]
|
|
2049
|
+
}
|
|
2050
|
+
},
|
|
1664
2051
|
"type": "object"
|
|
1665
2052
|
},
|
|
1666
2053
|
"OsmNamedArea": {
|
|
1667
2054
|
"description": "An area named by OpenStreetMap boundaries: sub-areas inside a geocoded region.",
|
|
1668
2055
|
"properties": {
|
|
1669
|
-
"areas": {
|
|
1670
|
-
"description": "Sub-areas inside the region, for example neighborhood names.",
|
|
2056
|
+
"areas": {
|
|
2057
|
+
"description": "Sub-areas inside the region, for example neighborhood names.",
|
|
2058
|
+
"items": {
|
|
2059
|
+
"type": "string"
|
|
2060
|
+
},
|
|
2061
|
+
"type": "array"
|
|
2062
|
+
},
|
|
2063
|
+
"bbox": {
|
|
2064
|
+
"description": "Not with `geocodeArea` and `areas`.",
|
|
2065
|
+
"not": {}
|
|
2066
|
+
},
|
|
2067
|
+
"geocodeArea": {
|
|
2068
|
+
"description": "Region to geocode, for example a city name.",
|
|
2069
|
+
"type": "string"
|
|
2070
|
+
}
|
|
2071
|
+
},
|
|
2072
|
+
"required": [
|
|
2073
|
+
"geocodeArea",
|
|
2074
|
+
"areas"
|
|
2075
|
+
],
|
|
2076
|
+
"type": "object"
|
|
2077
|
+
},
|
|
2078
|
+
"OsmTagFilter": {
|
|
2079
|
+
"description": "An OpenStreetMap tag a tag set matches: the tag `key` with the value `value`, or with any value when `value` is omitted.",
|
|
2080
|
+
"properties": {
|
|
2081
|
+
"key": {
|
|
2082
|
+
"description": "The tag's key, such as `amenity` or `addr:street`: letters, digits, `_`, `:`, `.` and `-`, starting with a letter or a digit.",
|
|
2083
|
+
"pattern": "^[A-Za-z0-9][A-Za-z0-9_:.-]{0,254}$",
|
|
2084
|
+
"type": "string"
|
|
2085
|
+
},
|
|
2086
|
+
"value": {
|
|
2087
|
+
"description": "The tag's value, such as `cafe`. Without it, the key with any value matches.",
|
|
2088
|
+
"maxLength": 255,
|
|
2089
|
+
"minLength": 1,
|
|
2090
|
+
"type": "string"
|
|
2091
|
+
}
|
|
2092
|
+
},
|
|
2093
|
+
"required": [
|
|
2094
|
+
"key"
|
|
2095
|
+
],
|
|
2096
|
+
"type": "object"
|
|
2097
|
+
},
|
|
2098
|
+
"OsmTagSet": {
|
|
2099
|
+
"description": "OpenStreetMap features chosen by their tags, as one table of one geometry type.",
|
|
2100
|
+
"properties": {
|
|
2101
|
+
"name": {
|
|
2102
|
+
"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.",
|
|
2103
|
+
"pattern": "^[a-z][a-z0-9_]{0,31}$",
|
|
2104
|
+
"type": "string"
|
|
2105
|
+
},
|
|
2106
|
+
"tags": {
|
|
2107
|
+
"description": "The tags a feature is chosen by: it is in the set when it has any one of them.",
|
|
1671
2108
|
"items": {
|
|
1672
|
-
"
|
|
2109
|
+
"$ref": "#/definitions/OsmTagFilter"
|
|
1673
2110
|
},
|
|
2111
|
+
"maxItems": 64,
|
|
2112
|
+
"minItems": 1,
|
|
1674
2113
|
"type": "array"
|
|
1675
2114
|
},
|
|
1676
|
-
"
|
|
1677
|
-
"description": "
|
|
1678
|
-
"
|
|
1679
|
-
|
|
1680
|
-
|
|
1681
|
-
|
|
2115
|
+
"type": {
|
|
2116
|
+
"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.",
|
|
2117
|
+
"enum": [
|
|
2118
|
+
"points",
|
|
2119
|
+
"polylines",
|
|
2120
|
+
"polygons"
|
|
2121
|
+
],
|
|
1682
2122
|
"type": "string"
|
|
1683
2123
|
}
|
|
1684
2124
|
},
|
|
1685
2125
|
"required": [
|
|
1686
|
-
"
|
|
1687
|
-
"
|
|
2126
|
+
"name",
|
|
2127
|
+
"type",
|
|
2128
|
+
"tags"
|
|
1688
2129
|
],
|
|
1689
2130
|
"type": "object"
|
|
1690
2131
|
},
|
|
@@ -1716,8 +2157,13 @@
|
|
|
1716
2157
|
"height": {
|
|
1717
2158
|
"type": "number"
|
|
1718
2159
|
},
|
|
2160
|
+
"id": {
|
|
2161
|
+
"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
|
+
"minLength": 1,
|
|
2163
|
+
"type": "string"
|
|
2164
|
+
},
|
|
1719
2165
|
"mapRef": {
|
|
1720
|
-
"description": "`dataRef` of the map layer this plot links its selection to.",
|
|
2166
|
+
"description": "`dataRef` of the map layer this plot links its selection to. A shorthand for a link in `links`.",
|
|
1721
2167
|
"type": "string"
|
|
1722
2168
|
},
|
|
1723
2169
|
"margins": {
|
|
@@ -1747,6 +2193,10 @@
|
|
|
1747
2193
|
"const": "parallel-coordinates",
|
|
1748
2194
|
"type": "string"
|
|
1749
2195
|
},
|
|
2196
|
+
"osmElements": {
|
|
2197
|
+
"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
|
+
"type": "boolean"
|
|
2199
|
+
},
|
|
1750
2200
|
"selectFields": {
|
|
1751
2201
|
"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.",
|
|
1752
2202
|
"items": {
|
|
@@ -1763,6 +2213,10 @@
|
|
|
1763
2213
|
},
|
|
1764
2214
|
"width": {
|
|
1765
2215
|
"type": "number"
|
|
2216
|
+
},
|
|
2217
|
+
"workspace": {
|
|
2218
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
2219
|
+
"description": "Workspace the table is read from."
|
|
1766
2220
|
}
|
|
1767
2221
|
},
|
|
1768
2222
|
"required": [
|
|
@@ -2076,6 +2530,213 @@
|
|
|
2076
2530
|
},
|
|
2077
2531
|
"type": "object"
|
|
2078
2532
|
},
|
|
2533
|
+
"RenderComputeSpec": {
|
|
2534
|
+
"description": "A render-based compute pass: from each viewpoint of a table it renders the layers in several directions on the GPU and counts what each frame shows (a visibility or sky-view metric). The result, the viewpoints table's features (one point per window with the `building-windows` strategy) with the metrics in `feature.properties.compute.render`, is stored as the table `outputTableName`. Read by the Autark adapter only.",
|
|
2535
|
+
"properties": {
|
|
2536
|
+
"aggregation": {
|
|
2537
|
+
"anyOf": [
|
|
2538
|
+
{
|
|
2539
|
+
"properties": {
|
|
2540
|
+
"backgroundLayerType": {
|
|
2541
|
+
"description": "Name of that class. Defaults to `background`, and it must not be the type of a rendered layer.",
|
|
2542
|
+
"type": "string"
|
|
2543
|
+
},
|
|
2544
|
+
"includeBackground": {
|
|
2545
|
+
"description": "Also count the pixels where no layer is drawn, such as the sky, as one more class.",
|
|
2546
|
+
"type": "boolean"
|
|
2547
|
+
},
|
|
2548
|
+
"type": {
|
|
2549
|
+
"const": "classes",
|
|
2550
|
+
"type": "string"
|
|
2551
|
+
}
|
|
2552
|
+
},
|
|
2553
|
+
"required": [
|
|
2554
|
+
"type"
|
|
2555
|
+
],
|
|
2556
|
+
"type": "object"
|
|
2557
|
+
},
|
|
2558
|
+
{
|
|
2559
|
+
"properties": {
|
|
2560
|
+
"type": {
|
|
2561
|
+
"const": "objects",
|
|
2562
|
+
"type": "string"
|
|
2563
|
+
}
|
|
2564
|
+
},
|
|
2565
|
+
"required": [
|
|
2566
|
+
"type"
|
|
2567
|
+
],
|
|
2568
|
+
"type": "object"
|
|
2569
|
+
}
|
|
2570
|
+
],
|
|
2571
|
+
"description": "What each feature of the result receives: `classes`, the share of its frames' pixels each layer type covers, from 0 to 1; `objects`, for each object seen, the share of its frames that show it."
|
|
2572
|
+
},
|
|
2573
|
+
"camera": {
|
|
2574
|
+
"description": "The lens of the frames each viewpoint renders. Unlike a map's `camera`, which sets where a map view looks from, it sets no position or direction: `viewpoints` does.",
|
|
2575
|
+
"properties": {
|
|
2576
|
+
"clip": {
|
|
2577
|
+
"description": "How near and how far from the viewpoint the frames show the layers, in workspace units.",
|
|
2578
|
+
"properties": {
|
|
2579
|
+
"far": {
|
|
2580
|
+
"description": "Farthest distance drawn. Defaults to 5000.",
|
|
2581
|
+
"type": "number"
|
|
2582
|
+
},
|
|
2583
|
+
"near": {
|
|
2584
|
+
"description": "Nearest distance drawn. Defaults to 1.",
|
|
2585
|
+
"type": "number"
|
|
2586
|
+
}
|
|
2587
|
+
},
|
|
2588
|
+
"type": "object"
|
|
2589
|
+
},
|
|
2590
|
+
"fov": {
|
|
2591
|
+
"description": "Field of view of each square frame, in degrees. Defaults to 90.",
|
|
2592
|
+
"type": "number"
|
|
2593
|
+
}
|
|
2594
|
+
},
|
|
2595
|
+
"type": "object"
|
|
2596
|
+
},
|
|
2597
|
+
"layerType": {
|
|
2598
|
+
"$ref": "#/definitions/LayerType",
|
|
2599
|
+
"description": "How the map draws the new table. Defaults to the type of the viewpoints table, or to `points` with the `building-windows` strategy, whose result holds one point per window."
|
|
2600
|
+
},
|
|
2601
|
+
"layers": {
|
|
2602
|
+
"description": "Layers to render.",
|
|
2603
|
+
"items": {
|
|
2604
|
+
"$ref": "#/definitions/RenderLayerSpec"
|
|
2605
|
+
},
|
|
2606
|
+
"minItems": 1,
|
|
2607
|
+
"type": "array"
|
|
2608
|
+
},
|
|
2609
|
+
"outputTableName": {
|
|
2610
|
+
"description": "Name of the table that receives the result. Later passes, maps and plots read it by this name.",
|
|
2611
|
+
"type": "string"
|
|
2612
|
+
},
|
|
2613
|
+
"tileSize": {
|
|
2614
|
+
"description": "Frame size in pixels.",
|
|
2615
|
+
"minimum": 8,
|
|
2616
|
+
"multipleOf": 8,
|
|
2617
|
+
"type": "number"
|
|
2618
|
+
},
|
|
2619
|
+
"type": {
|
|
2620
|
+
"const": "render",
|
|
2621
|
+
"description": "Selects a render pass.",
|
|
2622
|
+
"type": "string"
|
|
2623
|
+
},
|
|
2624
|
+
"viewpoints": {
|
|
2625
|
+
"description": "Where the frames are rendered from: the features of a table, and the directions each one looks in.",
|
|
2626
|
+
"properties": {
|
|
2627
|
+
"dataRef": {
|
|
2628
|
+
"description": "Name of the table whose features are the viewpoints.",
|
|
2629
|
+
"type": "string"
|
|
2630
|
+
},
|
|
2631
|
+
"sampling": {
|
|
2632
|
+
"description": "The directions each viewpoint looks in, around the horizon. Read with the `centroid` strategy only.",
|
|
2633
|
+
"properties": {
|
|
2634
|
+
"azimuthOffsetDeg": {
|
|
2635
|
+
"description": "Angle of the first direction, in degrees counterclockwise from east (0 looks east, 90 north); the others follow every 360 / `directions` degrees. Defaults to 0.",
|
|
2636
|
+
"type": "number"
|
|
2637
|
+
},
|
|
2638
|
+
"directions": {
|
|
2639
|
+
"description": "Directions sampled around each viewpoint, evenly spaced. Defaults to 1.",
|
|
2640
|
+
"type": "number"
|
|
2641
|
+
},
|
|
2642
|
+
"pitchDeg": {
|
|
2643
|
+
"description": "Angle of every direction above the horizontal, in degrees: up when positive, down when negative. Defaults to 0.",
|
|
2644
|
+
"type": "number"
|
|
2645
|
+
}
|
|
2646
|
+
},
|
|
2647
|
+
"type": "object"
|
|
2648
|
+
},
|
|
2649
|
+
"strategy": {
|
|
2650
|
+
"anyOf": [
|
|
2651
|
+
{
|
|
2652
|
+
"properties": {
|
|
2653
|
+
"type": {
|
|
2654
|
+
"const": "centroid",
|
|
2655
|
+
"type": "string"
|
|
2656
|
+
}
|
|
2657
|
+
},
|
|
2658
|
+
"required": [
|
|
2659
|
+
"type"
|
|
2660
|
+
],
|
|
2661
|
+
"type": "object"
|
|
2662
|
+
},
|
|
2663
|
+
{
|
|
2664
|
+
"properties": {
|
|
2665
|
+
"floors": {
|
|
2666
|
+
"description": "Rows of windows on each facade, spread evenly up the building's height.",
|
|
2667
|
+
"type": "number"
|
|
2668
|
+
},
|
|
2669
|
+
"type": {
|
|
2670
|
+
"const": "building-windows",
|
|
2671
|
+
"type": "string"
|
|
2672
|
+
}
|
|
2673
|
+
},
|
|
2674
|
+
"required": [
|
|
2675
|
+
"type",
|
|
2676
|
+
"floors"
|
|
2677
|
+
],
|
|
2678
|
+
"type": "object"
|
|
2679
|
+
}
|
|
2680
|
+
],
|
|
2681
|
+
"description": "Where the viewpoints are: each feature's centroid (the default), looking in the directions `sampling` sets, or `building-windows`: windows along each building's facades, each looking out from the facade and 30 degrees to either side. The result then holds one point per window instead of the table's features."
|
|
2682
|
+
}
|
|
2683
|
+
},
|
|
2684
|
+
"required": [
|
|
2685
|
+
"dataRef"
|
|
2686
|
+
],
|
|
2687
|
+
"type": "object"
|
|
2688
|
+
},
|
|
2689
|
+
"workspace": {
|
|
2690
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
2691
|
+
"description": "Workspace of the tables the pass reads and writes."
|
|
2692
|
+
}
|
|
2693
|
+
},
|
|
2694
|
+
"required": [
|
|
2695
|
+
"type",
|
|
2696
|
+
"outputTableName",
|
|
2697
|
+
"layers",
|
|
2698
|
+
"viewpoints",
|
|
2699
|
+
"aggregation"
|
|
2700
|
+
],
|
|
2701
|
+
"type": "object"
|
|
2702
|
+
},
|
|
2703
|
+
"RenderLayerSpec": {
|
|
2704
|
+
"description": "A table drawn into the frames a render pass samples.",
|
|
2705
|
+
"properties": {
|
|
2706
|
+
"dataRef": {
|
|
2707
|
+
"description": "Name of the table to draw.",
|
|
2708
|
+
"type": "string"
|
|
2709
|
+
},
|
|
2710
|
+
"id": {
|
|
2711
|
+
"description": "Name given to the layer in the pass. Letters, digits and underscores, not starting with a digit.",
|
|
2712
|
+
"pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
|
|
2713
|
+
"type": "string"
|
|
2714
|
+
},
|
|
2715
|
+
"objectIdProperty": {
|
|
2716
|
+
"description": "Property that holds the object's id, for `aggregation.type` `objects`.",
|
|
2717
|
+
"type": "string"
|
|
2718
|
+
},
|
|
2719
|
+
"type": {
|
|
2720
|
+
"description": "How the layer is drawn into the frames. A render pass draws no points.",
|
|
2721
|
+
"enum": [
|
|
2722
|
+
"surface",
|
|
2723
|
+
"parks",
|
|
2724
|
+
"water",
|
|
2725
|
+
"roads",
|
|
2726
|
+
"buildings",
|
|
2727
|
+
"polygons",
|
|
2728
|
+
"polylines"
|
|
2729
|
+
],
|
|
2730
|
+
"type": "string"
|
|
2731
|
+
}
|
|
2732
|
+
},
|
|
2733
|
+
"required": [
|
|
2734
|
+
"id",
|
|
2735
|
+
"dataRef",
|
|
2736
|
+
"type"
|
|
2737
|
+
],
|
|
2738
|
+
"type": "object"
|
|
2739
|
+
},
|
|
2079
2740
|
"ScatterPlotSpec": {
|
|
2080
2741
|
"description": "A scatterplot of two or more columns.",
|
|
2081
2742
|
"properties": {
|
|
@@ -2104,8 +2765,13 @@
|
|
|
2104
2765
|
"height": {
|
|
2105
2766
|
"type": "number"
|
|
2106
2767
|
},
|
|
2768
|
+
"id": {
|
|
2769
|
+
"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
|
+
"minLength": 1,
|
|
2771
|
+
"type": "string"
|
|
2772
|
+
},
|
|
2107
2773
|
"mapRef": {
|
|
2108
|
-
"description": "`dataRef` of the map layer this plot links its selection to.",
|
|
2774
|
+
"description": "`dataRef` of the map layer this plot links its selection to. A shorthand for a link in `links`.",
|
|
2109
2775
|
"type": "string"
|
|
2110
2776
|
},
|
|
2111
2777
|
"margins": {
|
|
@@ -2135,6 +2801,10 @@
|
|
|
2135
2801
|
"const": "scatter",
|
|
2136
2802
|
"type": "string"
|
|
2137
2803
|
},
|
|
2804
|
+
"osmElements": {
|
|
2805
|
+
"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
|
+
"type": "boolean"
|
|
2807
|
+
},
|
|
2138
2808
|
"selectFields": {
|
|
2139
2809
|
"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.",
|
|
2140
2810
|
"items": {
|
|
@@ -2151,6 +2821,10 @@
|
|
|
2151
2821
|
},
|
|
2152
2822
|
"width": {
|
|
2153
2823
|
"type": "number"
|
|
2824
|
+
},
|
|
2825
|
+
"workspace": {
|
|
2826
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
2827
|
+
"description": "Workspace the table is read from."
|
|
2154
2828
|
}
|
|
2155
2829
|
},
|
|
2156
2830
|
"required": [
|
|
@@ -2160,6 +2834,38 @@
|
|
|
2160
2834
|
],
|
|
2161
2835
|
"type": "object"
|
|
2162
2836
|
},
|
|
2837
|
+
"SqlSourceSpec": {
|
|
2838
|
+
"description": "Saves the rows of a SQL query over the workspace's tables as a new table. Read by the Autark adapter only.",
|
|
2839
|
+
"properties": {
|
|
2840
|
+
"layerType": {
|
|
2841
|
+
"$ref": "#/definitions/LayerType",
|
|
2842
|
+
"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."
|
|
2843
|
+
},
|
|
2844
|
+
"outputTableName": {
|
|
2845
|
+
"description": "Name of the table this source creates. Later sources, compute passes, maps and plots refer to it by this name.",
|
|
2846
|
+
"type": "string"
|
|
2847
|
+
},
|
|
2848
|
+
"query": {
|
|
2849
|
+
"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.",
|
|
2850
|
+
"minLength": 1,
|
|
2851
|
+
"type": "string"
|
|
2852
|
+
},
|
|
2853
|
+
"type": {
|
|
2854
|
+
"const": "sql",
|
|
2855
|
+
"type": "string"
|
|
2856
|
+
},
|
|
2857
|
+
"workspace": {
|
|
2858
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
2859
|
+
"description": "Workspace the table is created in."
|
|
2860
|
+
}
|
|
2861
|
+
},
|
|
2862
|
+
"required": [
|
|
2863
|
+
"outputTableName",
|
|
2864
|
+
"query",
|
|
2865
|
+
"type"
|
|
2866
|
+
],
|
|
2867
|
+
"type": "object"
|
|
2868
|
+
},
|
|
2163
2869
|
"TablePlotSpec": {
|
|
2164
2870
|
"description": "A table. A transform, when given, must be `sort`.",
|
|
2165
2871
|
"properties": {
|
|
@@ -2188,8 +2894,13 @@
|
|
|
2188
2894
|
"height": {
|
|
2189
2895
|
"type": "number"
|
|
2190
2896
|
},
|
|
2897
|
+
"id": {
|
|
2898
|
+
"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
|
+
"minLength": 1,
|
|
2900
|
+
"type": "string"
|
|
2901
|
+
},
|
|
2191
2902
|
"mapRef": {
|
|
2192
|
-
"description": "`dataRef` of the map layer this plot links its selection to.",
|
|
2903
|
+
"description": "`dataRef` of the map layer this plot links its selection to. A shorthand for a link in `links`.",
|
|
2193
2904
|
"type": "string"
|
|
2194
2905
|
},
|
|
2195
2906
|
"margins": {
|
|
@@ -2219,6 +2930,10 @@
|
|
|
2219
2930
|
"const": "table",
|
|
2220
2931
|
"type": "string"
|
|
2221
2932
|
},
|
|
2933
|
+
"osmElements": {
|
|
2934
|
+
"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
|
+
"type": "boolean"
|
|
2936
|
+
},
|
|
2222
2937
|
"selectFields": {
|
|
2223
2938
|
"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.",
|
|
2224
2939
|
"items": {
|
|
@@ -2235,6 +2950,10 @@
|
|
|
2235
2950
|
},
|
|
2236
2951
|
"width": {
|
|
2237
2952
|
"type": "number"
|
|
2953
|
+
},
|
|
2954
|
+
"workspace": {
|
|
2955
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
2956
|
+
"description": "Workspace the table is read from."
|
|
2238
2957
|
}
|
|
2239
2958
|
},
|
|
2240
2959
|
"required": [
|
|
@@ -2244,6 +2963,102 @@
|
|
|
2244
2963
|
],
|
|
2245
2964
|
"type": "object"
|
|
2246
2965
|
},
|
|
2966
|
+
"UpdateSourceSpec": {
|
|
2967
|
+
"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
|
+
"else": {
|
|
2969
|
+
"if": {
|
|
2970
|
+
"properties": {
|
|
2971
|
+
"strategy": {
|
|
2972
|
+
"const": "update"
|
|
2973
|
+
}
|
|
2974
|
+
},
|
|
2975
|
+
"required": [
|
|
2976
|
+
"strategy"
|
|
2977
|
+
]
|
|
2978
|
+
},
|
|
2979
|
+
"required": [
|
|
2980
|
+
"jsonObject"
|
|
2981
|
+
],
|
|
2982
|
+
"then": {
|
|
2983
|
+
"required": [
|
|
2984
|
+
"idColumn"
|
|
2985
|
+
]
|
|
2986
|
+
}
|
|
2987
|
+
},
|
|
2988
|
+
"if": {
|
|
2989
|
+
"required": [
|
|
2990
|
+
"geojsonObject"
|
|
2991
|
+
]
|
|
2992
|
+
},
|
|
2993
|
+
"properties": {
|
|
2994
|
+
"dataRef": {
|
|
2995
|
+
"description": "The table to change.",
|
|
2996
|
+
"type": "string"
|
|
2997
|
+
},
|
|
2998
|
+
"geojsonObject": {
|
|
2999
|
+
"$ref": "#/definitions/InlineFeatureCollection",
|
|
3000
|
+
"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."
|
|
3001
|
+
},
|
|
3002
|
+
"idColumn": {
|
|
3003
|
+
"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`.",
|
|
3004
|
+
"minLength": 1,
|
|
3005
|
+
"type": "string"
|
|
3006
|
+
},
|
|
3007
|
+
"jsonObject": {
|
|
3008
|
+
"description": "The rows of a table without a geometry, such as a CSV or JSON table loaded without `geometryColumns`.",
|
|
3009
|
+
"items": {
|
|
3010
|
+
"additionalProperties": {},
|
|
3011
|
+
"type": "object"
|
|
3012
|
+
},
|
|
3013
|
+
"minItems": 1,
|
|
3014
|
+
"type": "array"
|
|
3015
|
+
},
|
|
3016
|
+
"strategy": {
|
|
3017
|
+
"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.",
|
|
3018
|
+
"enum": [
|
|
3019
|
+
"replace",
|
|
3020
|
+
"update"
|
|
3021
|
+
],
|
|
3022
|
+
"type": "string"
|
|
3023
|
+
},
|
|
3024
|
+
"type": {
|
|
3025
|
+
"const": "update",
|
|
3026
|
+
"type": "string"
|
|
3027
|
+
},
|
|
3028
|
+
"workspace": {
|
|
3029
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
3030
|
+
"description": "Workspace of the table."
|
|
3031
|
+
}
|
|
3032
|
+
},
|
|
3033
|
+
"required": [
|
|
3034
|
+
"type",
|
|
3035
|
+
"dataRef",
|
|
3036
|
+
"strategy"
|
|
3037
|
+
],
|
|
3038
|
+
"then": {
|
|
3039
|
+
"if": {
|
|
3040
|
+
"properties": {
|
|
3041
|
+
"strategy": {
|
|
3042
|
+
"const": "update"
|
|
3043
|
+
}
|
|
3044
|
+
},
|
|
3045
|
+
"required": [
|
|
3046
|
+
"strategy"
|
|
3047
|
+
]
|
|
3048
|
+
},
|
|
3049
|
+
"not": {
|
|
3050
|
+
"required": [
|
|
3051
|
+
"jsonObject"
|
|
3052
|
+
]
|
|
3053
|
+
},
|
|
3054
|
+
"then": {
|
|
3055
|
+
"required": [
|
|
3056
|
+
"idColumn"
|
|
3057
|
+
]
|
|
3058
|
+
}
|
|
3059
|
+
},
|
|
3060
|
+
"type": "object"
|
|
3061
|
+
},
|
|
2247
3062
|
"UrbanSpec": {
|
|
2248
3063
|
"description": "An Autark grammar specification. It names at least one of `data`, `compute`, `map` or `plot`.",
|
|
2249
3064
|
"properties": {
|
|
@@ -2265,6 +3080,17 @@
|
|
|
2265
3080
|
},
|
|
2266
3081
|
"type": "array"
|
|
2267
3082
|
},
|
|
3083
|
+
"layout": {
|
|
3084
|
+
"$ref": "#/definitions/LayoutSpec",
|
|
3085
|
+
"description": "How the host arranges the maps and plots."
|
|
3086
|
+
},
|
|
3087
|
+
"links": {
|
|
3088
|
+
"description": "Links between plots and map layers. The engine does not read them; the adapter wires them once the maps and plots exist.",
|
|
3089
|
+
"items": {
|
|
3090
|
+
"$ref": "#/definitions/LinkSpec"
|
|
3091
|
+
},
|
|
3092
|
+
"type": "array"
|
|
3093
|
+
},
|
|
2268
3094
|
"map": {
|
|
2269
3095
|
"anyOf": [
|
|
2270
3096
|
{
|
|
@@ -2292,6 +3118,13 @@
|
|
|
2292
3118
|
}
|
|
2293
3119
|
],
|
|
2294
3120
|
"description": "One plot, or several."
|
|
3121
|
+
},
|
|
3122
|
+
"workspaces": {
|
|
3123
|
+
"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.",
|
|
3124
|
+
"items": {
|
|
3125
|
+
"$ref": "#/definitions/WorkspaceSpec"
|
|
3126
|
+
},
|
|
3127
|
+
"type": "array"
|
|
2295
3128
|
}
|
|
2296
3129
|
},
|
|
2297
3130
|
"type": "object"
|
|
@@ -2311,6 +3144,35 @@
|
|
|
2311
3144
|
"wktColumnName"
|
|
2312
3145
|
],
|
|
2313
3146
|
"type": "object"
|
|
3147
|
+
},
|
|
3148
|
+
"WorkspaceName": {
|
|
3149
|
+
"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.",
|
|
3150
|
+
"minLength": 1,
|
|
3151
|
+
"type": "string"
|
|
3152
|
+
},
|
|
3153
|
+
"WorkspaceSpec": {
|
|
3154
|
+
"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.",
|
|
3155
|
+
"properties": {
|
|
3156
|
+
"coordinateFormat": {
|
|
3157
|
+
"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.",
|
|
3158
|
+
"minLength": 1,
|
|
3159
|
+
"type": "string"
|
|
3160
|
+
},
|
|
3161
|
+
"name": {
|
|
3162
|
+
"$ref": "#/definitions/WorkspaceName",
|
|
3163
|
+
"description": "The workspace, by the name sources, compute passes, maps and plots give as their `workspace`. Without it, the default workspace."
|
|
3164
|
+
},
|
|
3165
|
+
"precisionGrid": {
|
|
3166
|
+
"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.",
|
|
3167
|
+
"exclusiveMinimum": 0,
|
|
3168
|
+
"type": "number"
|
|
3169
|
+
}
|
|
3170
|
+
},
|
|
3171
|
+
"required": [
|
|
3172
|
+
"coordinateFormat",
|
|
3173
|
+
"precisionGrid"
|
|
3174
|
+
],
|
|
3175
|
+
"type": "object"
|
|
2314
3176
|
}
|
|
2315
3177
|
}
|
|
2316
3178
|
}
|