Gráficos de listas y arrays

La función ui.Chart.array.values proporciona un método para renderizar gráficos a partir de objetos ee.Array y ee.List.

En los siguientes ejemplos, se usan datos de arrays y listas generados por la reducción de las bandas de imagen y los metadatos de imagen con el reductor ee.Reducer.toList(). Ten en cuenta que ui.Chart.array.values puede graficar cualquier conjunto de listas o arrays que tengan la misma longitud a lo largo de un eje determinado.

Diagrama de dispersión de la región ee.Array

La reducción de la región de la imagen por ee.Reducer.toList() produce un diccionario de listas de valores de píxeles, uno para cada banda en una imagen determinada. Aquí, se usa para extraer listas de valores de reflectancia roja, NIR y SWIR de una imagen MODIS para píxeles que se cruzan con una ecorregión boscosa. Los valores de reflectancia roja se trazan en el eje X, y los valores de NIR y SWIR se trazan en el eje Y.

El recurso projects/google/charts_feature_example, que se usa en este ejemplo para delinear una ecorregión boscosa, se desarrolló con fines de demostración. Es un conjunto de tres polígonos de ecoregión con propiedades que describen las normales climáticas.

Editor de código (JavaScript)

// Import the example feature collection and subset the forest feature.
var forest = ee.FeatureCollection('projects/google/charts_feature_example')
                 .filter(ee.Filter.eq('label', 'Forest'));

// 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_b0[0-7]')
                  .mean();

// Reduce MODIS reflectance bands by forest region; get a dictionary with
// band names as keys, pixel values as lists.
var pixelVals = modisSr.reduceRegion(
    {reducer: ee.Reducer.toList(), geometry: forest.geometry(), scale: 2000});

// Convert NIR and SWIR value lists to an array to be plotted along the y-axis.
var yValues = pixelVals.toArray(['sur_refl_b02', 'sur_refl_b06']);

// Get the red band value list; to be plotted along the x-axis.
var xValues = ee.List(pixelVals.get('sur_refl_b01'));

// Define the chart and print it to the console.
var chart = ui.Chart.array.values({array: yValues, axis: 1, xLabels: xValues})
                .setSeriesNames(['NIR', 'SWIR'])
                .setOptions({
                  title: 'Relationship Among Spectral Bands for Forest Pixels',
                  colors: ['1d6b99', 'cf513e'],
                  pointSize: 4,
                  dataOpacity: 0.4,
                  hAxis: {
                    'title': 'Red reflectance (x1e4)',
                    titleTextStyle: {italic: false, bold: true}
                  },
                  vAxis: {
                    'title': 'Reflectance (x1e4)',
                    titleTextStyle: {italic: false, bold: true}
                  }
                });
print(chart);

Diagrama de dispersión de la región ee.List

Se pueden trazar dos objetos de lista con la función ui.Chart.array.values. En función del ejemplo anterior, las listas de valores de los ejes x e y que representan la reflectancia roja y SWIR se renderizan como un gráfico de dispersión.

Editor de código (JavaScript)

// Get Red and SWIR value lists; to be plotted along x and y axes, respectively.
// Note that the pixelVals object is defined in the previous code block.
var x = ee.List(pixelVals.get('sur_refl_b01'));
var y = ee.List(pixelVals.get('sur_refl_b06'));

// Define the chart and print it to the console.
var chart = ui.Chart.array.values({array: y, axis: 0, xLabels: x}).setOptions({
  title: 'Relationship Among Spectral Bands for Forest Pixels',
  colors: ['cf513e'],
  hAxis: {
    title: 'Red reflectance (x1e4)',
    titleTextStyle: {italic: false, bold: true}
  },
  vAxis: {
    title: 'SWIR reflectance (x1e4)',
    titleTextStyle: {italic: false, bold: true}
  },
  pointSize: 4,
  dataOpacity: 0.4,
  legend: {position: 'none'},
});
print(chart);

Gráfico de líneas de transecto de ee.List

La reducción de la región de la imagen por ee.Reducer.toList() produce un diccionario de listas de valores de píxeles, una para cada banda de imagen. Si la región es una línea, como en este caso, se puede generar un transecto geográfico cuando se incluyen bandas de latitud y longitud como bandas en la imagen de interés. Aquí, las listas de valores de píxeles de longitud y elevación a lo largo de la línea de transecto se extraen como variables separadas y se grafican en los ejes x e y, respectivamente.

Editor de código (JavaScript)

// Define a line across the Olympic Peninsula, USA.
var transect = ee.Geometry.LineString([[-122.8, 47.8], [-124.5, 47.8]]);

// Define a pixel coordinate image.
var latLonImg = ee.Image.pixelLonLat();

// Import a digital surface model and add latitude and longitude bands.
var elevImg =
    ee.Image('NASA/NASADEM_HGT/001').select('elevation').addBands(latLonImg);

// Reduce elevation and coordinate bands by transect line; get a dictionary with
// band names as keys, pixel values as lists.
var elevTransect = elevImg.reduceRegion({
  reducer: ee.Reducer.toList(),
  geometry: transect,
  scale: 1000,
});

// Get longitude and elevation value lists from the reduction dictionary.
var lon = ee.List(elevTransect.get('longitude'));
var elev = ee.List(elevTransect.get('elevation'));

// Sort the longitude and elevation values by ascending longitude.
var lonSort = lon.sort(lon);
var elevSort = elev.sort(lon);

// Define the chart and print it to the console.
var chart = ui.Chart.array.values({array: elevSort, axis: 0, xLabels: lonSort})
                .setOptions({
                  title: 'Elevation Profile Across Longitude',
                  hAxis: {
                    title: 'Longitude',
                    viewWindow: {min: -124.50, max: -122.8},
                    titleTextStyle: {italic: false, bold: true}
                  },
                  vAxis: {
                    title: 'Elevation (m)',
                    titleTextStyle: {italic: false, bold: true}
                  },
                  colors: ['1d6b99'],
                  lineSize: 5,
                  pointSize: 0,
                  legend: {position: 'none'}
                });
print(chart);

Aplica .setChartType('AreaChart') para agregar sombreado debajo de la línea:

print(chart.setChartType('AreaChart'));

Diagrama de dispersión de metadatos de ee.List

La reducción de propiedades de la colección por ee.Reducer.toList() produce un diccionario de listas de valores de propiedades, una para cada propiedad seleccionada. Aquí, las listas de propiedades de cobertura de nubes y RMSE geométricas se generan a partir de un conjunto de imágenes de Landsat 8 como variables independientes. La variable de cobertura de nubes se traza a lo largo del eje X y el RMSE geométrico a lo largo del eje Y.

Editor de código (JavaScript)

// Import a Landsat 8 collection and filter to a single path/row.
var col = ee.ImageCollection('LANDSAT/LC08/C02/T1_L2')
              .filter(ee.Filter.expression('WRS_PATH ==  45 && WRS_ROW == 30'));

// Reduce image properties to a series of lists; one for each selected property.
var propVals = col.reduceColumns({
                    reducer: ee.Reducer.toList().repeat(2),
                    selectors: ['CLOUD_COVER', 'GEOMETRIC_RMSE_MODEL']
                  })
                   .get('list');

// Get selected image property value lists; to be plotted along x and y axes.
var x = ee.List(ee.List(propVals).get(0));
var y = ee.List(ee.List(propVals).get(1));

// Define the chart and print it to the console.
var chart = ui.Chart.array.values({array: y, axis: 0, xLabels: x})
                .setChartType('ScatterChart')
                .setOptions({
                  title: 'Landsat 8 Image Collection Metadata (045030)',
                  colors: ['96356f'],
                  hAxis: {
                    title: 'Cloud cover (%)',
                    titleTextStyle: {italic: false, bold: true}
                  },
                  vAxis: {
                    title: 'Geometric RMSE (m)',
                    titleTextStyle: {italic: false, bold: true}
                  },
                  pointSize: 5,
                  dataOpacity: 0.6,
                  legend: {position: 'none'},
                });
print(chart);

Gráfico de dispersión y de líneas de la función asignada a ee.List

Asigna una función a una lista de valores de x para calcular una lista correspondiente de valores de y. Aquí, la función sin() se asigna a una lista de valores del eje X para producir una lista correspondiente de valores del eje Y. Se muestra una muestra de la onda sinusoidal cuando se trazan las listas x e y.

Editor de código (JavaScript)

// Define a sequence from -2pi to +2pi in 50 increments.
var start = -2 * Math.PI;
var end = 2 * Math.PI;
var points = ee.List.sequence(start, end, null, 50);

// Evaluate the sin() function for each value in the points sequence.
var values = points.map(function(val) {
  return ee.Number(val).sin();
});

// Define the chart and print it to the console.
var chart = ui.Chart.array.values({array: values, axis: 0, xLabels: points})
                .setOptions({
                  title: 'Sine Function',
                  hAxis: {
                    title: 'radians',
                    viewWindowMode: 'maximized',
                    ticks: [
                      {v: start, f: '-2π'},
                      {v: -Math.PI, f: '-π'},
                      {v: 0, f: '0'},
                      {v: Math.PI, f: 'π'},
                      {v: end, f: '2π'}
                    ],
                    titleTextStyle: {italic: false, bold: true}
                  },
                  vAxis: {
                    title: 'sin(x)',
                    titleTextStyle: {italic: false, bold: true}
                  },
                  colors: ['39a8a7'],
                  lineWidth: 3,
                  pointSize: 7,
                  viewWindow: {min: start, max: end},
                  legend: {position: 'none'}
                });
print(chart);