Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Image.reduceResolution
Stay organized with collections
Save and categorize content based on your preferences.
Enables reprojection using the given reducer to combine all input pixels corresponding to each output pixel. If the reducer has a single input, it will be applied separately to each band of the collection; otherwise it must have the same number of inputs as the input image has bands.
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. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-13 UTC.
[null,null,["Last updated 2024-07-13 UTC."],[[["\u003cp\u003eThis 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.\u003c/p\u003e\n"],["\u003cp\u003eOutput band names are determined by the reducer's output names, sometimes preserving, prefixing, or directly using them.\u003c/p\u003e\n"],["\u003cp\u003eInput pixel weights are calculated using input mask and fractional output pixel coverage.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ereduceResolution\u003c/code\u003e method takes an image, reducer, and optional parameters for handling large operations, returning a reprojected image.\u003c/p\u003e\n"],["\u003cp\u003eOptional parameters \u003ccode\u003ebestEffort\u003c/code\u003e and \u003ccode\u003emaxPixels\u003c/code\u003e control memory usage and allow for processing large images by adjusting input resolution and pixel combination limits.\u003c/p\u003e\n"]]],[],null,["# ee.Image.reduceResolution\n\nEnables reprojection using the given reducer to combine all input pixels corresponding to each output pixel. If the reducer has a single input, it will be applied separately to each band of the collection; otherwise it must have the same number of inputs as the input image has bands.\n\n\u003cbr /\u003e\n\nThe 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').\n\nReducer input weights will be the product of the input mask and the fraction of the output pixel covered by the input pixel.\n\n| Usage | Returns |\n|-------------------------------------------------------------------|---------|\n| Image.reduceResolution`(reducer, `*bestEffort* `, `*maxPixels*`)` | Image |\n\n| Argument | Type | Details |\n|---------------|-------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | The input image. |\n| `reducer` | Reducer | The reducer to apply to be used for combining pixels. |\n| `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. |\n| `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. |"]]