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:
dis 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:
featureshas one row per feature with its geometry; polygons, lines and points have one row per vertex, ready for a layer;allhas every vertex row with akindcolumn. - 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
clusternumber by k-means (turf.clustersKmeans) or by density (turf.clustersDbscan, withdbscannoise/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):
insideandoutside. - 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).