Transformation - InterpolationSpatial Closest Distance
schema: |
|
keywords: |
transformation, spatial interpolation, closest distance |
Description and usage
This transformation function finds the closest location/grid cell in the input time series and uses the value of that location/grid cell for the output.
This transformation can handle three types of input:
- scalar
- regular grid
- irregular grid
- longitudinal profile
The output can be a:
- scalar
- regular grid
- irregular grid
- longitudinal profile
If the time series is not a scalar time series the centre of the grid cell will be used when trying to find the closest input location/grid cell.
When a longitudinal profile is used the profile is considered to be a scattered grid.
The configurator has to possibility to configure a minimum and maximum value for the output. If the output exceeds the minimum or maximum value the output is truncated to that value.
It is also possible to maximize to search radius in which the transformation searches for the closest input location/grid cell. This can be done by setting the searchRadius in the configuration.
Input/Output time series
In this function one input time series and one output time series must be identified.
- inputVariable: a time series with input values. This can be a scalar time series, longitudinal profile or a time series with a regular/irregular grid.
- outputVariable: a time series in which the output will be stored. This can be a scalar time series, longitudinal profile or a time series with a regular/irregular grid.
Configuration
A basic configuration of the function is described below. This describes the main elements and attributes required and provides an example configuration.
inputVariable
Required element defining the identifier of the input time series with input values. This Id must reference a valid input time series.
outputVariable
Required element defining the identifier of the output time series with output values. This Id must reference a valid output time series.
minimumValue
Optional element defining the minimum value of the output time series. If the output value is lower than the configured minimum value the output value will be equal to the configured minimum value.
maximumValue
Optional element defining the maximum value of the input time series. If the output value is higher than the configured maximum value the output value will be equal to the configured maximum value.
searchRadius
Optional element defining the maximum radius in which the transformation searches the closest location/grid cell.
Example
<interpolationSpatial> <closestDistance> <inputVariable> <variableId>input</variableId> </inputVariable> <minimumValue>0</minimumValue> <maximumValue>1000</maximumValue> <searchRadius>10000</searchRadius> <outputVariable> <variableId>output</variableId> </outputVariable> </closestDistance> </interpolationSpatial>
Common issues
None reported.