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');
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.
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());
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());
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);
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:
- Calcular gradientes (p. ej.,
ee.Terrain.gradientoee.Terrain.slope) reduceResolution, para cuando quieras agregar píxeles de mayor resolución en una resolución más baja. (Obtén más información para reducir la resolución).
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');
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.