array_interpolate_linear.json

{
    "id": "array_interpolate_linear",
    "summary": "One-dimensional linear interpolation for arrays",
    "description": "Performs a linear interpolation for each of the no-data values (`null`) in the array given, except for leading and trailing no-data values.\n\nThe linear interpolants are defined by the array indices or labels (x) and the values in the array (y).",
    "categories": [
        "arrays",
        "math",
        "math > interpolation"
    ],
    "parameters": [
        {
            "name": "data",
            "description": "An array of numbers and no-data values.\n\nIf the given array is a labeled array, the labels must have a natural/inherent label order and the process expects the labels to be sorted accordingly. This is the default behavior in openEO for spatial and temporal dimensions.",
            "schema": {
                "type": "array",
                "items": {
                    "type": [
                        "number",
                        "null"
                    ]
                }
            }
        }
    ],
    "returns": {
        "description": "An array with no-data values being replaced with interpolated values. If not at least 2 numerical values are available in the array, the array stays the same.",
        "schema": {
            "type": "array",
            "items": {
                "type": [
                    "number",
                    "null"
                ]
            }
        }
    },
    "examples": [
        {
            "arguments": {
                "data": [
                    null,
                    1,
                    null,
                    6,
                    null,
                    -8
                ]
            },
            "returns": [
                null,
                1,
                3.5,
                6,
                -1,
                -8
            ]
        },
        {
            "arguments": {
                "data": [
                    null,
                    1,
                    null,
                    null
                ]
            },
            "returns": [
                null,
                1,
                null,
                null
            ]
        }
    ],
    "links": [
        {
            "rel": "about",
            "href": "https://en.wikipedia.org/wiki/Linear_interpolation",
            "title": "Linear interpolation explained by Wikipedia"
        }
    ]
}