Клиентские библиотеки Earth Engine для Python и JavaScript преобразуют сложный геопространственный анализ в запросы Earth Engine. Код, который вы пишете для клиентской библиотеки, может содержать смесь ссылок на объекты на стороне клиента и переменные, представляющие объекты на стороне сервера.
Важно отличать объекты Earth Engine от других объектов или примитивов Python или JavaScript, которые могут быть в вашем коде. Вы можете управлять объектами на сервере, управляя клиентскими "прокси-объектами" в скрипте. Объекты-прокси можно распознать по префиксу ee. Эти прокси-объекты Earth Engine не содержат фактических данных и являются лишь дескрипторами объектов на сервере. Для начала рассмотрим клиентский строковый объект (который НЕ является прокси-объектом):
Редактор кода (JavaScript)
var clientString = 'I am a String'; print(typeof clientString); // string
import ee import geemap.core as geemap
Colab (Python)
client_string = 'I am a String' print(type(client_string)) # str
Обратите внимание, что клиент (браузер или блокнот) интерпретировал и выполнил этот код, определив, что переменная относится к типу string. Теперь предположим, что вы хотите, чтобы Earth Engine мог что-то сделать с этой строкой. Для этого нужно поместить строку в контейнер и отправить его в Google. Этот контейнер и есть прокси-объект. Пример:
Редактор кода (JavaScript)
var serverString = ee.String('I am not a String!'); print(typeof serverString); // object print('Is this an EE object?', serverString instanceof ee.ComputedObject); // true
import ee import geemap.core as geemap
Colab (Python)
server_string = ee.String('I am not a String!') print(type(server_string)) # ee.ee_string.String print( 'Is this an EE object?', isinstance(server_string, ee.ee_string.String) ) # True
Обратите внимание, что в выходных данных ee.String – это object, а не string. Точнее, это ee.computedObject, то есть прокси-объект для чего-то на сервере. Представьте, что ee.Thing – это способ поместить объект в контейнер для отправки в Google. Клиент не знает, что находится в контейнере, но вы можете узнать это, распечатав его:
Редактор кода (JavaScript)
print(serverString); // I am not a String
import ee import geemap.core as geemap
Colab (Python)
print(server_string.getInfo()) # I am not a String
Чтобы посмотреть, как выглядит сам контейнер, выведите строковое представление объекта:
Редактор кода (JavaScript)
print(serverString.toString()); // ee.String("I am not a String!")
import ee import geemap.core as geemap
Colab (Python)
print(server_string) # ee.String({"constantValue": "I am not a String!"})
Если вам по какой-то причине нужно использовать Python или JavaScript на стороне клиента для работы с содержимым контейнера, используйте getInfo(), чтобы получить содержимое контейнера и присвоить его переменной:
Редактор кода (JavaScript)
var someString = serverString.getInfo(); var strings = someString + ' Am I?'; print(strings); // I am not a String! Am I?
import ee import geemap.core as geemap
Colab (Python)
some_string = server_string.getInfo() strings = some_string + ' Am I?' print(strings) # I am not a String! Am I?
Повтор
Поскольку клиент не знает, что находится в серверных ee.Thing объектах, клиентские операции, такие как условные выражения и циклы for, не работают с ними. По этой причине, а также чтобы избежать синхронных вызовов getInfo(), по возможности используйте серверные функции. Например, рассмотрим два способа создания списка:
Не рекомендуется – клиентский цикл for
Редактор кода (JavaScript)
var clientList = []; for(var i = 0; i < 8; i++) { clientList.push(i + 1); } print(clientList);
import ee import geemap.core as geemap
Colab (Python)
client_list = [] for i in range(8): client_list.append(i + 1) print(client_list)
Рекомендуемый вариант – сопоставление на стороне сервера
Редактор кода (JavaScript)
var serverList = ee.List.sequence(0, 7); serverList = serverList.map(function(n) { return ee.Number(n).add(1); }); print(serverList);
import ee import geemap.core as geemap
Colab (Python)
server_list = ee.List.sequence(0, 7) server_list = server_list.map(lambda n: ee.Number(n).add(1)) print(server_list.getInfo())
Пример сопоставления на стороне сервера может показаться немного глупым, поскольку вы можете создать такой же список, просто используя ee.List.sequence(1, 8), но он иллюстрирует некоторые важные концепции. Первая концепция – map(), которая просто применяет одну и ту же функцию ко всем элементам списка. Поскольку эта функция выполняется на сервере, клиентские функции, такие как getInfo() и print(), не будут работать в сопоставленной функции. Поэтому код i + 1 нужно заменить эквивалентным кодом на стороне сервера: ee.Number(n).add(1). n – это объект, который существует только на сервере. Поскольку функция не знает тип своего аргумента, его необходимо привести к ee.Number.
Также стоит отметить, что иногда клиентская функциональность может быть удобна. Например, предыдущий цикл for можно использовать для создания списка и его упаковки в объект на стороне сервера:
Редактор кода (JavaScript)
var toServerList = ee.List(clientList);
import ee import geemap.core as geemap
Colab (Python)
to_server_list = ee.List(client_list)
Помните, что клиентская обработка выполняется в вашем блокноте или браузере, на ЦП хост-машины, поэтому она может быть менее эффективной, чем использование Earth Engine для выполнения работы на сервере. Кроме того, чтобы избежать неожиданных результатов, рекомендуется не смешивать в скриптах клиентские и серверные функции. В разделе Условные операторы приведен пример возможных непредвиденных последствий.
Условные предложения
Серверные объекты не всегда работают с клиентскими функциями, и наоборот. Рассмотрим пример с логической переменной на стороне сервера:
Редактор кода (JavaScript)
var myList = ee.List([1, 2, 3]); var serverBoolean = myList.contains(5); print(serverBoolean); // false
import ee import geemap.core as geemap
Colab (Python)
my_list = ee.List([1, 2, 3]) server_boolean = my_list.contains(5) print(server_boolean.getInfo()) # False
Как показано в примере ниже, переменная не работает в клиентском условии, поскольку она является серверным объектом. Чтобы правильно проверить логическое значение на стороне сервера, используйте функцию на стороне сервера:
Не рекомендуется – клиентское условное выражение
Редактор кода (JavaScript)
var clientConditional; if (serverBoolean) { clientConditional = true; } else { clientConditional = false; } print('Should be false:', clientConditional); // True!
import ee import geemap.core as geemap
Colab (Python)
if server_boolean: client_conditional = True else: client_conditional = False print('Should be False:', client_conditional) # True!
Рекомендуется – условная на стороне сервера.
Редактор кода (JavaScript)
var serverConditional = ee.Algorithms.If(serverBoolean, 'True!', 'False!'); print('Should be false:', serverConditional); // False!
import ee import geemap.core as geemap
Colab (Python)
server_conditional = ee.Algorithms.If(server_boolean, 'True!', 'False!') print('Should be False:', server_conditional.getInfo()) # False!
Функции клиента и сервера
В предыдущих разделах описано несколько причин, по которым неэффективно или нелогично смешивать объекты и функции клиента и сервера. Какие объекты и функции относятся к клиентской стороне, а какие – к серверной? В общем случае все, что инициализировано как ee.Thing, является объектом сервера, а любой метод этого объекта, ee.Thing.method(), – функцией сервера. Объекты и функции, которые появляются в справочнике по Python или JavaScript, являются клиентскими. Как отмечалось ранее, вы можете использовать клиентскую функциональность для создания объекта, а затем обернуть его, передав клиентский объект конструктору Earth Engine, например ee.String().