إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Reducer.percentile
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
أنشئ دالة اختزال تحسب النسب المئوية المحدّدة، مثلاً، إذا تم إدخال [0, 50, 100]، سيتم إنشاء نواتج باسم "p0" و"p50" و"p100" مع الحد الأدنى والمتوسط والحد الأقصى على التوالي. بالنسبة إلى عدد صغير من الإدخالات (حتى maxRaw)، سيتم احتساب النسب المئوية مباشرةً، أما بالنسبة إلى عدد أكبر من الإدخالات، فسيتم استخراج النسب المئوية من مدرّج تكراري.
| الاستخدام | المرتجعات |
|---|
ee.Reducer.percentile(percentiles, outputNames, maxBuckets, minBucketWidth, maxRaw) | Reducer |
| الوسيطة | النوع | التفاصيل |
|---|
percentiles | قائمة | قائمة بالأرقام بين 0 و100 |
outputNames | قائمة، القيمة التلقائية: فارغة | قائمة بأسماء المخرجات، أو قيمة فارغة للحصول على الأسماء التلقائية |
maxBuckets | عدد صحيح، القيمة التلقائية: null | الحد الأقصى لعدد المجموعات التي سيتم استخدامها عند إنشاء مدرّج تكراري، وسيتم تقريبه إلى أقرب عدد صحيح من مضاعفات العدد 2. |
minBucketWidth | العدد العائم، القيمة التلقائية: null | الحد الأدنى لعرض مجموعة بيانات الرسم البياني المدرّج التكراري، أو قيمة فارغة للسماح بأي قوة من قوى العدد 2 |
maxRaw | عدد صحيح، القيمة التلقائية: null | عدد القيم التي يجب تجميعها قبل إنشاء المدرّج التكراري الأوّلي. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
