Проекции

Earth Engine разработан таким образом, что вам редко приходится беспокоиться о проекциях карт при выполнении вычислений. Как и в случае с масштабом, проекция, в которой выполняются вычисления, определяется по принципу "pull". В частности, входные данные запрашиваются в выходной проекции. Выходные данные могут определяться параметром функции (например, 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. Обратите внимание, что проекция входных данных определяется выходными данными, в частности проекцией maps mercator отображения карты в редакторе кода. Эта проекция распространяется обратно по последовательности операций, так что входные данные запрашиваются в проекции Меркатора, в масштабе, определяемом уровнем масштабирования карты.

projection
Рисунок 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())

Обратите внимание, что, вызвав nominalScale() в объекте ee.Projection, возвращенном методом projection(), вы можете определить исходное разрешение изображения. Исходное разрешение – это номинальный масштаб пикселей в метрах на самом низком уровне пирамиды изображений. Поскольку каждый диапазон изображения может иметь разный масштаб и/или проекцию, если вы вызовете projection() для изображения, у которого хотя бы один диапазон не имеет той же проекции, что и другие, вы можете увидеть ошибку, подобную следующей:

Проекция по умолчанию

Если вам не нужно, чтобы вычисления выполнялись в определенной проекции, указывать ее не требуется. Указывать проекцию и/или масштаб в Earth Engine нужно только для неоднозначных выходных данных. Неоднозначность может возникнуть в результате уменьшения ImageCollection, содержащего изображения с разными проекциями (т.е. создания композита). Изображение, которое является составным или мозаичным из входных изображений с разными проекциями, будет иметь проекцию по умолчанию, то есть WGS84 с масштабом 1 градус. Если проекция по умолчанию не подходит для вашего анализа (например, она слишком грубая или вам нужно предотвратить артефакты повторной выборки в последующих вычислениях, таких как анализ рельефа), вы можете установить другую проекцию по умолчанию с помощью image.setDefaultProjection(crs). Это гарантирует, что если Earth Engine потребуется выбрать проекцию для вычислений с использованием изображения, будет использоваться указанная проекция, а не WGS84 в масштабе 1 градус. Пример:

Редактор кода (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) вычисляют значения на основе соседних пикселей и чувствительны к артефактам передискретизации, возникающим во время перепроецирования. Если проекция вычислений отличается от нативной проекции ЦМР, передискретизация по умолчанию по методу ближайшего соседа может создать искусственные шаблоны в выходных данных. Для получения наилучших результатов выполняйте анализ рельефа в исходной проекции ЦМР. Если вы работаете с 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 на карте редактора кода. Изогнутые линии указывают на поток информации к перепроекциям, в частности на выходную проекцию и масштаб.