Skip to main content

Operator Reference

136 operators in 10 categories. 7 of 136 have written Remarks.

One page per operator. The ports and parameters tables are generated from the operator catalog; Remarks and Examples are written by hand.

Data​

  • Code: Rows made by JavaScript: d is the input's rows as objects (an empty array with nothing wired), or a JSON file parsed whole when a URL is set, and the body returns an array of rows or GeoJSON.
  • File: Read a CSV, JSON or Parquet file by URL.
  • Generate: N rows numbered 0…N−1.
  • GeoJSON: A GeoJSON file, or any vector file DuckDB spatial reads (shapefile, GeoPackage…), as rows: features has one row per feature with its geometry; polygons, lines and points have one row per vertex, ready for a layer; all has every vertex row with a kind column.
  • Overpass: OpenStreetMap features an Overpass QL query finds, as a table of features: tagged nodes as points, ways as lines or polygons, multipolygon relations.
  • DuckDB SQL: Any SELECT.
  • Table: Rows you type in, kept in the document: a table the engine loads once per edit.

Tables​

  • Aggregate: GROUP BY with aggregates, one per line: name = count(), total = sum(pop).
  • Grid Bin: Count rows per square cell and emit one row per cell at its center (P), with n and the weight sum w.
  • Join: Match rows of two tables on key columns.
  • Limit: The first N rows.
  • Sort: Order rows by a column; with a limit, keep the top N.
  • Time Series: Each path's place at one time, interpolated between the two vertices around it, holding the first and last vertex outside the path's span.
  • Union: All rows of every input, columns matched by name.
  • Unnest: List columns to rows, in lockstep.

Geometry​

  • Aggregate Within: Each polygon with a count, sum, mean, min or max of the points inside it, as a new column <operation>_<column> (0 for none).
  • Along: The point a distance along each line, as turf.along; past the end is the end.
  • Area: A column with each feature’s area on the spheroid, as turf.area; 0 for points and lines.
  • Buffer: Each feature grown by a distance on the ground (shrunk, for a negative one), as turf.buffer.
  • Grid Cells: Rows with a grid cell id (H3, S2, A5, geohash or quadkey) as polygon features of their cells, keeping their columns; a column of H3 id lists draws each list’s merged outline.
  • Centroid: Each feature as a point at its center of mass, keeping its properties.
  • Choropleth Join: Rows joined onto boundaries by a key: US states, world countries or Canadian provinces.
  • Clip: Each feature cut by a mask (the union of its features): the part inside, as turf.intersect and a clip do, or the part outside, as turf.difference does.
  • Cluster: Points labeled with a cluster number by k-means (turf.clustersKmeans) or by density (turf.clustersDbscan, with dbscan noise/core/edge).
  • Convex Hull: One polygon enclosing every feature, as turf.convex.
  • Dissolve: Polygons merged: all of them, or those sharing a value of a column (turf.dissolve, turf.union).
  • Explode: Each multi-part feature as one row per part (turf.flatten), or every feature as one point row per vertex (turf.explode).
  • Features: GeoJSON written into the node (a FeatureCollection, a Feature or a bare geometry) or WKT, as a table of features.
  • Grid Features: Hexagons, squares or points of one cell size covering a bounding box, as turf.hexGrid, squareGrid and pointGrid make them.
  • Inside / Outside: Features split by whether they touch any feature of a second table (a point inside a polygon, on its edge included, as turf.booleanPointInPolygon): inside and outside.
  • Interpolate: A grid of points valued by inverse-distance weighting of a column of the input points, as turf.interpolate.
  • Isolines: Contour lines through a grid of points at each break value of a column, as turf.isolines (the input must be a point grid, such as Interpolate makes).
  • Length: A column with each feature’s length on the spheroid (a polygon’s perimeter), as turf.length.
  • Line Slice: The part of each line between two distances from its start, as turf.lineSliceAlong.
  • Line to Polygon: Each line as the polygon it outlines, closed if it is open, as turf.lineToPolygon.
  • Nearest: The feature nearest a point, with its distance in kilometers in distanceToPoint, as turf.nearestPoint.
  • Point: One point feature at a longitude and latitude, which numbers can drive.
  • Polygon to Line: Each polygon as its outline, holes included, as turf.polygonToLine.
  • Rectangle: One rectangle feature of a width and height on the ground, centered on a point.
  • Reproject: Coordinates from one CRS to another, as PROJ names them (EPSG:4326 is lng/lat).
  • Simplify: Fewer vertices: Douglas–Peucker with a tolerance in degrees, as turf.simplify.
  • Smooth Lines: Lines with their corners rounded: a moving average of each vertex and its neighbors (gaussian or boxcar), or a spline through the vertices (Catmull–Rom, cardinal, basis, natural, monotone, or a fixed turn radius).
  • Spatial Join: Each feature with the columns of a feature of the other table it intersects, lies within, or contains, as Noodles' spatial join: the first match, and a same-named column takes the match's value.
  • TIN: Triangles joining the input points (Delaunay), as turf.tin; with a column, each triangle has its corners’ values as a, b and c.
  • Transform: Each feature rotated (degrees clockwise), scaled about its centroid or bounding-box center, then moved a distance along a compass bearing, as turf.transformRotate, transformScale and transformTranslate.
  • Voronoi: One cell per point, the area nearer it than any other, clipped to the points' bounding box and carrying the point's properties, as turf.voronoi.

Rows​

  • Attribute Create: Create or overwrite one attribute from an expression.
  • Brushable Histogram: Keep rows whose column lies in a brushed range, drawn over the column's histogram in the parameter pane.
  • Distance: Great-circle distance in km between two lng/lat points (haversine).
  • Extent: The minimum and maximum of an expression over the rows that reach it, computed in SQL.
  • Filter: Keep rows matching a condition.
  • Distance to Geometry: Distance from each row's point to a line, polygon or set of points: zero inside a polygon.
  • JS Function: A JavaScript function any expression can call by name, run by DuckDB per row.
  • Map Range: Rescale a value from one range to another, linearly, on a log scale or a square root.
  • Point Position: Build the position attribute P from longitude, latitude and altitude.
  • Range Filter: Keep rows whose column lies between two values.
  • Region Filter: Keep rows inside, outside or near a polygon.
  • Attribute Wrangle: A VEX-style body: @name = expr; var t = expr; fn f(x) = expr;.

Color​

  • Color: A color other parameters reference, so several layers can share one.
  • Color Ramp: Map a value through a color ramp into an RGB attribute.

Layers​

  • Arc Layer: An arc per row between two positions.
  • Bitmap Layer: Render a raster image at specified boundaries.
  • Choropleth Layer: Rows joined onto boundaries (as Choropleth Join does) and filled by a color ramp over a column, its domain the column's minimum to maximum; a boundary with no value is gray.
  • Column Layer: An extruded column per row: bars on a map.
  • Contour Layer: Rows binned into a grid of a cell size in meters, drawn as iso-lines at thresholds or bands between them.
  • Grid Cell Layer: A square column per row, of a cell size in meters, raised by a per-row elevation.
  • Grid Layer: Rows binned into square cells, colored and raised by per-row weights deck sums per bin.
  • Heatmap Layer: A density surface of the rows' positions, weighted per row.
  • Hexagon Layer: Rows binned into hexagons, colored and raised by per-row weights deck sums per bin.
  • Icon Layer: An icon per row from an atlas image: a string column names each row’s icon in the mapping.
  • Line Layer: A straight segment per row between two positions.
  • Simple Mesh Layer: A 3D model per row, positioned, oriented (pitch, yaw, roll in degrees), scaled and colored by channels.
  • MVT Layer: Render Mapbox Vector Tiles (MVT).
  • Path Layer: A path per row when Position reads a list of positions or a geometry; otherwise rows are vertices, grouped into paths by an id column and ordered by another.
  • Point Cloud Layer: A lit point per row, sized in pixels or meters.
  • Polygon Layer: A polygon per row when Position reads a geometry (holes and multi-polygons included); otherwise rows are vertices, grouped into polygons by an id, into rings by another (the first ring is the outline, the rest are holes), ordered by a third.
  • Raster Tile Layer: Render a raster tile layer on the map.
  • Scatterplot Layer: A circle per row.
  • Scenegraph Layer: A 3D model per row, positioned, oriented (pitch, yaw, roll in degrees), scaled and colored by channels.
  • Screen Grid Layer: Rows binned into square cells of a size on screen, colored by their summed or averaged weight.
  • Terrain Layer: Render a terrain mesh from heightmap tiles.
  • Text Layer: A label per row from a string column.
  • Tile 3D Layer: Render 3D tiles on the map (Google, Cesium, or a custom tileset URL).
  • Trips Layer: Animated trails: a trip per row when Position reads a list of positions and Timestamp a list of times; otherwise vertex rows with a timestamp each.

Numbers​

  • Bezier Curve: A number from a curve: the curve’s height at a factor from 0 to 1.
  • Expression: A number from an expression over a, b, T (seconds), F (frame) and ch() references.
  • Math: Combine two numbers.
  • Mouse: The pointer over the map, in pixels from its top left.
  • Number: A constant, a slider, or a keyframed value.
  • Ramp: A number from stops: the value at a position, between stops linearly, smoothly (monotone) or held.
  • Time: Timeline seconds × speed + offset.

Output​

  • Bitmap Overlay: Display a bitmap image as a screen-space overlay.
  • Brightness / Contrast: Adjust brightness and contrast of a layer.
  • Brushing: Show only objects near the pointer.
  • Clip Extension: Clip layers by a rectangular bounds.
  • Collision Filter: Hide overlapping objects, keeping the higher priority one.
  • Compass Widget: Compass and bearing reset widget.
  • Deck: The map: layers bottom to top, the basemap, and the camera.
  • Fill Style: Fill polygons with a pattern from an atlas.
  • FirstPerson View: A deck.gl first person view.
  • Fit Bounds: The camera that fits rows into the render surface: wire its view state or its bounds into the deck or a View State.
  • FPS Widget: Display frames per second (FPS) and rendering stats widget.
  • Fullscreen Widget: Enter/exit fullscreen widget.
  • Globe View: A deck.gl globe view.
  • Hue / Saturation: Adjust hue and saturation of a layer.
  • Layer Props: Props added to a layer: operation "mask" for a mask layer, beforeId to draw under a MapLibre layer, views to draw only in some views, or any others as JSON.
  • Legend Widget: Display a color scale legend overlay on the visualization.
  • Map Style: A basemap style with your changes: layers hidden or recolored, from the style editor.
  • Map View: A deck.gl map view.
  • Mask 3D Extension: Show only a sphere around a lng/lat/alt (meters) of a Tile3DLayer, fading to white at the edge.
  • Mask Extension: Show/hide layer objects by a geofence.
  • Merge: One object from several, later ones winning, as Object.assign does: view states, layer props.
  • Orbit View: A deck.gl orbit view.
  • Orthographic View: A deck.gl orthographic view.
  • Path Style: Dashed and offset paths.
  • PMTiles: Load a PMTiles archive as a MapLibre vector or raster source.
  • Scale Widget: Display a map distance scale widget.
  • Screenshot Widget: Download current frame as PNG widget.
  • Switch Value: One of several values, chosen by Index: a camera from several View States wired into the deck, say.
  • Terrain Extension: Render a terrain layer on the map.
  • Vibrance: Adjust vibrance of a layer.
  • View State: A camera: longitude, latitude, zoom, pitch and bearing, which numbers can drive.
  • XYZ Tiles: Configure a raster XYZ tile source from a URL template ({z}/{x}/{y}).
  • Zoom Widget: Zoom in/out buttons widget.

Structure​

  • Comment: A note that explains the nodes beside it.
  • Subnetwork: A network inside a node.
  • Subnet Input: Inside a subnet: what is connected to the subnet's input.
  • Subnet Output: Inside a subnet: what the subnet outputs.
  • Switch: Pass one of several tables or layers through, chosen by index.
  • Switch Rows: Pass one of several tables through, chosen by index, which numbers and keyframes can drive.

Host operators​

  • Chart: Create charts using Observable Plot (bar, histogram, scatter).
  • Code: Run custom JavaScript code to transform your data.
  • CustomMapLibreLayer: Define a custom MapLibre GL layer with WebGL rendering.
  • Directions: Get driving, traffic-aware driving, or transit directions between points.
  • Geocoder: Get the location of a query string.
  • TileLayer: Render data organized in a tiled format (generic tile layer).