Skip to main content

PredictionRequests

The prediction_requests key of the config.

Controls the prediction requests for the model.

FieldTypeRequiredDefaultDescription
partitionersPartitionersyesControls the partitioning of the input data into smaller units.
postprocessorsPostprocessorsnonullControls the postprocessing of the prediction results and their assembly into final outputs.

Partitioners​

FieldTypeRequiredDefaultDescription
request_to_partitionsPartitioneryesControls the partitioning of the initial request into smaller units for machine-level parallelism.
partition_to_windowsPartitioneryesControls the subdivision of a request partition into smaller units for process-level parallelism.

Postprocessors​

Post-processing configuration.

FieldTypeRequiredDefaultDescription
additional_stepsarray of AdditionalPostprocessornonull

Partitioner​

One of the following, selected by its name field:

nameType
fixed_windowFixedWindowPartitioner
gridGridPartitioner
manualEscapeHatchComponent
noopNoopPartitioner

AdditionalPostprocessor​

One of the following, selected by its name field:

nameType
value_transformValueTransformPostprocessor
vectorizeVectorizePostprocessor

NoopPartitioner​

Partitioner that does nothing.

FieldTypeRequiredDefaultDescription
name"noop"yes

GridPartitioner​

Partitioner that uses a grid to partition the input data.

FieldTypeRequiredDefaultDescription
name"grid"yes
grid_sizenumber (> 0)yesThe size of the grid cells in units of the output projection.
overlap_sizenumber (≥ 0)no0The size of the overlap between adjacent grid cells in units of the output projection.
projectionProjectionnonullProjection strategy to use for output geometries. If not provided, no re-projection will take place.

FixedWindowPartitioner​

Partitioner that creates fixed-size square windows.

Window size is determined by the window_sizing strategy. Defaults to MatchInputSize, which uses input_preprocessing.default.input_size.

FieldTypeRequiredDefaultDescription
name"fixed_window"yes
window_sizingPartitionWindowSizingno{"name": "match_input_size"}Strategy for determining the window size.

VectorizePostprocessor​

Polygonize a raster prediction into GeoJSON vector features.

FieldTypeRequiredDefaultDescription
name"vectorize"yes
skip_label_idsarray of integernonullLabel IDs to exclude from vector output.
sieve_sizeinteger (≥ 0)no5Minimum connected-pixel group size; smaller groups are removed before polygonizing. Higher values drop more small features, reducing noise but also dropping small real detections.
simplify_tolerance_pxnumber (≥ 0.0)no1.0Douglas-Peucker tolerance in pixels of the output resolution, applied in the native CRS before reprojection. 0 disables; sub-pixel values do approximately nothing (vertices sit on the pixel grid).
coordinate_precisioninteger (≥ 0)no5Decimal places to round output coordinates (5 ≈ 1 m precision).
max_featuresinteger (> 0)nonullHard cap on output feature count; keeps N largest by area when hit.
fieldstringnonullName of the output field to polygonize as class IDs. Its band and legend come from its declaration in data.output.fields. Defaults to the only field when there is one.
auxiliary_fieldsmap of string to ModeAggregation or MinAggregation or MaxAggregation or PercentileAggregationnonullOther output fields to sample onto each polygon, keyed by field name. The field name becomes the property name on the output feature. Segmentation fields are written as their labels and date fields as ISO dates (YYYY-MM-DD).

ValueTransformPostprocessor​

Transform pixel values of raster prediction outputs.

The transform is applied exactly once: either to each window's raster before combining (window, the default) or to the final combined raster (request). Window level casts to smaller dtypes early, so combining moves less data.

Embedding quantization is not configured here -- the runner power-quantizes embeddings to int8 automatically.

FieldTypeRequiredDefaultDescription
name"value_transform"yes
level"window" or "request"no"window"
transformLinearValueTransformConfigyesThe value transform to apply.

Projection​

One of the following, selected by its method field:

methodType
crsCRSProjection
use_utmUseUTMProjection

PartitionWindowSizing​

One of the following, selected by its name field:

nameType
fixed_sizeFixedSize
match_input_sizeMatchInputSize

ModeAggregation​

The most common value under the polygon, for categorical fields.

FieldTypeRequiredDefaultDescription
aggregation"mode"no"mode"

MinAggregation​

The smallest value under the polygon, such as the earliest date. One outlier pixel sets it.

FieldTypeRequiredDefaultDescription
aggregation"min"yes

MaxAggregation​

The largest value under the polygon, such as the latest date. One outlier pixel sets it.

FieldTypeRequiredDefaultDescription
aggregation"max"yes

PercentileAggregation​

A percentile of the values under the polygon, by nearest rank, so it is always a value the band holds.

For ordered fields such as dates: a low percentile is the robust form of min (10 tracks a change's onset while ignoring outlier pixels), a high one the robust form of max.

FieldTypeRequiredDefaultDescription
aggregation"percentile"yes
percentilenumber (≥ 0, ≤ 100)yes

LinearValueTransformConfig​

Linear transform: output = scale * input + offset.

FieldTypeRequiredDefaultDescription
type"linear"no"linear"
scalenumberno1.0
offsetnumberno0.0
output_dtype"uint8" or "int16" or "int32" or "float32"nonullThe output dtype to transform to. If not specified, the output dtype will be the same as the input dtype.

UseUTMProjection​

FieldTypeRequiredDefaultDescription
method"use_utm"yes

CRSProjection​

FieldTypeRequiredDefaultDescription
method"crs"yes
crsstringyesThe CRS code of the output projection.
x_resolutionnumber (> 0)yesThe x resolution of the output projection, in projection units.
y_resolutionnumber (< 0)yesThe y resolution of the output projection, in projection units.