ui.Chart.image.byRegion
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک نمودار از یک تصویر ایجاد می کند. مقادیر باند را در یک یا چند ناحیه در تصویر، با هر باند در یک سری جداگانه، استخراج و ترسیم می کند.
- محور X = منطقه برچسب‌گذاری شده توسط xProperty (پیش‌فرض: 'system:index')
- محور Y = خروجی کاهنده.
- سری = نام گروه.
نموداری را برمی‌گرداند.
| استفاده | برمی گرداند | ui.Chart.image.byRegion(image, regions , reducer , scale , xProperty ) | ui.Chart |
| استدلال | تایپ کنید | جزئیات | image | تصویر | تصویر برای استخراج مقادیر باند از. |
regions | ویژگی|FeatureCollection|هندسه|فهرست<ویژگی>|فهرست<هندسه>، اختیاری | مناطق برای کاهش پیش‌فرض ردپای تصویر. |
reducer | کاهنده، اختیاری | کاهنده ای که مقدار(های) محور y را تولید می کند. باید یک مقدار واحد در هر باند برگرداند. پیش‌فرض ee.Reducer.mean(). |
scale | شماره، اختیاری | مقیاس برای استفاده با کاهنده بر حسب متر. |
xProperty | رشته، اختیاری | ویژگی که باید به عنوان برچسب برای هر منطقه در محور x استفاده شود. پیش‌فرض «system:index» است. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشی‌های سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبت‌شده Oracle و/یا شرکت‌های وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-24 به‌وقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 به‌وقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eGenerates a chart that visualizes band values within specified regions of an image.\u003c/p\u003e\n"],["\u003cp\u003eCharts display band values on the y-axis, region labels on the x-axis, and separate series for each band.\u003c/p\u003e\n"],["\u003cp\u003eUsers can customize the chart by defining regions, specifying a reducer for calculations, setting a scale, and choosing a property for x-axis labels.\u003c/p\u003e\n"],["\u003cp\u003eThe default reducer is \u003ccode\u003eee.Reducer.mean()\u003c/code\u003e, and the default x-axis property is \u003ccode\u003e'system:index'\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe function returns a \u003ccode\u003eui.Chart\u003c/code\u003e object.\u003c/p\u003e\n"]]],["The core functionality involves creating a chart from an image by extracting and plotting band values from specified regions. Users define `image`, `regions`, `reducer`, `scale`, and `xProperty`. It extracts band values, uses the provided `reducer` to compute a single y-value per band, which are then plotted as separate series. `regions` are labeled on the x-axis, based on the provided `xProperty`. The chart plots the reduced values per band in different regions, returning a `ui.Chart` object.\n"],null,["# ui.Chart.image.byRegion\n\n\u003cbr /\u003e\n\nGenerates a Chart from an image. Extracts and plots band values in one or more regions in the image, with each band in a separate series.\n\n\u003cbr /\u003e\n\n- X-axis = Region labeled by xProperty (default: 'system:index')\n\n- Y-axis = Reducer output.\n\n- Series = Band name.\n\nReturns a chart.\n\n| Usage | Returns |\n|-----------------------------------------------------------------------------------------|----------|\n| `ui.Chart.image.byRegion(image, `*regions* `, `*reducer* `, `*scale* `, `*xProperty*`)` | ui.Chart |\n\n| Argument | Type | Details |\n|-------------|-----------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|\n| `image` | Image | Image to extract band values from. |\n| `regions` | Feature\\|FeatureCollection\\|Geometry\\|List\\\u003cFeature\\\u003e\\|List\\\u003cGeometry\\\u003e, optional | Regions to reduce. Defaults to the image's footprint. |\n| `reducer` | Reducer, optional | Reducer that generates the value(s) for the y-axis. Must return a single value per band. Defaults to ee.Reducer.mean(). |\n| `scale` | Number, optional | Scale to use with the reducer in meters. |\n| `xProperty` | String, optional | Property to be used as the label for each Region on the x-axis. Defaults to 'system:index'. |"]]
