公告:凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案,都必須
驗證非商業用途資格,才能繼續存取 Earth Engine。
ui.Chart.image.histogram
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
從圖片生成圖表。計算並繪製圖像指定區域中各波段值的直方圖。
- X 軸:直方圖值區 (頻帶值)。
- Y 軸:頻率 (值區中具有頻帶值的像素數)。
傳回圖表。
用量 | 傳回 |
---|
ui.Chart.image.histogram(image, region, scale, maxBuckets, minBucketWidth, maxRaw, maxPixels) | ui.Chart |
引數 | 類型 | 詳細資料 |
---|
image | 圖片 | 要從中生成直方圖的圖片。 |
region | Feature|FeatureCollection|Geometry,選填 | 要縮減的區域。如果省略此欄位,系統會使用整張圖片。 |
scale | 號碼 (選填) | 套用直方圖縮減器時使用的像素比例 (以公尺為單位)。 |
maxBuckets | 號碼 (選填) | 建構直方圖時使用的最大值範圍數量,會向上取整為 2 的乘方。 |
minBucketWidth | 號碼 (選填) | 直方圖儲存區寬度下限,或為空值,允許任何 2 的乘冪。 |
maxRaw | 號碼 (選填) | 建構初始直方圖前要累積的值數量。 |
maxPixels | 號碼 (選填) | 如要指定,請覆寫直方圖縮減作業允許的像素數上限。預設值為 1e6。 |
範例
程式碼編輯器 (JavaScript)
// Define a MODIS surface reflectance composite.
var modisSr = ee.ImageCollection('MODIS/006/MOD09A1')
.filter(ee.Filter.date('2018-06-01', '2018-09-01'))
.select(['sur_refl_b01', 'sur_refl_b02', 'sur_refl_b06'])
.mean();
// Define a region to calculate histogram for.
var histRegion = ee.Geometry.Rectangle([-112.60, 40.60, -111.18, 41.22]);
// Define the chart and print it to the console.
var chart =
ui.Chart.image.histogram({image: modisSr, region: histRegion, scale: 500})
.setSeriesNames(['Red', 'NIR', 'SWIR'])
.setOptions({
title: 'MODIS SR Reflectance Histogram',
hAxis: {
title: 'Reflectance (scaled by 1e4)',
titleTextStyle: {italic: false, bold: true},
},
vAxis:
{title: 'Count', titleTextStyle: {italic: false, bold: true}},
colors: ['cf513e', '1d6b99', 'f0af07']
});
print(chart);
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eGenerates a chart displaying the frequency distribution of pixel values within a specified image region.\u003c/p\u003e\n"],["\u003cp\u003eThe chart plots histograms for each band of the image, showing the number of pixels with values falling within specific ranges (buckets).\u003c/p\u003e\n"],["\u003cp\u003eUsers can customize the chart by defining the region, scale, and bucket parameters, as well as the maximum number of input values and pixels used in the calculation.\u003c/p\u003e\n"],["\u003cp\u003eThe chart is rendered with customizable axes, titles, and color options for each band.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eui.Chart.image.histogram()\u003c/code\u003e returns a \u003ccode\u003eui.Chart\u003c/code\u003e object, allowing for further manipulation and display within the Earth Engine Code Editor.\u003c/p\u003e\n"]]],["This code generates a histogram chart from an image, plotting band values against their frequency. It utilizes `ui.Chart.image.histogram` with arguments like `image`, `region`, and `scale` to define the data and spatial parameters. Optional settings include `maxBuckets`, `minBucketWidth`, `maxRaw`, and `maxPixels`. The x-axis represents histogram buckets (band value), while the y-axis shows frequency (pixel count). The example demonstrates its application with MODIS surface reflectance data, defining a region and customizing chart appearance.\n"],null,["# ui.Chart.image.histogram\n\n\u003cbr /\u003e\n\nGenerates a Chart from an image. Computes and plots histograms of the values of the bands in the specified region of the image.\n\n\u003cbr /\u003e\n\n- X-axis: Histogram buckets (of band value).\n\n- Y-axis: Frequency (number of pixels with a band value in the bucket).\n\nReturns a chart.\n\n| Usage | Returns |\n|------------------------------------------------------------------------------------------------------------------------------|----------|\n| `ui.Chart.image.histogram(image, `*region* `, `*scale* `, `*maxBuckets* `, `*minBucketWidth* `, `*maxRaw* `, `*maxPixels*`)` | ui.Chart |\n\n| Argument | Type | Details |\n|------------------|------------------------------------------------|-----------------------------------------------------------------------------------------------------------|\n| `image` | Image | The image to generate a histogram from. |\n| `region` | Feature\\|FeatureCollection\\|Geometry, optional | The region to reduce. If omitted, uses the entire image. |\n| `scale` | Number, optional | The pixel scale used when applying the histogram reducer, in meters. |\n| `maxBuckets` | Number, optional | The maximum number of buckets to use when building a histogram; will be rounded up to a power of 2. |\n| `minBucketWidth` | Number, optional | The minimum histogram bucket width, or null to allow any power of 2. |\n| `maxRaw` | Number, optional | The number of values to accumulate before building the initial histogram. |\n| `maxPixels` | Number, optional | If specified, overrides the maximum number of pixels allowed in the histogram reduction. Defaults to 1e6. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Define a MODIS surface reflectance composite.\nvar modisSr = ee.ImageCollection('MODIS/006/MOD09A1')\n .filter(ee.Filter.date('2018-06-01', '2018-09-01'))\n .select(['sur_refl_b01', 'sur_refl_b02', 'sur_refl_b06'])\n .mean();\n\n// Define a region to calculate histogram for.\nvar histRegion = ee.Geometry.Rectangle([-112.60, 40.60, -111.18, 41.22]);\n\n// Define the chart and print it to the console.\nvar chart =\n ui.Chart.image.histogram({image: modisSr, region: histRegion, scale: 500})\n .setSeriesNames(['Red', 'NIR', 'SWIR'])\n .setOptions({\n title: 'MODIS SR Reflectance Histogram',\n hAxis: {\n title: 'Reflectance (scaled by 1e4)',\n titleTextStyle: {italic: false, bold: true},\n },\n vAxis:\n {title: 'Count', titleTextStyle: {italic: false, bold: true}},\n colors: ['cf513e', '1d6b99', 'f0af07']\n });\nprint(chart);\n```"]]