Экспорт изображений

Вы можете экспортировать изображения из Earth Engine в формате GeoTIFF или TFRecord . Дополнительные параметры вывода см. в разделе «Параметры конфигурации» .

Пример настройки

Начните с определения данных изображения, которые будут экспортироваться:

Редактор кода (JavaScript)

// Load a landsat image and select three bands.
var landsat = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_123032_20140515')
  .select(['B4', 'B3', 'B2']);

// Create a geometry representing an export region.
var geometry = ee.Geometry.Rectangle([116.2621, 39.8412, 116.4849, 40.01236]);

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Load a landsat image and select three bands.
landsat = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_123032_20140515').select(
    ['B4', 'B3', 'B2']
)

# Create a geometry representing an export region.
geometry = ee.Geometry.Rectangle([116.2621, 39.8412, 116.4849, 40.01236])

Затем определите параметры проекции , которые будут использоваться при следующем экспорте. Мы используем параметр crs для указания системы координат и параметр crsTransform для точного указания сетки пикселей. Параметр crsTransform — это список параметров из матрицы аффинного преобразования в порядке строк [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation] . Происхождение изображения определяется значениями xTranslation и yTranslation , а размер пикселя изображения определяется значениями xScale и yScale . См . примеры аффинных матриц .

Редактор кода (JavaScript)

// Retrieve the projection information from a band of the original image.
// Call getInfo() on the projection to request a client-side object containing
// the crs and transform information needed for the client-side Export function.
var projection = landsat.select('B2').projection().getInfo();

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Retrieve the projection information from a band of the original image.
# Call getInfo() on the projection to request a client-side object containing
# the crs and transform information needed for the client-side Export function.
projection = landsat.select('B2').projection().getInfo()

Предупреждение: параметр scale может вводить в заблуждение. Если вы пытаетесь точно сопоставить существующую проекцию, вам не следует использовать scale — подробности см. в следующем разделе .

Настройка scale

В качестве ярлыка вы можете указать параметр scale , и Earth Engine рассчитает для вас параметр crsTransform . Однако простая установка масштаба изображения не определяет начало проекции и может привести к тому, что изображение будет сдвинуто относительно другого изображения с тем же размером пикселя!

Причина потенциального сдвига заключается в том, что параметр scale используется для заполнения значений xScale и yScale crsTransform , но значения xTranslation и yTranslation вычисляются так, что если они делятся на соответствующие значения xScale и yScale , остаток будет равен нулю. Эти параметры определяют пиксельную сетку, в которой начало проекции находится в углу пикселя. Это соглашение отличается от параметров перевода, используемых некоторыми поставщиками данных, которые используют сетки, смещенные от начала координат проекции. Например, изображения Landsat, предоставленные Геологической службой США, используют параметры перевода, которые смещены на 1/2 пикселя от начала координат проекции (смещение 15 м для 30-метровых диапазонов), тогда как изображения Sentinel-2, предоставленные ESA, используют параметры перевода, которые совмещены с началом координат проекции. Если crsTransform указанный при экспорте, не соответствует crsTransform исходного изображения, выходные пиксели будут повторно дискретизированы (по умолчанию с использованием ближайшего соседа), что приведет к смещению результирующего изображения относительно исходного изображения.

Подводя итог, если вам нужно сопоставить пиксели экспортированного изображения с конкретным изображением, обязательно используйте параметры crs и crsTransform для полного управления сеткой.

ездить

Чтобы экспортировать изображение в свою учетную запись Диска, используйте Export.image.toDrive() . Например, чтобы экспортировать части изображения Landsat, определите регион для экспорта, а затем вызовите Export.image.toDrive() :

Редактор кода (JavaScript)

// Export the image, specifying the CRS, transform, and region.
Export.image.toDrive({
  image: landsat,
  description: 'imageToDriveExample_transform',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry
});

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Export the image, specifying the CRS, transform, and region.
task = ee.batch.Export.image.toDrive(
    image=landsat,
    description='imageToDriveExample_transform',
    crs=projection['crs'],
    crsTransform=projection['transform'],
    region=geometry,
)
task.start()

При запуске этого кода на вкладке « Задачи редактора кода» будет создана задача экспорта. Нажмите кнопку «Выполнить» рядом с задачей, чтобы запустить ее. (Подробнее о Диспетчере задач можно узнать в разделе «Редактор кода» ). Изображение будет создано в вашей учетной записи Диска с указанным fileFormat .

в облачное хранилище

Чтобы экспортировать изображение в корзину Google Cloud Storage, используйте Export.image.toCloudStorage() . Чтобы экспортировать изображение Landsat из предыдущего примера в Cloud Storage вместо Drive, используйте:

Редактор кода (JavaScript)

// Export the image to Cloud Storage.
Export.image.toCloudStorage({
  image: landsat,
  description: 'imageToCloudExample',
  bucket: 'your-bucket-name',
  fileNamePrefix: 'exampleExport',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry
});

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Export the image to Cloud Storage.
task = ee.batch.Export.image.toCloudStorage(
    image=landsat,
    description='imageToCloudExample',
    bucket='your-bucket-name',
    fileNamePrefix='exampleExport',
    crs=projection['crs'],
    crsTransform=projection['transform'],
    region=geometry,
)
task.start()

Как и при экспорте на Диск, начните экспорт со вкладки «Задачи» . Расположение сегмента Cloud Storage может повлиять на производительность и затраты на хранилище. Дополнительные сведения см. в разделе часто задаваемых вопросов по вопросам расположения .

в актив

Чтобы экспортировать изображение в ресурс в папке ресурсов Earth Engine, используйте Export.image.toAsset() . Чтобы управлять ресурсами Earth Engine или проверять, какая часть квоты хранилища используется, используйте Asset Manager . Следующий пример иллюстрирует экспорт частей изображения Landsat с использованием разных политик построения пирамид для одного и того же канала. Политика построения пирамид указывает, как Earth Engine вычисляет версии актива с более низким разрешением. Узнайте больше о том, как Earth Engine обрабатывает несколько разрешений, в документе масштабирования .

Редактор кода (JavaScript)

// Get band 4 from the Landsat image, copy it.
var band4 = landsat.select('B4').rename('b4_mean')
  .addBands(landsat.select('B4').rename('b4_sample'))
  .addBands(landsat.select('B4').rename('b4_max'));

// Export the image to an Earth Engine asset.
Export.image.toAsset({
  image: band4,
  description: 'imageToAssetExample',
  assetId: 'exampleExport',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry,
  pyramidingPolicy: {
    'b4_mean': 'mean',
    'b4_sample': 'sample',
    'b4_max': 'max'
  }
});

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Get band 4 from the Landsat image, copy it.
band_4 = (
    landsat.select('B4')
    .rename('b4_mean')
    .addBands(landsat.select('B4').rename('b4_sample'))
    .addBands(landsat.select('B4').rename('b4_max'))
)

# Export the image to an Earth Engine asset.
task = ee.batch.Export.image.toAsset(
    image=band_4,
    description='imageToAssetExample',
    assetId='projects/your-project/assets/exampleExport',
    crs=projection['crs'],
    crsTransform=projection['transform'],
    region=geometry,
    pyramidingPolicy={
        'b4_mean': 'mean',
        'b4_sample': 'sample',
        'b4_max': 'max',
    },
)
task.start()

Вы можете предоставить политику построения пирамид по умолчанию для каждой полосы, которая не указана явно, используя ключ '.default' . Вы также можете передать только ключ '.default' . Например, чтобы по умолчанию использовать для всех диапазонов политику построения пирамиды «sample», используйте {'.default': 'sample'} .

Параметры конфигурации

Обратите внимание, что словарь параметров конфигурации, передаваемый в Export.image включает scale (в метрах) и регион экспорта в виде ee.Geometry . Экспортированное изображение покроет указанную область пикселями в указанном масштабе. Если это не указано явно, CRS вывода будет взят из первого канала экспортируемого изображения.

Вы также можете указать dimensions , crs и/или crsTransform экспортируемого изображения. Дополнительную информацию о crs и crsTransform смотрите в глоссарии . Например, чтобы получить блок пикселей, точно выровненный по другому источнику данных, укажите dimensions , crs и crsTransform . Чтобы получить блок пикселей предопределенного размера (например, миниатюрное изображение 256x256), охватывающий регион, укажите dimensions и region .

Вы можете указать формат вывода изображения (если назначением не является toAsset() ) с помощью параметра fileFormat (по умолчанию 'GeoTIFF' ).

Параметр formatOptions

Другие параметры конфигурации задаются с помощью параметра formatOptions , который должен представлять собой словарь с другими параметрами формата, специфичными для каждого fileFormat как описано ниже.

ГеоTIFF

Оптимизированный для облака GeoTIFF

Чтобы экспортировать оптимизированный для облака GeoTIFF , передайте литерал JavaScript для formatOptions , в котором для ключа cloudOptimized установлено значение true . Продолжая предыдущий пример:

Редактор кода (JavaScript)

// Export a cloud-optimized GeoTIFF.
Export.image.toDrive({
  image: landsat,
  description: 'imageToCOGeoTiffExample',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry,
  fileFormat: 'GeoTIFF',
  formatOptions: {
    cloudOptimized: true
  }
});

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Export a cloud-optimized GeoTIFF.
task = ee.batch.Export.image.toDrive(
    image=landsat,
    description='imageToCOGeoTiffExample',
    crs=projection['crs'],
    crsTransform=projection['transform'],
    region=geometry,
    fileFormat='GeoTIFF',
    formatOptions={'cloudOptimized': True},
)
task.start()

Оптимизированные для облака файлы GeoTIFF можно перезагрузить из облачного хранилища в Image . Подробности смотрите в документации по обзору Image .

Нодата

Укажите значение nodata GeoTIFF, используя ключ noData в параметре formatOptions . Например:

Редактор кода (JavaScript)

// Set a nodata value and replace masked pixels around the image edge with it.
var noDataVal = -9999;
landsat = landsat.unmask(noDataVal);

Export.image.toDrive({
  image: landsat,
  description: 'imageNoDataExample',
  crs: projection.crs,
  scale: 2000,  // large scale for minimal demo
  region: landsat.geometry(),  // full image bounds
  fileFormat: 'GeoTIFF',
  formatOptions: {
    noData: noDataVal,
  }
});

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Set a nodata value and replace masked pixels around the image edge with it.
no_data_val = -9999
landsat = landsat.unmask(no_data_val)

task = ee.batch.Export.image.toDrive(
    image=landsat,
    description='imageNoDataExample',
    crs=projection['crs'],
    scale=2000,  # large scale for minimal demo
    region=landsat.geometry(),  # full image bounds
    fileFormat='GeoTIFF',
    formatOptions={'noData': no_data_val},
)
task.start()

Обратите внимание, что значение nodata должно находиться в допустимом диапазоне для PixelType изображения. Вы можете проверить PixelType , распечатав метаданные изображения и просмотрев свойство data_type первого бэнда. Вы также можете установить PixelType изображения, приведя данные к определенному типу, например, с помощью методов изображения toShort() или toInt() .

TFRecord

См. страницу формата данных TFRecord .

maxPixels

Параметр maxPixels предназначен для предотвращения непреднамеренного создания очень больших экспортных файлов. Если значение по умолчанию слишком низкое для предполагаемого выходного изображения, вы можете увеличить maxPixels . Например:

Export.image.toDrive({
  image: landsat,
  description: 'maxPixelsExample',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry,
  maxPixels: 1e9
});

Экспорт больших файлов

Если выходное изображение большое, оно будет экспортировано в виде нескольких файлов. Если вы экспортируете в формат GeoTIFF, изображение разбивается на фрагменты. Имя файла каждой плитки будет иметь вид baseFilename-yMin-xMin , где xMin и yMin — это координаты каждой плитки в общей ограничивающей рамке экспортированного изображения.

Если вы экспортируете в TFRecord, к файлам будут добавлены значения -00000 , -00001 ,... -0000N для файлов N+1 . Соблюдение этого порядка важно, если вы собираетесь выполнить логические выводы на основе файлов и загрузить прогнозы обратно в Earth Engine в виде изображения. Подробности см. в разделе «Загрузка изображений в виде файлов TFRecord» .

Экспорт изображений в том виде, в котором они отображаются в редакторе кода.

Чтобы экспортировать изображения, отображаемые на экране в Earth Engine, создайте изображения визуализации, как показано в разделах «Визуализация изображений» и «Композитинг» и «Мозаика» . Поскольку редактор кода использует CRS 'EPSG:3857' , укажите CRS 'EPSG:3857' при экспорте, чтобы получить изображение в той же проекции, которая отображается на карте редактора кода. Подробную информацию об указании разрешения и системы координат вывода см. в разделе «Настройка экспорта изображений» .

,

Вы можете экспортировать изображения из Earth Engine в формат GeoTIFF или TFRecord . Дополнительные параметры вывода см. в разделе «Параметры конфигурации» .

Пример настройки

Начните с определения данных изображения, которые будут экспортироваться:

Редактор кода (JavaScript)

// Load a landsat image and select three bands.
var landsat = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_123032_20140515')
  .select(['B4', 'B3', 'B2']);

// Create a geometry representing an export region.
var geometry = ee.Geometry.Rectangle([116.2621, 39.8412, 116.4849, 40.01236]);

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Load a landsat image and select three bands.
landsat = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_123032_20140515').select(
    ['B4', 'B3', 'B2']
)

# Create a geometry representing an export region.
geometry = ee.Geometry.Rectangle([116.2621, 39.8412, 116.4849, 40.01236])

Затем определите параметры проекции , которые будут использоваться при следующем экспорте. Мы используем параметр crs для указания системы координат и параметр crsTransform для точного указания сетки пикселей. Параметр crsTransform — это список параметров из матрицы аффинного преобразования в порядке строк [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation] . Происхождение изображения определяется значениями xTranslation и yTranslation , а размер пикселя изображения определяется значениями xScale и yScale . См . примеры аффинных матриц .

Редактор кода (JavaScript)

// Retrieve the projection information from a band of the original image.
// Call getInfo() on the projection to request a client-side object containing
// the crs and transform information needed for the client-side Export function.
var projection = landsat.select('B2').projection().getInfo();

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Retrieve the projection information from a band of the original image.
# Call getInfo() on the projection to request a client-side object containing
# the crs and transform information needed for the client-side Export function.
projection = landsat.select('B2').projection().getInfo()

Предупреждение: параметр scale может вводить в заблуждение. Если вы пытаетесь точно сопоставить существующую проекцию, вам не следует использовать scale — подробности см. в следующем разделе .

Настройка scale

В качестве ярлыка вы можете указать параметр scale , и Earth Engine рассчитает для вас параметр crsTransform . Однако простая установка масштаба изображения не определяет начало проекции и может привести к тому, что изображение будет сдвинуто относительно другого изображения с тем же размером пикселя!

Причина потенциального сдвига заключается в том, что параметр scale используется для заполнения значений xScale и yScale crsTransform , но значения xTranslation и yTranslation вычисляются так, что если они делятся на соответствующие значения xScale и yScale , остаток будет равен нулю. Эти параметры определяют пиксельную сетку, в которой начало проекции находится в углу пикселя. Это соглашение отличается от параметров перевода, используемых некоторыми поставщиками данных, которые используют сетки, смещенные от начала координат проекции. Например, изображения Landsat, предоставленные Геологической службой США, используют параметры перевода, которые смещены на 1/2 пикселя от начала координат проекции (смещение 15 м для 30-метровых диапазонов), тогда как изображения Sentinel-2, предоставленные ESA, используют параметры перевода, которые совмещены с началом координат проекции. Если crsTransform указанный при экспорте, не соответствует crsTransform исходного изображения, выходные пиксели будут повторно дискретизированы (по умолчанию с использованием ближайшего соседа), что приведет к смещению результирующего изображения относительно исходного изображения.

Подводя итог, если вам нужно сопоставить пиксели экспортированного изображения с конкретным изображением, обязательно используйте параметры crs и crsTransform для полного управления сеткой.

ездить

Чтобы экспортировать изображение в свою учетную запись Диска, используйте Export.image.toDrive() . Например, чтобы экспортировать части изображения Landsat, определите регион для экспорта, а затем вызовите Export.image.toDrive() :

Редактор кода (JavaScript)

// Export the image, specifying the CRS, transform, and region.
Export.image.toDrive({
  image: landsat,
  description: 'imageToDriveExample_transform',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry
});

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Export the image, specifying the CRS, transform, and region.
task = ee.batch.Export.image.toDrive(
    image=landsat,
    description='imageToDriveExample_transform',
    crs=projection['crs'],
    crsTransform=projection['transform'],
    region=geometry,
)
task.start()

При запуске этого кода на вкладке « Задачи редактора кода» будет создана задача экспорта. Нажмите кнопку «Выполнить» рядом с задачей, чтобы запустить ее. (Подробнее о Диспетчере задач можно узнать в разделе «Редактор кода» ). Изображение будет создано в вашей учетной записи Диска с указанным fileFormat .

в облачное хранилище

Чтобы экспортировать изображение в корзину Google Cloud Storage, используйте Export.image.toCloudStorage() . Чтобы экспортировать изображение Landsat из предыдущего примера в Cloud Storage вместо Drive, используйте:

Редактор кода (JavaScript)

// Export the image to Cloud Storage.
Export.image.toCloudStorage({
  image: landsat,
  description: 'imageToCloudExample',
  bucket: 'your-bucket-name',
  fileNamePrefix: 'exampleExport',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry
});

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Export the image to Cloud Storage.
task = ee.batch.Export.image.toCloudStorage(
    image=landsat,
    description='imageToCloudExample',
    bucket='your-bucket-name',
    fileNamePrefix='exampleExport',
    crs=projection['crs'],
    crsTransform=projection['transform'],
    region=geometry,
)
task.start()

Как и при экспорте на Диск, начните экспорт со вкладки «Задачи» . Расположение сегмента Cloud Storage может повлиять на производительность и затраты на хранилище. Дополнительные сведения см. в разделе часто задаваемых вопросов по вопросам расположения .

в актив

Чтобы экспортировать изображение в ресурс в папке ресурсов Earth Engine, используйте Export.image.toAsset() . Чтобы управлять ресурсами Earth Engine или проверять, какая часть квоты хранилища используется, используйте Asset Manager . Следующий пример иллюстрирует экспорт частей изображения Landsat с использованием разных политик построения пирамид для одного и того же канала. Политика построения пирамид указывает, как Earth Engine вычисляет версии актива с более низким разрешением. Узнайте больше о том, как Earth Engine обрабатывает несколько разрешений, в документе масштабирования .

Редактор кода (JavaScript)

// Get band 4 from the Landsat image, copy it.
var band4 = landsat.select('B4').rename('b4_mean')
  .addBands(landsat.select('B4').rename('b4_sample'))
  .addBands(landsat.select('B4').rename('b4_max'));

// Export the image to an Earth Engine asset.
Export.image.toAsset({
  image: band4,
  description: 'imageToAssetExample',
  assetId: 'exampleExport',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry,
  pyramidingPolicy: {
    'b4_mean': 'mean',
    'b4_sample': 'sample',
    'b4_max': 'max'
  }
});

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Get band 4 from the Landsat image, copy it.
band_4 = (
    landsat.select('B4')
    .rename('b4_mean')
    .addBands(landsat.select('B4').rename('b4_sample'))
    .addBands(landsat.select('B4').rename('b4_max'))
)

# Export the image to an Earth Engine asset.
task = ee.batch.Export.image.toAsset(
    image=band_4,
    description='imageToAssetExample',
    assetId='projects/your-project/assets/exampleExport',
    crs=projection['crs'],
    crsTransform=projection['transform'],
    region=geometry,
    pyramidingPolicy={
        'b4_mean': 'mean',
        'b4_sample': 'sample',
        'b4_max': 'max',
    },
)
task.start()

Вы можете предоставить политику построения пирамид по умолчанию для каждой полосы, которая не указана явно, используя ключ '.default' . Вы также можете передать только ключ '.default' . Например, чтобы по умолчанию использовать для всех диапазонов политику построения пирамиды «sample», используйте {'.default': 'sample'} .

Параметры конфигурации

Обратите внимание, что словарь параметров конфигурации, передаваемый в Export.image включает scale (в метрах) и регион экспорта в виде ee.Geometry . Экспортированное изображение покроет указанную область пикселями в указанном масштабе. Если не указано явно, CRS вывода будет взят из первого канала экспортируемого изображения.

Вы также можете указать dimensions , crs и/или crsTransform экспортируемого изображения. Дополнительную информацию о crs и crsTransform смотрите в глоссарии . Например, чтобы получить блок пикселей, точно выровненный по другому источнику данных, укажите dimensions , crs и crsTransform . Чтобы получить блок пикселей предопределенного размера (например, миниатюрное изображение 256x256), охватывающий регион, укажите dimensions и region .

Вы можете указать формат вывода изображения (если назначением не является toAsset() ) с помощью параметра fileFormat (по умолчанию 'GeoTIFF' ).

Параметр formatOptions

Другие параметры конфигурации задаются с помощью параметра formatOptions , который должен представлять собой словарь с другими параметрами формата, специфичными для каждого fileFormat как описано ниже.

ГеоTIFF

Оптимизированный для облака GeoTIFF

Чтобы экспортировать оптимизированный для облака GeoTIFF , передайте литерал JavaScript для formatOptions , в котором для ключа cloudOptimized установлено значение true . Продолжая предыдущий пример:

Редактор кода (JavaScript)

// Export a cloud-optimized GeoTIFF.
Export.image.toDrive({
  image: landsat,
  description: 'imageToCOGeoTiffExample',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry,
  fileFormat: 'GeoTIFF',
  formatOptions: {
    cloudOptimized: true
  }
});

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Export a cloud-optimized GeoTIFF.
task = ee.batch.Export.image.toDrive(
    image=landsat,
    description='imageToCOGeoTiffExample',
    crs=projection['crs'],
    crsTransform=projection['transform'],
    region=geometry,
    fileFormat='GeoTIFF',
    formatOptions={'cloudOptimized': True},
)
task.start()

Оптимизированные для облака файлы GeoTIFF можно перезагрузить из облачного хранилища в Image . Подробности смотрите в документации по обзору Image .

Нодата

Укажите значение nodata GeoTIFF, используя ключ noData в параметре formatOptions . Например:

Редактор кода (JavaScript)

// Set a nodata value and replace masked pixels around the image edge with it.
var noDataVal = -9999;
landsat = landsat.unmask(noDataVal);

Export.image.toDrive({
  image: landsat,
  description: 'imageNoDataExample',
  crs: projection.crs,
  scale: 2000,  // large scale for minimal demo
  region: landsat.geometry(),  // full image bounds
  fileFormat: 'GeoTIFF',
  formatOptions: {
    noData: noDataVal,
  }
});

Настройка Python

См. страницу «Среда Python» для получения информации об API Python и использовании geemap для интерактивной разработки.

import ee
import geemap.core as geemap

Колаб (Питон)

# Set a nodata value and replace masked pixels around the image edge with it.
no_data_val = -9999
landsat = landsat.unmask(no_data_val)

task = ee.batch.Export.image.toDrive(
    image=landsat,
    description='imageNoDataExample',
    crs=projection['crs'],
    scale=2000,  # large scale for minimal demo
    region=landsat.geometry(),  # full image bounds
    fileFormat='GeoTIFF',
    formatOptions={'noData': no_data_val},
)
task.start()

Обратите внимание, что значение nodata должно находиться в допустимом диапазоне для PixelType изображения. Вы можете проверить PixelType , распечатав метаданные изображения и просмотрев свойство data_type первой полосы. Вы также можете установить PixelType изображения, приведя данные к определенному типу, например, с помощью методов изображения toShort() или toInt() .

TFRecord

См. страницу формата данных TFRecord .

maxPixels

Параметр maxPixels предназначен для предотвращения непреднамеренного создания очень больших экспортных файлов. Если значение по умолчанию слишком низкое для предполагаемого выходного изображения, вы можете увеличить maxPixels . Например:

Export.image.toDrive({
  image: landsat,
  description: 'maxPixelsExample',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry,
  maxPixels: 1e9
});

Экспорт больших файлов

Если выходное изображение большое, оно будет экспортировано в виде нескольких файлов. Если вы экспортируете в формат GeoTIFF, изображение разбивается на фрагменты. Имя файла каждой плитки будет иметь вид baseFilename-yMin-xMin , где xMin и yMin — это координаты каждой плитки в общей ограничивающей рамке экспортированного изображения.

Если вы экспортируете в TFRecord, к файлам будут добавлены значения -00000 , -00001 ,... -0000N для файлов N+1 . Соблюдение этого порядка важно, если вы собираетесь выполнить логические выводы на основе файлов и загрузить прогнозы обратно в Earth Engine в виде изображения. Подробности см. в разделе «Загрузка изображений в виде файлов TFRecord» .

Экспорт изображений в том виде, в каком они появляются в редакторе кода.

Чтобы экспортировать изображения, отображаемые на экране в Earth Engine, создайте изображения визуализации, как показано в разделах «Визуализация изображений» и «Композитинг» и «Мозаика» . Поскольку редактор кода использует CRS 'EPSG:3857' , укажите CRS 'EPSG:3857' при экспорте, чтобы получить изображение в той же проекции, которая отображается на карте редактора кода. Подробную информацию об указании разрешения и системы координат вывода см. в разделе «Настройка экспорта изображений» .