Proyecciones

Earth Engine está diseñado para que rara vez tengas que preocuparte por las proyecciones de mapas cuando realizas cálculos. Al igual que con la escala, la proyección en la que se realizan los cálculos se determina según un modelo de "extracción". En particular, las entradas se solicitan en la proyección de salida. El resultado se puede determinar a partir de un parámetro de función (p.ej., crs), objetos de mapa del Editor de código y geemap (que tienen una proyección de Mercator de mapas (EPSG:3857)) o con una llamada a reproject(). Cuando muestras imágenes en el editor de código o en geemap, las entradas se solicitan en Mercator de Maps. Considera la siguiente operación en una imagen de MODIS, que tiene una proyección sinusoidal:

Editor de código (JavaScript)

// The input image has a SR-ORG:6974 (sinusoidal) projection.
var image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0);

// Normalize the image and add it to the map.
var rescaled = image.unitScale(-2000, 10000);
var visParams = {min: 0.15, max: 0.7};
Map.addLayer(rescaled, visParams, 'Rescaled');

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)

# The input image has a SR-ORG:6974 (sinusoidal) projection.
image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0)

# Normalize the image and add it to the map.
rescaled = image.unitScale(-2000, 10000)
vis_params = {'min': 0.15, 'max': 0.7}
m = geemap.Map()
m.add_layer(rescaled, vis_params, 'Rescaled')
m

El orden de las operaciones para esta muestra de código se representa en la Figura 1. Ten en cuenta que la proyección de la entrada se determina por la salida, específicamente la proyección maps mercator de la visualización del mapa en el Editor de código. Esta proyección se propaga hacia atrás a través de la secuencia de operaciones, de modo que las entradas se solicitan en Mercator de mapas, en una escala determinada por el nivel de zoom del mapa.

proyección
Figura 1. Diagrama de flujo de las operaciones correspondientes a la visualización de una imagen de MODIS en el mapa del editor de código. Las proyecciones (lado izquierdo del diagrama de flujo) de cada operación se determinan a partir del resultado. Las líneas curvas indican el flujo de información hacia la reproyección: específicamente, la proyección y la escala de salida.

En Earth Engine, las proyecciones se especifican mediante un sistema de referencia de coordenadas (CRS o el parámetro crs de muchos métodos). Para verificar la proyección de una imagen, llama a projection() en ella:

Editor de código (JavaScript)

var image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318').select(0);
print('Projection, crs, and crs_transform:', image.projection());
print('Scale in meters:', image.projection().nominalScale());

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)

image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318').select(0)
display('Projection, crs, and crs_transform:', image.projection())
display('Scale in meters:', image.projection().nominalScale())

Ten en cuenta que, si llamas a nominalScale() en el ee.Projection que muestra projection(), puedes determinar la resolución nativa de la imagen. La resolución nativa es la escala de píxeles nominal en metros del nivel más bajo de la pirámide de imágenes. Como cada banda de una imagen puede tener una escala o proyección diferente, si llamas a projection() en una imagen con al menos una banda que no tenga la misma proyección que las demás, es posible que veas un error como el siguiente:

La proyección predeterminada

A menos que necesites que el cálculo se realice en una proyección específica, por lo general, no es necesario especificar una proyección. Solo para los resultados ambiguos, Earth Engine te pedirá que especifiques una proyección o una escala. La ambigüedad puede ser el resultado de reducir una ImageCollection imagen de contenedor que contiene imágenes con diferentes proyecciones (es decir, crear un compuesto). Una imagen que es un compuesto o mosaico de imágenes de entrada con diferentes proyecciones tendrá la proyección predeterminada, que es WGS84 con una escala de 1 grado. Si esta proyección predeterminada no es adecuada para tu análisis (p.ej., es demasiado imprecisa o necesitas evitar artefactos de remuestreo en cálculos posteriores, como el análisis de terreno), puedes establecer un valor predeterminado diferente con image.setDefaultProjection(crs). Esto garantiza que, si Earth Engine necesita elegir una proyección para un cálculo que involucre la imagen, usará la especificada, en lugar de WGS84 en una escala de 1 grado. Por ejemplo:

Editor de código (JavaScript)

var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA');
var mosaic = collection.filterDate('2018-01-01', '2019-01-01').mosaic();
print(mosaic.projection());

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)

collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')
mosaic = collection.filterDate('2018-01-01', '2019-01-01').mosaic()
display(mosaic.projection())

Si intentas usar una imagen como esta en un cálculo, es posible que veas un error como el siguiente:

Por lo general, no se desea ni se pretende realizar una agregación a escala de 1 grado, por lo que Earth Engine proporciona este recordatorio amigable para que se proporcione una especificación completa del resultado.

A menudo, los usuarios encuentran este comportamiento confuso y se preocupan por la información de proyección "perdida", pero los píxeles no se calculan hasta que se necesitan (obtén más información) y, en ese momento, siempre hay una proyección de salida que acompaña a la solicitud que especificó cómo calcular la composición.

En la gran mayoría de los casos de uso, no tener proyección no es un problema y, de hecho, es una optimización valiosa, ya que permite obtener una vista previa de los resultados en cualquier nivel de zoom sin tener que esperar a que se complete el cálculo de la resolución completa. Sin embargo, esto significa que el resultado puede verse diferente en distintos niveles de zoom.

Si, de alguna manera, la imagen de visualización optimizada no es suficiente, se puede forzar el cálculo en una proyección específica volviendo a proyectar el resultado, como se describe en la siguiente sección.

Volver a proyectar

Puedes forzar que las operaciones se realicen en una proyección específica con el método reproject(). El uso de reproject() hace que las entradas se soliciten en la proyección especificada en la llamada a reproject(). Los cálculos en tu código antes de la llamada a reproject() se realizarán en la proyección especificada. Por ejemplo, para forzar que se produzca un compuesto en una proyección específica, haz lo siguiente:

Editor de código (JavaScript)

// Some projection that is suitable for your area of interest.
var proj = ee.Projection(...);
var output = collection.reduce(...).reproject(proj);

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)

# Some projection that is suitable for your area of interest.
proj = ee.Projection(...)
output = collection.reduce(...).reproject(proj)

Entre los pocos casos que requieren una proyección fija, se incluyen los siguientes:

Las funciones del paquete ee.Terrain (p.ej., slope, aspect y hillshade) calculan valores en función de los píxeles vecinos y son sensibles a los artefactos de remuestreo que se introducen durante la reproyección. Cuando la proyección del cálculo difiere de la proyección nativa del MDE, el nuevo muestreo predeterminado del vecino más cercano puede crear patrones artificiales en el resultado. Para obtener mejores resultados, realiza el análisis del terreno en la proyección nativa del DEM. Si trabajas con un ImageCollection de mosaicos de DEM, crea un mosaico y usa setDefaultProjection() con la proyección nativa de la colección para asegurarte de que el análisis se ejecute en la cuadrícula correcta, como se describe en la sección La proyección predeterminada.

Existen varios motivos por los que deberías evitar usar reproject(), a menos que sea absolutamente necesario. Supongamos, por ejemplo, que vuelves a proyectar un elemento y lo agregas al mapa. Si la escala que especificaste en la llamada a reproject() es mucho menor que el nivel de zoom del mapa, Earth Engine solicitará todas las entradas en una escala muy pequeña, en una extensión espacial muy amplia. Esto puede provocar que se soliciten demasiados datos a la vez y que se produzca un error.

Si el resultado final se encuentra en una proyección diferente de la especificada en la llamada a reproject(), se producirá otra reproyección. Este es otro motivo para tener cuidado cuando uses reproject() en tu código. Considera el siguiente ejemplo, que fuerza a la imagen de MODIS a volver a proyectarse primero a WGS84 y, luego, a Mercator de mapas para mostrarse en el mapa del editor de código:

Editor de código (JavaScript)

// The input image has a SR-ORG:6974 (sinusoidal) projection.
var image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0);

// Operations *before* the reproject call will be done in the projection
// specified by reproject().  The output results in another reprojection.
var reprojected = image
    .unitScale(-2000, 10000)
    .reproject('EPSG:4326', null, 500);
Map.addLayer(reprojected, {min: 0.15, max: 0.7}, 'Reprojected');

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)

# The input image has a SR-ORG:6974 (sinusoidal) projection.
image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0)

# Operations *before* the reproject call will be done in the projection
# specified by reproject(). The output results in another reprojection.
reprojected = image.unitScale(-2000, 10000).reproject('EPSG:4326', None, 500)
m = geemap.Map()
m.add_layer(reprojected, {'min': 0.15, 'max': 0.7}, 'Reprojected')
m

En la figura 2, se muestra el flujo de operaciones correspondiente a este ejemplo simple de reproyección. Ten en cuenta que la primera reproyección es explícita, como se especifica en la llamada a reproject(). La segunda reproyección es implícita y Earth Engine la realiza automáticamente para mostrar el resultado en el mapa. También observa que la información sobre qué proyección usar se propaga desde la solicitud hasta la entrada.

reproyección
Figura 2. Diagrama de flujo de las operaciones correspondientes a la reproyección de una imagen de MODIS en el mapa del editor de código. Las líneas curvas indican el flujo de información hacia las reproyecciones: específicamente, la proyección y la escala de salida.