投影

Earth Engine 经过精心设计,让您在进行计算时几乎无需担心地图投影问题。与比例一样,进行计算的投影也是根据“拉取”确定的。具体而言,系统会在输出投影中请求输入。输出可能由函数参数(例如 crs)、代码编辑器和 geemap 地图对象(具有地图墨卡托 (EPSG:3857) 投影)或 reproject() 调用确定。在代码编辑器或 geemap 中显示图片时,系统会请求以墨卡托地图投影作为输入。请考虑对具有正弦投影的 MODIS 图像执行以下操作:

代码编辑器 (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');

Python 设置

如需了解 Python API 和如何使用 geemap 进行交互式开发,请访问 Python 环境页面。

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

图 1 描绘了此代码示例的操作顺序。请注意,输入的投影由输出决定,具体而言,由代码编辑器中地图显示的地图墨卡托投影决定。此投影会通过操作序列向后传播,以便在地图墨卡托中请求输入,其比例由地图的缩放级别决定。

投影
图 1. 与在代码编辑器地图中显示 MODIS 图像对应的操作流程图。每个操作的投影(流程图左侧)由输出决定。曲线表示信息流向重新投影:具体而言,即输出投影和比例。

在 Earth Engine 中,投影由坐标参考系(CRS 或许多方法的 crs 参数)指定。您可以通过对图片调用 projection() 来检查其投影:

代码编辑器 (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());

Python 设置

如需了解 Python API 和如何使用 geemap 进行交互式开发,请访问 Python 环境页面。

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())

请注意,通过对 projection() 返回的 ee.Projection 调用 nominalScale(),您可以确定图片的原生分辨率。原生分辨率是图片金字塔最低级别的名义像素比例(以米为单位)。由于图片的每个波段都可能具有不同的比例和/或投影,因此如果您对至少有一个波段与其他波段投影不同的图片调用 projection(),可能会看到如下错误:

默认投影

除非您需要在特定投影中进行计算,否则通常无需指定投影。只有在输出不明确时,Earth Engine 才会要求您指定投影和/或比例。缩减包含具有不同投影的图片的 ImageCollection(即创建合成)可能会导致歧义。如果图片是由具有不同投影的输入图片合成或拼接而成,则会采用默认投影,即 WGS84,比例为 1 度。如果此默认投影不适合您的分析(例如,它太粗糙,或者您需要防止下游计算(如地形分析)中出现重采样伪影),您可以使用 image.setDefaultProjection(crs) 设置其他默认值。这样可以确保,如果 Earth Engine 需要为涉及该图片的计算选择投影,它将使用指定的投影,而不是 1 度比例的 WGS84。例如:

代码编辑器 (JavaScript)

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

Python 设置

如需了解 Python API 和如何使用 geemap 进行交互式开发,请访问 Python 环境页面。

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())

如果您尝试在计算中使用此类图片,可能会看到如下错误:

通常,1 度比例的聚合并不是预期或预期的,因此 Earth Engine 会提供此友好提醒,以便为输出提供完整的规范。

用户通常会对此行为感到困惑,并担心“丢失”投影信息,但实际上,像素在需要时才会计算(了解详情),此时,请求中始终会附带一个输出投影,用于指定如何计算合成。

在绝大多数用例中,没有投影并不是问题,实际上是一种有价值的优化,因为它允许在任何缩放级别预览结果,而无需等待完整分辨率计算完成。但这意味着输出在不同的缩放级别下可能会有所不同。

如果优化后的显示图片因某种原因而不够充分,则可以通过重新投影输出来强制在特定投影中进行计算,如以下部分所述。

重新投影

您可以使用 reproject() 方法强制在特定投影中执行操作。使用 reproject() 会导致在 reproject() 调用中指定的投影中请求输入。在 reproject() 调用之前,代码中的计算将在指定的投影中完成。例如,如需强制在特定投影中生成合成图像,请运行以下命令:

代码编辑器 (JavaScript)

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

Python 设置

如需了解 Python API 和如何使用 geemap 进行交互式开发,请访问 Python 环境页面。

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)

需要固定投影的几种情况包括:

  • 计算梯度(例如 ee.Terrain.gradient 或 ee.Terrain.slope)。
  • reduceResolution,适用于您希望将高分辨率像素聚合为低分辨率像素的情况。(详细了解如何降低分辨率)。

ee.Terrain 软件包中的函数(例如 slope、aspect、hillshade)会根据相邻像素计算值,并且对重新投影期间引入的重采样伪影非常敏感。当计算投影与 DEM 的原生投影不同时,默认的最近邻重采样可能会在输出中产生人工模式。为获得最佳结果,请在 DEM 的原生投影中执行地形分析。如果使用 DEM 图块的 ImageCollection,请创建一个镶嵌数据集,并使用 setDefaultProjection() 搭配集合的原生投影,以确保分析在正确的网格上运行,如默认投影部分所述。

除非绝对必要,否则您应避免使用 reproject(),原因有以下几点。例如,假设您重新投影了某个内容并将其添加到地图中。如果您在 reproject() 调用中指定的比例远小于地图的缩放级别,Earth Engine 将在非常广阔的空间范围内以非常小的比例请求所有输入。这可能会导致一次请求的数据过多,从而导致错误。

如果最终输出的投影与 reproject() 调用中指定的投影不同,则会导致再次重投影。这是在代码中使用 reproject() 时需要谨慎的另一个原因。请考虑以下示例,该示例会强制 MODIS 图像先重新投影到 WGS84,然后重新投影到地图墨卡托,以便在代码编辑器地图中显示:

代码编辑器 (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');

Python 设置

如需了解 Python API 和如何使用 geemap 进行交互式开发,请访问 Python 环境页面。

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

图 2 绘制了与此简单重新投影示例对应的操作流程。请注意,第一次重新投影是显式的,如 reproject() 调用中所指定。第二次重投影是隐式的,由 Earth Engine 自动执行,以便在地图上显示结果。另请注意,有关要使用的投影的信息会从请求传播回输入。

重新投影
图 2. 与代码编辑器地图中 MODIS 图像的重新投影相对应的操作流程图。曲线表示信息流向重新投影:具体而言,即输出投影和比例。