Combinaciones internas

Para enumerar todas las coincidencias entre los elementos de dos colecciones, usa un ee.Join.inner(). El resultado de una unión interna es un FeatureCollection (incluso si se une un ImageCollection a otro ImageCollection). Cada componente del resultado representa una coincidencia, en la que los elementos coincidentes se almacenan en dos propiedades del componente. Por ejemplo, feature.get('primary') es el elemento de la colección principal que coincide con el elemento de la colección secundaria almacenado en feature.get('secondary'). (Se pueden especificar nombres diferentes para estas propiedades como argumentos de inner(), pero ‘primary’ y ‘secondary’ son los predeterminados). Las relaciones de uno a varios se representan con varios atributos en el resultado. Si un elemento de cualquiera de las colecciones no tiene una coincidencia, no estará presente en el resultado.

Los ejemplos de unión con entradas ImageCollection se aplican sin modificaciones a las entradas FeatureCollection. También es posible unir un FeatureCollection a un ImageCollection y viceversa. Considera el siguiente ejemplo de unión interna:

Editor de código (JavaScript)

// Create the primary collection.
var primaryFeatures = ee.FeatureCollection([
  ee.Feature(null, {foo: 0, label: 'a'}),
  ee.Feature(null, {foo: 1, label: 'b'}),
  ee.Feature(null, {foo: 1, label: 'c'}),
  ee.Feature(null, {foo: 2, label: 'd'}),
]);

// Create the secondary collection.
var secondaryFeatures = ee.FeatureCollection([
  ee.Feature(null, {bar: 1, label: 'e'}),
  ee.Feature(null, {bar: 1, label: 'f'}),
  ee.Feature(null, {bar: 2, label: 'g'}),
  ee.Feature(null, {bar: 3, label: 'h'}),
]);

// Use an equals filter to specify how the collections match.
var toyFilter = ee.Filter.equals({
  leftField: 'foo',
  rightField: 'bar'
});

// Define the join.
var innerJoin = ee.Join.inner('primary', 'secondary');

// Apply the join.
var toyJoin = innerJoin.apply(primaryFeatures, secondaryFeatures, toyFilter);

// Print the result.
print('Inner join toy example:', toyJoin);

Configuración de Python

Consulta la página Entorno de Python para obtener información sobre la API de Python y el uso de geemap para el desarrollo interactivo.

import ee
import geemap.core as geemap

Colab (Python)

# Create the primary collection.
primary_features = ee.FeatureCollection([
    ee.Feature(None, {'foo': 0, 'label': 'a'}),
    ee.Feature(None, {'foo': 1, 'label': 'b'}),
    ee.Feature(None, {'foo': 1, 'label': 'c'}),
    ee.Feature(None, {'foo': 2, 'label': 'd'}),
])

# Create the secondary collection.
secondary_features = ee.FeatureCollection([
    ee.Feature(None, {'bar': 1, 'label': 'e'}),
    ee.Feature(None, {'bar': 1, 'label': 'f'}),
    ee.Feature(None, {'bar': 2, 'label': 'g'}),
    ee.Feature(None, {'bar': 3, 'label': 'h'}),
])

# Use an equals filter to specify how the collections match.
toy_filter = ee.Filter.equals(leftField='foo', rightField='bar')

# Define the join.
inner_join = ee.Join.inner('primary', 'secondary')

# Apply the join.
toy_join = inner_join.apply(primary_features, secondary_features, toy_filter)

# Print the result.
display('Inner join toy example:', toy_join)

En el ejemplo anterior, observa que la relación entre las tablas se define en el filtro, lo que indica que los campos ‘foo’ y ‘bar’ son los campos de unión. Luego, se especifica una unión interna y se aplica a las colecciones. Inspecciona el resultado y observa que cada coincidencia posible se representa como una Feature.

Para ver un ejemplo motivado, considera unir objetos ImageCollection de MODIS. Los datos de calidad de MODIS a veces se almacenan en una colección separada de los datos de imagen, por lo que una combinación interna es conveniente para unir las dos colecciones y aplicar los datos de calidad. En este caso, los tiempos de adquisición de imágenes son idénticos, por lo que un filtro de igualdad se encarga de especificar esta relación entre las dos colecciones:

Editor de código (JavaScript)

// Make a date filter to get images in this date range.
var dateFilter = ee.Filter.date('2014-01-01', '2014-02-01');

// Load a MODIS collection with EVI data.
var mcd43a4 = ee.ImageCollection('MODIS/MCD43A4_006_EVI')
    .filter(dateFilter);

// Load a MODIS collection with quality data.
var mcd43a2 = ee.ImageCollection('MODIS/006/MCD43A2')
    .filter(dateFilter);

// Define an inner join.
var innerJoin = ee.Join.inner();

// Specify an equals filter for image timestamps.
var filterTimeEq = ee.Filter.equals({
  leftField: 'system:time_start',
  rightField: 'system:time_start'
});

// Apply the join.
var innerJoinedMODIS = innerJoin.apply(mcd43a4, mcd43a2, filterTimeEq);

// Display the join result: a FeatureCollection.
print('Inner join output:', innerJoinedMODIS);

Configuración de Python

Consulta la página Entorno de Python para obtener información sobre la API de Python y el uso de geemap para el desarrollo interactivo.

import ee
import geemap.core as geemap

Colab (Python)

# Make a date filter to get images in this date range.
date_filter = ee.Filter.date('2014-01-01', '2014-02-01')

# Load a MODIS collection with EVI data.
mcd43a4 = ee.ImageCollection('MODIS/MCD43A4_006_EVI').filter(date_filter)

# Load a MODIS collection with quality data.
mcd43a2 = ee.ImageCollection('MODIS/006/MCD43A2').filter(date_filter)

# Define an inner join.
inner_join = ee.Join.inner()

# Specify an equals filter for image timestamps.
filter_time_eq = ee.Filter.equals(
    leftField='system:time_start', rightField='system:time_start'
)

# Apply the join.
inner_joined_modis = inner_join.apply(mcd43a4, mcd43a2, filter_time_eq)

# Display the join result: a FeatureCollection.
display('Inner join output:', inner_joined_modis)

Para usar las imágenes unidas en el resultado FeatureCollection, map() una función de combinación sobre el resultado. Por ejemplo, las imágenes que coinciden se pueden apilar de modo que las bandas de calidad se agreguen a los datos de imagen:

Editor de código (JavaScript)

// Map a function to merge the results in the output FeatureCollection.
var joinedMODIS = innerJoinedMODIS.map(function(feature) {
  return ee.Image.cat(feature.get('primary'), feature.get('secondary'));
});

// Print the result of merging.
print('Inner join, merged bands:', joinedMODIS);

Configuración de Python

Consulta la página Entorno de Python para obtener información sobre la API de Python y el uso de geemap para el desarrollo interactivo.

import ee
import geemap.core as geemap

Colab (Python)

# Map a function to merge the results in the output FeatureCollection.
joined_modis = inner_joined_modis.map(
    lambda feature: ee.Image.cat(
        feature.get('primary'), feature.get('secondary')
    )
)

# Print the result of merging.
display("Inner join, merged 'bands':", joined_modis)

Aunque esta función se asigna a un FeatureCollection, el resultado es un ImageCollection. Cada imagen en el ImageCollection resultante tiene todas las bandas de las imágenes de la colección principal (en este ejemplo, solo ‘EVI’) y todas las bandas de la imagen coincidente en la colección secundaria (las bandas de calidad).