ui.Chart.image.regions
Generates a Chart from an image. Extracts and plots the value of each band in one or more regions.
- X-axis = Band labeled by xProperty (default: band name).
- Y-axis = Reducer output.
- Series = Region labeled by seriesProperty (default: 'system:index').
Returns a chart.
| Usage | Returns | ui.Chart.image.regions(image, regions, reducer, scale, seriesProperty, xLabels) | ui.Chart |
| Argument | Type | Details | image | Image | Image to extract band values from. |
regions | Feature|FeatureCollection|Geometry|List, optional | Regions to reduce. Defaults to the image's footprint. |
reducer | Reducer, optional | Reducer that generates the value(s) for the y-axis. Must return a single value per band. |
scale | Number, optional | The pixel scale in meters. |
seriesProperty | String, optional | Property to be used as the label for each region in the legend. Defaults to 'system:index'. |
xLabels | List, optional | A list of labels used for bands on the x-axis. Must have the same number of elements as the image bands. If omitted, bands will be labeled with their names. If the labels are numeric (e.g. wavelengths), x-axis will be continuous. |
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 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["Generates a chart visualizing the values of image bands within specified regions, plotted against band labels or custom x-axis labels."],["Users can define regions for analysis, the reducer for calculating band values, pixel scale, legend labels, and custom x-axis labels for the chart."],["The chart's y-axis represents the reducer output, while the x-axis represents either band names or user-defined labels, and separate series are plotted for each region."],["The function accepts an image, regions, a reducer, scale, series property for legend labels, and custom x-axis labels as input parameters."],["It outputs a chart object displaying the extracted and plotted band values."]]],[]]