Импорт растровых данных

Вы можете использовать Менеджер объектов или интерфейс командной строки (CLI), чтобы загружать изображения или другие наборы данных растровых изображений с географической привязкой в формате GeoTIFF или TFRecord. Подробнее о том, как импортировать векторные данные с помощью редактора кода…

Загрузка объектов изображений

GeoTIFF

В редакторе кода вы можете загрузить графические файлы GeoTIFF размером до 10 ГБ в пользовательскую папку Earth Engine. Для файлов большего размера используйте загрузку через командную строку.

Чтобы загрузить файл GeoTIFF с помощью редактора кода, выберите вкладку Assets (Объекты) в левом верхнем углу, нажмите кнопку и выберите Image upload (Загрузка изображения). В Earth Engine откроется диалоговое окно загрузки, как на рисунке 1. Нажмите кнопку SELECT (Выбрать) и найдите файл GeoTIFF в локальной файловой системе.

Присвойте изображению подходящий идентификатор объекта (который ещё не используется) в пользовательской папке. Если вы хотите загрузить изображение в существующую папку или коллекцию, добавьте к идентификатору объекта префикс с идентификатором папки или коллекции, например projects/myproject/folder-or-collection-id/new-asset.

Нажмите Загрузить.

объекты
Рисунок 1. Диалоговое окно загрузки изображений в Менеджере объектов

После начала загрузки на вкладке Tasks (Задачи) в правой части редактора кода появится задача Asset ingestion (Загрузка объекта). Если навести указатель на задачу в диспетчере задач, появится значок ?. , который позволяет проверить статус загрузки. Чтобы отменить загрузку, нажмите на вращающийся значок рядом с задачей. После завершения загрузки объект появится в вашей папке пользователя со значком .

Сжатие GeoTIFF

Файлы GeoTIFF можно сжимать с помощью DEFLATE, JPEG, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP или ZSTD. Для файлов Cloud Optimized GeoTIFF (COG), которые Earth Engine считывает на месте, а не загружает, поддерживается меньше форматов. Подробнее о сжатии COG…

Рекомендации по загрузке больших файлов:

  • Лучший выбор. ZSTD обеспечивает хороший баланс скорости и сжатия.
  • Не рекомендуется. LZMA может работать очень медленно, несмотря на хорошее сжатие.
  • Несжатые файлы. Файлы будут большего размера, и их загрузка займет больше времени.
  • Сжатие с потерями (например, JPEG). Может изменить значения пикселей. Используйте сжатие без потерь (например, DEFLATE, LZMA, LZW, ZSTD), а не с потерями, если вы не уверены, как это повлияет на ваши данные.

TFRecord

Чтобы загрузить изображение из файла TFRecord, у вас должен быть связанный файл микшера, который был сгенерирован при экспорте изображений, на которых вы выполняли вывод. Подробную информацию о файле микшера можно найти на странице экспорта. В частности, чтобы импортировать прогнозы (в виде изображения), сделанные на основе экспортированных снимков,

  1. Экспортируйте изображения в один или несколько файлов TFRecord.
  2. Выполните вывод на основе изображений (например, model.predict()).
  3. Запишите выходные данные model.predict() в файл TFRecord. Прогнозы должны быть в том же порядке, что и экспортированные изображения, на которых вы выполняли логический вывод. Порядок можно задать, отсортировав названия файлов, созданных при экспорте. Подробные сведения приведены в разделе Экспорт больших файлов.
  4. Загрузите файлы TFRecord и связанный с ними микшер в Earth Engine.

Изменение ресурсов

Измените метаданные объекта, указав одно или несколько свойств метаданных. В меню Свойства нажмите Добавить свойство, чтобы задать название и значение свойства (рис. 2). Значение может быть строкой или числом. Введите строки без кавычек. Чтобы отформатировать число как строку, введите перед ним одинарную кавычку (').

По умолчанию добавляется свойство system:time_start без значения. Это свойство используется Earth Engine при применении фильтров дат ImageCollection. Введите дату в формате, показанном на рисунке 2, или число, представляющее миллисекунды с 1 января 1970 года. Подробную информацию о временных метках в Earth Engine можно найти в глоссарии. Менеджер объектов интерпретирует число, указанное в качестве значения свойства system:time_start или system:time_end, как миллисекунды и форматирует его как дату.

Чтобы удалить ресурс, нажмите на значок .

Дополнительные настройки

В меню Advanced (Дополнительно) выберите правила пирамидирования и режим маскирования для своих данных.

Правила пирамиды определяют, как Earth Engine генерирует версии изображения с более низким разрешением. Подробнее о том, как Earth Engine обрабатывает несколько разрешений, рассказывается в документации по масштабированию. Выберите правило пирамидирования Mean, Min или Max, чтобы рассчитать уровни более низкого разрешения пирамиды изображений как среднее, минимальное или максимальное значение для каждой группы пикселей 2 x 2 с более высоким разрешением. Этот вариант подходит для изображений с непрерывными значениями. Для категориальных данных (например, земного покрова) или данных контроля качества выберите правило пирамиды Sample (верхний левый пиксель) или Mode (наиболее часто встречающееся значение или выборка, если моды нет).

Режим маскирования указывает, как загруженное изображение маскируется (если маскируется). Чтобы указать значение, которое будет использоваться при отсутствии данных, выберите "Значение, используемое при отсутствии данных" и введите его. Пиксели с этим значением будут замаскированы на загруженном изображении. Это значение применяется к каждой полосе изображения независимо. Чтобы использовать последний канал изображения в качестве маски для других каналов, выберите "Использовать последний канал в качестве альфа-канала". Альфа-канал должен быть беззнаковым 8-битным каналом, где 0 – это маскированные (полностью прозрачные) данные, а 255 – полностью непрозрачные.

Загрузка фрагментов

Чтобы загрузить одно изображение в виде нескольких фрагментов, каждый из которых хранится в отдельном исходном файле, нажмите Добавить ещё один файл. Earth Engine объединит фрагменты в одно изображение в вашей пользовательской папке.

Существует несколько ограничений на типы файлов, которые можно загрузить в объект изображения. В их числе:

  1. У изображений должно быть одинаковое количество каналов, глубина цвета, проекция, разрешение и значения заполнения.
  2. Смещение от одного файла к другому должно быть целым числом, кратным размеру пикселя.
  3. Промежутки между фрагментами будут заполнены замаскированными пикселями на итоговом изображении, поэтому в идеале фрагменты должны быть смежными, а не разбросанными. Изображения, на которых пробелы занимают более 99 % площади, не будут загружены.