التوقعات

تم تصميم Earth Engine بحيث لا تقلق بشأن إسقاطات الخرائط عند إجراء العمليات الحسابية. كما هو الحال مع المقياس، يتم تحديد الإسقاط الذي تتم فيه العمليات الحسابية على أساس "السحب". على وجه التحديد، يتم طلب المدخلات في إسقاط المخرجات. يمكن تحديد الناتج من مَعلمة دالة (مثل crs) أو من عناصر الخريطة في "أداة تعديل الرموز" وgeemap (التي تستخدم إسقاط ميركاتور (EPSG:3857)) أو من خلال طلب reproject(). عند عرض الصور في "أداة تعديل الرموز" أو geemap، يتم طلب المدخلات في إسقاط مركاتور للخرائط. لنفترض أنّنا نريد إجراء العملية التالية على صورة MODIS التي تستخدم إسقاطًا جيبيًا:

أداة تعديل الرموز (JavaScript)

// The input image has a SR-ORG:6974 (sinusoidal) projection.
var image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0);

// Normalize the image and add it to the map.
var rescaled = image.unitScale(-2000, 10000);
var visParams = {min: 0.15, max: 0.7};
Map.addLayer(rescaled, visParams, 'Rescaled');

إعداد Python

يُرجى الاطّلاع على صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

# The input image has a SR-ORG:6974 (sinusoidal) projection.
image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0)

# Normalize the image and add it to the map.
rescaled = image.unitScale(-2000, 10000)
vis_params = {'min': 0.15, 'max': 0.7}
m = geemap.Map()
m.add_layer(rescaled, vis_params, 'Rescaled')
m

يتم توضيح ترتيب العمليات لعينة التعليمات البرمجية هذه في الشكل 1. يُرجى العِلم أنّ إسقاط الإدخال يتم تحديده من خلال الإخراج، وتحديدًا إسقاط مركاتور للخرائط لعرض الخريطة في "أداة تعديل الرموز". ينتشر هذا الإسقاط مرة أخرى من خلال تسلسل العمليات بحيث يتم طلب المدخلات في إسقاط مركاتور، بمقياس يحدده مستوى التكبير في الخريطة.

projection
الشكل 1: مخطط انسيابي للعمليات المقابلة لعرض صورة MODIS في خريطة "أداة تعديل الرموز". يتم تحديد الإسقاطات (الجانب الأيمن من المخطط الانسيابي) لكل عملية من المخرجات. تشير الخطوط المنحنية إلى تدفق المعلومات إلى إعادة الإسقاط: على وجه التحديد، إسقاط الإخراج والمقياس.

في Earth Engine، يتم تحديد المساقط من خلال نظام مرجعي للإحداثيات (CRS أو مَعلمة crs للعديد من الطرق). يمكنك التحقّق من إسقاط صورة من خلال استدعاء projection() عليها:

أداة تعديل الرموز (JavaScript)

var image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318').select(0);
print('Projection, crs, and crs_transform:', image.projection());
print('Scale in meters:', image.projection().nominalScale());

إعداد Python

يُرجى الاطّلاع على صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318').select(0)
display('Projection, crs, and crs_transform:', image.projection())
display('Scale in meters:', image.projection().nominalScale())

يُرجى العِلم أنّه من خلال استدعاء nominalScale() في ee.Projection الذي تم عرضه بواسطة projection()، يمكنك تحديد درجة الدقة الأصلية للصورة. الدقة الأصلية هي مقياس البكسل الاسمي بالأمتار لأدنى مستوى من هرم الصور. بما أنّ كل نطاق في الصورة يمكن أن يكون له مقياس و/أو إسقاط مختلف، إذا طلبت projection() على صورة تتضمّن نطاقًا واحدًا على الأقل لا يتضمّن الإسقاط نفسه مثل النطاقات الأخرى، قد يظهر لك خطأ مثل:

الإسقاط التلقائي

ما لم تكن بحاجة إلى إجراء العمليات الحسابية في إسقاط معيّن، ليس من الضروري بشكل عام تحديد إسقاط. ولن يطلب منك Earth Engine تحديد إسقاط و/أو مقياس إلا في حال كان الناتج غامضًا. قد ينشأ الالتباس عن تقليل ImageCollection يحتوي على صور بإسقاطات مختلفة (أي إنشاء صورة مركّبة). ستكون الصورة التي تمثّل مركّبًا أو فسيفساء من صور الإدخال ذات الإسقاطات المختلفة ذات الإسقاط التلقائي، وهو WGS84 بمقياس درجة واحدة. إذا لم يكن هذا الإسقاط التلقائي مناسبًا لتحليلك (على سبيل المثال، إذا كان غير دقيق أو إذا كنت بحاجة إلى منع حدوث تشوهات في إعادة أخذ العينات في العمليات الحسابية اللاحقة مثل تحليل التضاريس)، يمكنك ضبط إسقاط تلقائي مختلف باستخدام image.setDefaultProjection(crs). يضمن ذلك أنّه إذا احتاجت منصة Earth Engine إلى اختيار إسقاط لعملية حسابية تتضمّن الصورة، ستستخدم الإسقاط المحدّد بدلاً من WGS84 بمقياس درجة واحدة. على سبيل المثال:

أداة تعديل الرموز (JavaScript)

var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA');
var mosaic = collection.filterDate('2018-01-01', '2019-01-01').mosaic();
print(mosaic.projection());

إعداد Python

يُرجى الاطّلاع على صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')
mosaic = collection.filterDate('2018-01-01', '2019-01-01').mosaic()
display(mosaic.projection())

إذا حاولت استخدام صورة كهذه في عملية حسابية، قد تظهر لك رسالة خطأ مثل:

بشكل عام، لا يكون التجميع على مقياس درجة واحدة مطلوبًا أو مقصودًا، لذا يقدّم Earth Engine هذا التذكير الودّي لتوفير مواصفات كاملة للناتج.

غالبًا ما يجد المستخدمون هذا السلوك مربكًا ويقلقون بشأن معلومات الإسقاط "المفقودة"، ولكن لا يتم احتساب وحدات البكسل فعليًا إلا عند الحاجة إليها (مزيد من المعلومات)، وفي هذه المرحلة، يتوفّر دائمًا إسقاط ناتج مصاحب للطلب الذي يحدّد كيفية احتساب المركّب.

في الغالبية العظمى من حالات الاستخدام، لا يمثّل عدم توفّر إسقاط مشكلة، بل هو في الواقع تحسين قيّم، لأنّه يسمح بمعاينة النتائج بأي مستوى تكبير بدون الحاجة إلى انتظار اكتمال عملية حساب الدقة الكاملة. ولكن هذا يعني أنّ النتيجة قد تظهر بشكل مختلف في مستويات التكبير المختلفة.

إذا لم تكن الصورة المعروضة المحسّنة كافية لسبب ما، يمكن فرض عملية الحساب في إسقاط معيّن من خلال إعادة إسقاط الناتج كما هو موضّح في القسم التالي.

إعادة الإسقاط

يمكنك فرض تنفيذ العمليات في إسقاط معيّن باستخدام طريقة reproject(). يؤدي استخدام reproject() إلى طلب المدخلات في الإسقاط المحدّد في طلب reproject(). سيتم إجراء العمليات الحسابية في الرمز البرمجي قبل استدعاء reproject() في الإسقاط المحدّد. على سبيل المثال، لفرض إنتاج صورة مركّبة في إسقاط معيّن:

أداة تعديل الرموز (JavaScript)

// Some projection that is suitable for your area of interest.
var proj = ee.Projection(...);
var output = collection.reduce(...).reproject(proj);

إعداد Python

يُرجى الاطّلاع على صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

# Some projection that is suitable for your area of interest.
proj = ee.Projection(...)
output = collection.reduce(...).reproject(proj)

في ما يلي بعض الحالات التي تتطلّب إسقاطًا ثابتًا:

تحسب الدوال في حزمة ee.Terrain (مثل slope وaspect وhillshade) القيم استنادًا إلى وحدات البكسل المجاورة، وتتأثر بالتشوهات الناتجة عن إعادة أخذ العينات أثناء إعادة الإسقاط. عندما يختلف إسقاط الحساب عن الإسقاط الأصلي لنموذج الارتفاع الرقمي، يمكن أن تؤدي إعادة أخذ العينات التلقائية من أقرب جار إلى إنشاء أنماط اصطناعية في الناتج. للحصول على أفضل النتائج، يمكنك إجراء تحليل للتضاريس في الإسقاط الأصلي لنموذج الارتفاع الرقمي. في حال العمل مع ImageCollection من مربّعات DEM، أنشِئ فسيفساء واستخدِم setDefaultProjection() مع الإسقاط الأصلي للمجموعة لضمان إجراء التحليل على الشبكة الصحيحة، كما هو موضّح في قسم الإسقاط التلقائي.

هناك عدة أسباب تدفعك إلى تجنُّب استخدام reproject() ما لم تكن بحاجة ماسة إلى ذلك. لنفترض مثلاً أنّك أعدت إسقاط عنصر وأضفته إلى الخريطة. إذا كان المقياس الذي حدّدته في طلب reproject() أصغر بكثير من مستوى تكبير الخريطة، سيطلب محرّك Earth Engine جميع المدخلات بمقياس صغير جدًا على نطاق مكاني واسع جدًا. قد يؤدي ذلك إلى طلب كمية كبيرة جدًا من البيانات في آنٍ واحد، ما يتسبب في حدوث خطأ.

إذا كان الناتج النهائي في إسقاط مختلف عن الإسقاط المحدّد في طلب reproject()، سيؤدي ذلك إلى إعادة إسقاط آخر. وهذا سبب آخر يدعو إلى توخي الحذر بشأن استخدام reproject() في الرمز البرمجي. لنفترض المثال التالي الذي يفرض إعادة إسقاط صورة MODIS أولاً إلى WGS84، ثم إعادة إسقاطها إلى maps mercator لعرضها في خريطة "أداة تعديل الرموز":

أداة تعديل الرموز (JavaScript)

// The input image has a SR-ORG:6974 (sinusoidal) projection.
var image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0);

// Operations *before* the reproject call will be done in the projection
// specified by reproject().  The output results in another reprojection.
var reprojected = image
    .unitScale(-2000, 10000)
    .reproject('EPSG:4326', null, 500);
Map.addLayer(reprojected, {min: 0.15, max: 0.7}, 'Reprojected');

إعداد Python

يُرجى الاطّلاع على صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

# The input image has a SR-ORG:6974 (sinusoidal) projection.
image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0)

# Operations *before* the reproject call will be done in the projection
# specified by reproject(). The output results in another reprojection.
reprojected = image.unitScale(-2000, 10000).reproject('EPSG:4326', None, 500)
m = geemap.Map()
m.add_layer(reprojected, {'min': 0.15, 'max': 0.7}, 'Reprojected')
m

يوضّح الشكل 2 مخطّطًا بيانيًا لتدفق العمليات المقابلة لمثال إعادة الإسقاط البسيط هذا. يُرجى العِلم أنّ إعادة الإسقاط الأولى تكون صريحة، كما هو محدّد في استدعاء reproject(). تكون عملية إعادة الإسقاط الثانية ضمنية، ويتم تنفيذها بواسطة Earth Engine تلقائيًا لعرض النتيجة على الخريطة. لاحظ أيضًا أنّ المعلومات حول العرض الذي يجب استخدامه تنتقل من الطلب إلى الإدخال.

إعادة الإسقاط
الشكل 2: مخطّط انسيابي للعمليات المقابلة لإعادة إسقاط صورة MODIS في خريطة "أداة تعديل الرموز". تشير الخطوط المنحنية إلى تدفق المعلومات إلى عمليات إعادة الإسقاط: على وجه التحديد، إسقاط الإخراج والمقياس.