AI-generated Key Takeaways
-
This operation reprojects images using a reducer to combine input pixels for each output pixel, applying it per band or across bands based on reducer input.
-
Output band names are determined by the reducer's output names, sometimes preserving, prefixing, or directly using them.
-
Input pixel weights are calculated using input mask and fractional output pixel coverage.
-
The
reduceResolutionmethod takes an image, reducer, and optional parameters for handling large operations, returning a reprojected image. -
Optional parameters
bestEffortandmaxPixelscontrol memory usage and allow for processing large images by adjusting input resolution and pixel combination limits.
The reducer output names determine the names of the output bands: reducers with multiple inputs will use the output names directly, reducers with a single input and single output will preserve the input band names, and reducers with a single input and multiple outputs will prefix the output name with the input band name (e.g., '10_mean', '10_stdDev', '20_mean', '20_stdDev').
Reducer input weights will be the product of the input mask and the fraction of the output pixel covered by the input pixel.
| Usage | Returns |
|---|---|
Image.reduceResolution(reducer, bestEffort, maxPixels) | Image |
| Argument | Type | Details |
|---|---|---|
this: image | Image | The input image. |
reducer | Reducer | The reducer to apply to be used for combining pixels. |
bestEffort | Boolean, default: false | If using the input at its default resolution would require too many pixels, start with already-reduced input pixels from a pyramid level that allows the operation to succeed. |
maxPixels | Integer, default: 64 | The maximum number of input pixels to combine for each output pixel. Setting this too large will cause out-of-memory problems. |