Stay organized with collectionsSave and categorize content based on your preferences.
Interpolates each point in the first band of the input image into the piecewise-linear function specified by the x and y arrays. The x values must be strictly increasing. If an input point is less than the first or greater than the last x value, then the output is specified by the "behavior" argument: "extrapolate" specifies the output value is extrapolated from the two nearest points, "clamp" specifies the output value is taken from the nearest point, "input" specifies the output value is copied from the input, and "mask" specifies the output value is masked.
Usage
Returns
Image.interpolate(x, y,behavior)
Image
Argument
Type
Details
this:image
Image
The image to which the interpolation is applied.
x
List
The x axis (input) values in the piecewise function.
y
List
The y axis (output) values in the piecewise function.
behavior
String, default: "extrapolate"
The behavior for points that are outside of the range of the supplied function. Options are: 'extrapolate', 'clamp', 'mask', or 'input'.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-13 UTC."],[[["\u003cp\u003eThe \u003ccode\u003einterpolate\u003c/code\u003e function modifies an image by applying a piecewise-linear function to its first band, mapping input pixel values (x-axis) to output values (y-axis).\u003c/p\u003e\n"],["\u003cp\u003eUsers define the function using 'x' and 'y' lists, ensuring 'x' values are strictly increasing.\u003c/p\u003e\n"],["\u003cp\u003eFor input values outside the defined function range, the 'behavior' argument controls the output, with options including extrapolation, clamping, using original input, or masking.\u003c/p\u003e\n"],["\u003cp\u003eThe function returns a modified image with the interpolation applied.\u003c/p\u003e\n"],["\u003cp\u003eThe function can be used via \u003ccode\u003eImage.interpolate(x, y, behavior)\u003c/code\u003e, with 'x' and 'y' being lists and 'behavior' being a string with a default of 'extrapolate'.\u003c/p\u003e\n"]]],[],null,["# ee.Image.interpolate\n\nInterpolates each point in the first band of the input image into the piecewise-linear function specified by the x and y arrays. The x values must be strictly increasing. If an input point is less than the first or greater than the last x value, then the output is specified by the \"behavior\" argument: \"extrapolate\" specifies the output value is extrapolated from the two nearest points, \"clamp\" specifies the output value is taken from the nearest point, \"input\" specifies the output value is copied from the input, and \"mask\" specifies the output value is masked.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------|---------|\n| Image.interpolate`(x, y, `*behavior*`)` | Image |\n\n| Argument | Type | Details |\n|---------------|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | The image to which the interpolation is applied. |\n| `x` | List | The x axis (input) values in the piecewise function. |\n| `y` | List | The y axis (output) values in the piecewise function. |\n| `behavior` | String, default: \"extrapolate\" | The behavior for points that are outside of the range of the supplied function. Options are: 'extrapolate', 'clamp', 'mask', or 'input'. |"]]
