ui.Chart.image.histogram

تنشئ هذه الدالة رسمًا بيانيًا من صورة. تحسب هذه الدالة المدرّجات التكرارية لقيم النطاقات في المنطقة المحدّدة من الصورة وترسمها.

  - المحور الأفقي: فئات المدرّج التكراري (لقيمة النطاق).

  - المحور الصادي: التردد (عدد وحدات البكسل التي تتضمّن قيمة نطاق في الحزمة)

تعرض هذه الدالة رسمًا بيانيًا.

الاستخدامالمرتجعات
ui.Chart.image.histogram(image, region, scale, maxBuckets, minBucketWidth, maxRaw, maxPixels)ui.Chart
الوسيطةالنوعالتفاصيل
imageصورةالصورة التي سيتم إنشاء مدرج تكراري منها.
regionFeature|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);