يمكنك تصدير الصور من 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]);
import ee import geemap.core as geemap
Colab (Python)
# 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();
import ee import geemap.core as geemap
Colab (Python)
# 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 وسيحسب محرّك Earth Engine مَعلمة crsTransform نيابةً عنك. ومع ذلك، فإنّ مجرد ضبط مقياس الصورة لا يحدّد مصدر الإسقاط، وقد يؤدي إلى صورة تم نقلها بالنسبة إلى صورة أخرى بحجم البكسل نفسه.
يرجع سبب التغيير المحتمل إلى استخدام المَعلمة scale لتعبئة قيمتَي xScale وyScale في crsTransform، ولكن يتم احتساب قيمتَي xTranslation وyTranslation بحيث يكون الباقي صفرًا إذا تم قسمتهما على قيمتَي xScale وyScale المقابلتين. تحدّد هذه المَعلمات شبكة بكسل يكون فيها أصل الإسقاط في زاوية البكسل. تختلف هذه الطريقة عن مَعلمات الترجمة التي يستخدمها بعض مزوّدي البيانات، والتي تستخدم شبكات يتم إزاحتها عن نقطة الأصل في الإسقاط. على سبيل المثال، تستخدم صور Landsat التي توفّرها هيئة المسح الجيولوجي الأمريكية (USGS) مَعلمات نقل يتم إزاحتها بمقدار نصف بكسل من نقطة بداية الإسقاط (إزاحة بمقدار 15 مترًا للنطاقات التي يبلغ طولها 30 مترًا)، بينما تستخدم صور Sentinel-2 التي توفّرها وكالة الفضاء الأوروبية (ESA) مَعلمات نقل تتم محاذاتها مع نقطة بداية الإسقاط. إذا لم تتطابق crsTransform المحدّدة في عملية التصدير مع crsTransform الصورة الأصلية، ستتم إعادة تجميع وحدات البكسل الناتجة (باستخدام أقرب جار تلقائيًا)، ما سيؤدي إلى إزاحة الصورة الناتجة مقارنةً بالصورة الأصلية.
باختصار، إذا كنت بحاجة إلى مطابقة وحدات بكسل الصورة المصدَّرة مع صورة معيّنة، تأكَّد من استخدام المَعلمتَين crs وcrsTransform للتحكّم الكامل في الشبكة.
إلى Drive
لتصدير صورة إلى حسابك على Drive، استخدِم 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 });
import ee import geemap.core as geemap
Colab (Python)
# 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()
عند تشغيل هذا الرمز، سيتم إنشاء مهمة تصدير في علامة التبويب المهام في "أداة تعديل الرموز". انقر على الزر تشغيل بجانب المهمة لبدء تشغيلها. (يمكنك الاطّلاع على مزيد من المعلومات حول "مدير المهام" في قسم "أداة تعديل الرموز"). سيتم إنشاء الصورة في حسابك على Drive
باستخدام fileFormat المحدّد.
في Cloud Storage
لتصدير صورة إلى حزمة 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 });
import ee import geemap.core as geemap
Colab (Python)
# 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()
كما هو الحال مع عمليات التصدير إلى Drive، ابدأ عملية التصدير من علامة التبويب المهام. إذا كنت تخطّط لقراءة الملفات التي تم تصديرها مرة أخرى في Earth Engine (باستخدام ee.Image.loadGeoTIFF() أو من خلال تسجيلها كمواد عرض مستندة إلى COG)، يجب أن يكون المستودع في موقع جغرافي متوافق.
إلى مادة العرض
لتصدير صورة إلى مادة عرض في مجلد مواد عرض Earth Engine، استخدِم
Export.image.toAsset(). لإدارة مواد عرض Earth Engine أو التحقّق من مقدار
مساحة التخزين المتوفّرة المستخدَمة، يمكنك استخدام مدير مواد العرض. يوضّح المثال التالي تصدير أجزاء من صورة 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' } });
import ee import geemap.core as geemap
Colab (Python)
# 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. ستغطي الصورة التي تم تصديرها المنطقة المحددة بوحدات بكسل بالمقياس المحدد. في حال عدم تحديد نظام الإحداثيات المرجعي بشكل صريح، سيتم الحصول عليه من النطاق الأول للصورة المطلوب تصديرها.
يمكنك أيضًا تحديد dimensions و/أو crs و/أو crsTransform للصورة المصدَّرة. يمكنك الاطّلاع على المسرد لمزيد من المعلومات حول crs وcrsTransform. على سبيل المثال، للحصول على مجموعة من وحدات البكسل التي تمت محاذاتها بدقة مع مصدر بيانات آخر، حدِّد dimensions وcrs وcrsTransform.
للحصول على مجموعة من وحدات البكسل بحجم محدّد مسبقًا (على سبيل المثال، صورة مصغّرة بحجم 256×256 بكسل) تغطي منطقة معيّنة، حدِّد dimensions وregion.
يمكنك تحديد تنسيق إخراج الصورة (إذا لم تكن الوجهة toAsset()) باستخدام المَعلمة fileFormat ('GeoTIFF' تلقائيًا).
مَعلمة formatOptions
يتم ضبط خيارات الإعداد الأخرى باستخدام المَعلمة formatOptions، والتي
يجب أن تكون قاموسًا يتم إدخاله بواسطة خيارات تنسيق أخرى، خاصة بكل
fileFormat كما هو موضّح أدناه.
GeoTIFF
Cloud Optimized GeoTIFF (COG)
لتصدير ملف GeoTIFF محسَّن للسحابة الإلكترونية (COG)، اضبط مفتاح cloudOptimized على صحيح في formatOptions. استمرارًا للمثال السابق:
أداة تعديل الرموز (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 } });
import ee import geemap.core as geemap
Colab (Python)
# 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()
يمكن إعادة تحميل ملفات COG من Cloud Storage إلى Image أو تسجيلها كأصول. يمكنك الاطّلاع على
نظرة عامة على COG
لمعرفة مواصفات وخيارات التصدير الكاملة.
Nodata
حدِّد قيمة 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, } });
import ee import geemap.core as geemap
Colab (Python)
# 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، يمكنك إنشاء صور مرئية كما هو موضّح في قسمَي الصور المرئية والتركيب والفسيفساء. بما أنّ "أداة تعديل الرموز" تستخدم نظام الإحداثيات المرجعي 'EPSG:3857'، يجب تحديد نظام الإحداثيات المرجعي 'EPSG:3857' في عملية التصدير للحصول على صورة في الإسقاط نفسه المعروض في خريطة "أداة تعديل الرموز". يُرجى الاطّلاع على القسم المتعلّق بضبط عمليات تصدير الصور للحصول على تفاصيل حول تحديد درجة الدقة ونظام الإحداثيات للناتج.