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.

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

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.