AI-generated Key Takeaways
-
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.
- 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<Feature>|List<Geometry>, 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<Object>, 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. |