Skip to content

Raster and Vector Data

Geo Engine processes two kinds of data: rasters and vectors. Processing graphs can also produce plots, which summarize raster or vector data as charts or statistics.

A raster is a time series of gridded data. Its result descriptor describes it with:

  • Data type. All pixels of a raster have the same raster data type: U8, U16, U32, U64, I8, I16, I32, I64, F32 or F64. RasterTypeConversion changes it.
  • Bands. A raster has one or more bands, each with a name and a measurement that says what the values mean: unitless, continuous with a unit, or a classification with named classes. See RasterBandDescriptor. RasterStacker combines rasters into one with more bands, and BandFilter selects bands.
  • Spatial grid. The grid is defined by a geo transform (origin coordinate and pixel size) and the pixel bounds of the data. The pixel size is the resolution of the raster. A grid is either source, i.e., the grid of the original data, or derived, i.e., computed by an operator, e.g., by a reprojection.
  • Time. The time bounds and whether the time steps are regular or irregular; see Time.
  • Spatial reference; see Spatial References.

Pixels can be no data, i.e., have no valid value. Operators propagate no data, e.g., an Expression returns no data if one of its inputs is no data, unless configured otherwise.

Geo Engine splits rasters into tiles of a fixed size, 512 × 512 pixels by default. Tiles are the unit in which rasters are loaded, processed, cached and streamed. The tile grid is aligned to the spatial grid of the raster, so tiles of rasters with the same grid line up with each other. See Queries and Streams for the order in which tiles arrive.

Operators that combine several rasters require compatible grids. To change the resolution of a raster, use Downsampling for a coarser and Interpolation for a finer resolution. The OGC services resample the final result to the requested resolution automatically.

Vector data are collections of features. Every feature has a geometry, a time interval and values for the columns of the collection. The result descriptor describes vector data with:

  • Data type, i.e., the geometry type: MultiPoint, MultiLineString, MultiPolygon, or Data for features without geometry. Geo Engine stores all geometries as multi-geometries, so a single point is a MultiPoint with one coordinate.
  • Columns. Each column has a feature data type (int, float, text, bool, dateTime or category) and a measurement.
  • Spatial reference, and optionally the time interval and bounding box of all features.

Features arrive in chunks; see Queries and Streams.

Several operators convert between rasters and vectors: