Property computation

gpgpuPipeline() runs a WGSL function over every feature in a GeoJSON FeatureCollection and writes the result into feature.properties.compute.

This is the part of autk-compute to use when you want to derive new metrics directly from existing feature attributes, such as compactness, weighted scores, normalized values, or custom indicators.

Minimal example

import { AutkComputeEngine } from '@urban-toolkit/autk-compute';

const compute = new AutkComputeEngine();
const result = await compute.gpgpuPipeline({
  collection: myFeatureCollection,
  variableMapping: {
    area: 'properties.area',
    floors: 'properties.floors',
  },
  resultField: 'volume',
  wgslBody: 'return area * floors;',
});

The returned collection is a copy of the input collection with computed values added under properties.compute.volume.

Neighborhood compactness

This example computes a compactness-like score from neighborhood area and perimeter, then sends the result directly to the map as thematic data.

Variable mapping

variableMapping connects WGSL variable names to feature-property paths.

variableMapping: {
  x: 'properties.longitude',
  y: 'properties.latitude',
  pop: 'properties.population',
}

If the path does not start with properties., geometry., or id, autk-compute treats it as a feature property path automatically. So 'shape_area' and 'properties.shape_area' are both valid.

All mapped scalar values are passed to WGSL as f32.

Result fields

For a single output value, use resultField:

resultField: 'score',
wgslBody: 'return x * 0.25 + y * 0.75;'

That value will be written to:

feature.properties.compute.score

For multiple output values, use outputColumns instead:

const result = await compute.gpgpuPipeline({
  collection,
  variableMapping: { x: 'x', y: 'y' },
  outputColumns: ['sum', 'product'],
  wgslBody: `
    var result: array<f32, 2>;
    result[0] = x + y;
    result[1] = x * y;
    return result;
  `,
});

Arrays, matrices, and uniforms

The pipeline also supports richer inputs when a single scalar per feature is not enough.

Input	Purpose
attributeArrays	Fixed-length per-feature arrays
attributeMatrices	Per-feature matrices
uniforms	Global scalar constants
uniformArrays	Global constant arrays
uniformMatrices	Global read-only storage matrices

uniformArrays and uniformMatrices are read-only global storage buffers in v4, not mutable function-local copies. Access arrays as name[index] with name_length; access a row-major matrix as name[row * name_cols + col] with name_rows and name_cols. Each global array or matrix consumes a storage binding, so a dispatch that exceeds the device binding limit rejects before GPU resources are created. GPU validation, memory, and internal errors now reject gpgpuPipeline() with the GPU error message instead of silently returning zeroed output.

Arrays

variableMapping: {
  score: 'score',
  weights: 'weights',
},
attributeArrays: {
  weights: 5,
},
wgslBody: `
  var total = 0.0;
  for (var i = 0u; i < weights_length; i++) {
    total += weights[i];
  }
  return score * total;
`,

Matrices

variableMapping: {
  mat: 'transform_matrix',
},
attributeMatrices: {
  mat: { rows: 'auto', cols: 3 },
},
wgslBody: `
  var trace = 0.0;
  for (var i = 0u; i < mat_rows; i++) {
    trace += mat[i * mat_cols + i];
  }
  return trace;
`,

Uniforms

uniforms: { multiplier: 2.5 },
uniformArrays: { coeffs: [0.3, 0.5, 0.2] },
wgslBody: 'return (x * coeffs[0] + y * coeffs[1]) * multiplier;',

OSM road example

This example follows the same pattern as the gallery OSM compute example. It loads roads, fixes missing or invalid lane counts, and colors the network by the computed value.

Notes

• The input collection is not mutated; a new collection is returned.
• Missing numeric values fall back to 0 in the pipeline.
• GPU dispatch overhead can outweigh the gains for very small datasets.
• AutkComputeEngine is the main public API. ComputeGpgpu is the lower-level class used internally and in some gallery examples.

WGSL return types

Return a single f32 when using resultField, or return array<f32, N> when using outputColumns.