ee.Reducer.percentile
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک کاهنده ایجاد کنید که صدک های مشخص شده را محاسبه کند، به عنوان مثال [0، 50، 100] خروجی هایی به نام های 'p0'، 'p50' و 'p100' را با حداقل، میانه و حداکثر تولید می کند. برای تعداد کمی از ورودی ها (تا maxRaw) صدک ها مستقیماً محاسبه می شوند. برای تعداد بیشتری از ورودی ها، صدک ها از یک هیستوگرام به دست می آیند.
| استفاده | برمی گرداند | ee.Reducer.percentile(percentiles, outputNames , maxBuckets , minBucketWidth , maxRaw ) | کاهنده |
| استدلال | تایپ کنید | جزئیات | percentiles | فهرست کنید | لیستی از اعداد بین 0 تا 100. |
outputNames | لیست، پیش فرض: null | لیستی از نام ها برای خروجی ها یا null برای دریافت نام های پیش فرض. |
maxBuckets | عدد صحیح، پیش فرض: null | حداکثر تعداد سطل های مورد استفاده در هنگام ساخت یک هیستوگرام. به توان 2 گرد خواهد شد. |
minBucketWidth | شناور، پیش فرض: null | حداقل عرض سطل هیستوگرام یا تهی برای اجازه دادن هر توان 2. |
maxRaw | عدد صحیح، پیش فرض: null | تعداد مقادیری که باید قبل از ساخت هیستوگرام اولیه جمع شوند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشی‌های سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبت‌شده Oracle و/یا شرکت‌های وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-24 به‌وقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 به‌وقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis reducer calculates specified percentiles (e.g., minimum, median, maximum) from a set of input values.\u003c/p\u003e\n"],["\u003cp\u003eFor smaller datasets, percentiles are computed directly; for larger datasets, a histogram-based approach is used for efficiency.\u003c/p\u003e\n"],["\u003cp\u003eUsers can customize the percentiles to compute, output band names, and fine-tune the histogram construction parameters.\u003c/p\u003e\n"]]],["The `ee.Reducer.percentile` function computes specified percentiles from a dataset. It accepts a list of `percentiles` (0-100) and optional `outputNames`. For large datasets, it builds a histogram with a `maxBuckets` limit and `minBucketWidth`. For smaller datasets (up to `maxRaw`), it computes percentiles directly. The function returns a Reducer, producing outputs with names like 'p0', 'p50', etc., representing the corresponding percentiles. The user can set custom names or null for defaults.\n"],null,["# ee.Reducer.percentile\n\nCreate a reducer that will compute the specified percentiles, e.g. given \\[0, 50, 100\\] will produce outputs named 'p0', 'p50', and 'p100' with the min, median, and max respectively. For small numbers of inputs (up to maxRaw) the percentiles will be computed directly; for larger numbers of inputs the percentiles will be derived from a histogram.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------------------------------------------------------------------------------------------|---------|\n| `ee.Reducer.percentile(percentiles, `*outputNames* `, `*maxBuckets* `, `*minBucketWidth* `, `*maxRaw*`)` | Reducer |\n\n| Argument | Type | Details |\n|------------------|------------------------|-----------------------------------------------------------------------------------------------------|\n| `percentiles` | List | A list of numbers between 0 and 100. |\n| `outputNames` | List, default: null | A list of names for the outputs, or null to get default names. |\n| `maxBuckets` | Integer, default: null | The maximum number of buckets to use when building a histogram; will be rounded up to a power of 2. |\n| `minBucketWidth` | Float, default: null | The minimum histogram bucket width, or null to allow any power of 2. |\n| `maxRaw` | Integer, default: null | The number of values to accumulate before building the initial histogram. |"]]
