ui.Chart.image.histogram

Génère un graphique à partir d'une image. Calcule et représente les histogrammes des valeurs des bandes dans la région spécifiée de l'image.

  - Axe X : buckets d'histogramme (de la valeur de la bande).

  - Axe Y : fréquence (nombre de pixels avec une valeur de bande dans le bucket).

Renvoie un graphique.

Utilisation	Renvoie
ui.Chart.image.histogram(image, region, scale, maxBuckets, minBucketWidth, maxRaw, maxPixels)	ui.Chart

Argument	Type	Détails
image	Image	Image à partir de laquelle générer un histogramme.
region	Feature|FeatureCollection|Geometry, facultatif	Région à réduire. Si elle est omise, l'image entière est utilisée.
scale	Nombre, facultatif	Échelle de pixels utilisée lors de l'application du réducteur d'histogramme, en mètres.
maxBuckets	Nombre, facultatif	Nombre maximal de buckets à utiliser lors de la création d'un histogramme. Il sera arrondi à la puissance de 2 supérieure.
minBucketWidth	Nombre, facultatif	Largeur minimale du bucket d'histogramme, ou null pour autoriser n'importe quelle puissance de 2.
maxRaw	Nombre, facultatif	Nombre de valeurs à accumuler avant de créer l'histogramme initial.
maxPixels	Nombre, facultatif	Si cette valeur est spécifiée, elle remplace le nombre maximal de pixels autorisés dans la réduction de l'histogramme. La valeur par défaut est 1e6.

Exemples

Éditeur de code (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);