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

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

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

GeoTIFF

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

Чтобы загрузить файл GeoTIFF с помощью редактора кода, выберите вкладку "Объекты" в левом верхнем углу, нажмите кнопку и выберите Загрузка изображения. В 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, как миллисекунды и форматирует его как дату.

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

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

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

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

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

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

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

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

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