يهدف دليل البدء هذا إلى توفير طريقة سريعة لبدء البرمجة باستخدام واجهة برمجة التطبيقات JavaScript في Earth Engine. للحصول على نظرة تمهيدية على JavaScript وتمارين أكثر تفصيلاً باستخدام واجهة برمجة تطبيقات Earth Engine، يُرجى الاطّلاع على البرامج التعليمية. للاطّلاع على أسلوب ترميز JavaScript المقترَح، يُرجى مراجعة دليل أسلوب JavaScript من Google.
تتيح منصة Google Earth Engine للمستخدمين تشغيل الخوارزميات على الصور والمتجهات ذات الإسناد الجغرافي المخزّنة على بنية Google الأساسية. توفّر واجهة برمجة التطبيقات Google Earth Engine مكتبة من الدوال التي يمكن تطبيقها على البيانات لعرضها وتحليلها. يحتوي كتالوج البيانات العامة في Earth Engine على كمية كبيرة من مجموعات البيانات المتّجهة والصور المتاحة للجميع. ويمكن أيضًا إنشاء مواد عرض خاصة في مجلدات المستخدمين الشخصية.
كيفية استخدام هذه المستندات
تم تصميم مستندات Earth Engine للأشخاص الذين لديهم معرفة بتحليل البيانات الجغرافية المكانية. يتم تنظيم المستندات بشكل أساسي حسب نوع البيانات. على سبيل المثال، تحتوي لوحة التنقّل على يمين الصفحة على روابط تؤدي إلى أقسام أو صفحات حول أنواع البيانات المهمة، مثل Image وImageCollection وFeature وFeatureCollection وGeometry وReducer وChart وJoin وArray. ويصف هذا الدليل ما يكفي فقط
عن هذه الأنواع لمساعدتك في البدء. هناك أيضًا أقسام مخصّصة لتعلُّم الآلة والخوارزميات المتخصّصة أو الخاصة بأجهزة الاستشعار (مثل خوارزميات Landsat) والتطبيقات المتاحة للجميع وإدارة البيانات (مواد العرض) وتفاصيل مهمة حول آلية عمل Earth Engine الداخلية.
قبل التعمّق في أي من ذلك، ابدأ من هنا.
أداة تعديل الرموز
"أداة تعديل الرموز" هي بيئة تفاعلية لتطوير تطبيقات Earth Engine (الشكل 1). توفّر اللوحة المركزية أداة تعديل رموز JavaScript. تظهر فوق المحرّر أزرار لحفظ النص البرمجي الحالي وتشغيله ومحو الخريطة. يؤدي النقر على الزر الحصول على الرابط إلى إنشاء عنوان URL فريد للنص البرمجي في شريط العناوين. تحتوي الخريطة في اللوحة السفلية على الطبقات التي أضافها النص البرمجي. في أعلى الصفحة، يظهر مربّع بحث عن مجموعات البيانات والأماكن. تحتوي اللوحة اليمنى على أمثلة على الرموز البرمجية والنصوص البرمجية المحفوظة ومرجع واجهة برمجة التطبيقات القابل للبحث ومدير مواد العرض للبيانات الخاصة. وتتضمّن اللوحة اليسرى أداة فحص للاستعلام عن الخريطة، ووحدة تحكّم في النتائج، ومديرًا للمهام الطويلة الأمد. يحتوي زر المساعدة في أعلى يسار الصفحة على روابط تؤدي إلى هذا الدليل ومراجع أخرى للحصول على المساعدة. يمكنك الاطّلاع على مزيد من المعلومات في دليل "أداة تعديل الرموز" ودليل المساعدة.
فتح الرمز البرمجي وتشغيله في "أداة تعديل الرموز"
توضّح الخطوات أدناه كيفية فتح Earth Engine وتنفيذ نص برمجي مخصّص يعرض صورة. للحصول على أفضل النتائج، ننصحك بتثبيت أحدث إصدار من Chrome، وهو متصفّح الويب من Google، والمتوفّر هنا.
- افتح "أداة تعديل الرموز" في Earth Engine من خلال الرابط: code.earthengine.google.com.
- انتقِل إلى علامة التبويب النصوص البرمجية في أقصى يمين "أداة تعديل الرموز". ستجد هناك مجموعة من نماذج النصوص البرمجية التي تتيح الوصول إلى بيانات Earth Engine وعرضها وتحليلها.
- ضمن "مجموعة الصور"، اختَر مثال "المركّب الذي تمّت فلترته". سيظهر نص برمجي في وحدة التحكّم المركزية. اضغط على الزر تشغيل لتنفيذ النص البرمجي. يختار مثال "المركّب المفلتر" صور Landsat 7 التي تتقاطع مع حدود كولورادو ويوتا أو تقع ضمنها. بعد ذلك، يعرض مركّبًا بالألوان الحقيقية للصور المحدّدة. تُعرّفك النماذج على الطرق الشائعة الاستخدام، مثل
filter()وclip()وMap.addLayer().
بُنى بيانات Earth Engine
إنّ بنيتَي البيانات الجغرافية الأكثر أساسية في Earth Engine هما
Image و
Feature، وهما يتوافقان مع نوعَي البيانات
النقطية والمتّجهة على التوالي. تتألف الصور من نطاقات وقاموس من السمات.
تتكوّن العناصر من Geometry وقاموس للسمات. يتم التعامل مع مجموعة من الصور (مثل سلسلة زمنية للصور) من خلال
ImageCollection. تتم معالجة مجموعة من الميزات من خلال FeatureCollection. تشمل هياكل البيانات الأساسية الأخرى في Earth Engine كلاً من Dictionary وList وArray وDate وNumber وString (يمكنك الاطّلاع على مزيد من المعلومات حول أنواع البيانات الأساسية من خلال هذا الدليل التعليمي). من المهمّ تذكُّر أنّ هذه كلها كائنات من جهة الخادم ولا يتم التلاعب بها بالطريقة نفسها التي يتم بها التلاعب بكائنات JavaScript من جهة العميل (مزيد من المعلومات).
خوارزميات Earth Engine
هناك عدة طرق لتنفيذ العمليات في واجهة برمجة التطبيقات:
- استدعاء الطرق المرتبطة بالكائنات.
- خوارزميات الاتصال:
- استدعاء دوال خاصة بـ "أداة تعديل الرموز"
- تحديد دوال جديدة
تعرض علامة التبويب المستندات في "أداة تعديل الرموز" طُرق كل فئة من فئات واجهة برمجة التطبيقات. على سبيل المثال، تتضمّن الفئة Image الطريقة add():
أداة تعديل الرموز (JavaScript)
var image3 = image1.add(image2);
تضيف هذه الطريقة نطاقات image2 إلى نطاقات image1.
تحتوي الفئة ee.Algorithms على قائمة بالخوارزميات المتوافقة حاليًا
للمعالجة المتخصصة أو الخاصة بالنطاق. على سبيل المثال، لإنشاء طبقات طبوغرافية من نموذج ارتفاع رقمي (DEM) مُدخل:
أداة تعديل الرموز (JavaScript)
var terrainImage = ee.Algorithms.Terrain(dem);
تشمل الدوال الخاصة بـ "أداة تعديل الرموز" الطريقتَين Map وExport اللتَين تتحكّمان في كيفية إضافة الطبقات إلى لوحة الخريطة أو تصديرها إلى Google Drive على التوالي. يمكن أيضًا إنشاء الدوال في JavaScript باستخدام
أداة تعديل الرموز (JavaScript)
var myFunction = function(args) { // do something return something; };
كما هو موضّح في قسم الخريطة، تكون الدوال التي يحدّدها المستخدم مفيدة لإنشاء وظائف مخصّصة أو تعديل عناصر مجموعة باستخدام:
أداة تعديل الرموز (JavaScript)
var collection2 = collection1.map(aFunction);
توضّح الأقسام التالية هذه المفاهيم لحالات استخدام بسيطة ومتنوعة.
'Hello world!' JavaScript
تُعدّ طباعة المعلومات في وحدة التحكّم مهمة أساسية للحصول على معلومات حول عنصر معيّن أو عرض النتيجة الرقمية لعملية حسابية أو عرض البيانات الوصفية للعنصر أو المساعدة في تصحيح الأخطاء. مثال "Hello World!" الشهير في "أداة تعديل الرموز" هو:
أداة تعديل الرموز (JavaScript)
print('Hello world!');
انسخ هذا السطر إلى أداة تعديل الرموز وانقر على تشغيل. يُرجى العِلم أنّ الناتج يظهر في علامة التبويب وحدة التحكّم على يسار "أداة تعديل الرموز". For a more remote sensing relevant example, the following prints the metadata of a Landsat 8 image:
أداة تعديل الرموز (JavaScript)
print(ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318'));
افحص الناتج في وحدة التحكّم بعناية للاطّلاع على البيانات الوصفية المتاحة لصور Landsat.
إضافة بيانات إلى الخريطة
بالإضافة إلى طباعة المعلومات في وحدة التحكّم، تُعدّ إضافة البيانات إلى Map
الطريقة المناسبة لعرض البيانات الجغرافية. استخدِم Map.addLayer() لإجراء ذلك. في المثال التالي، يتم إنشاء مثيل Image (سيتم شرح كيفية العثور على هذه الصور لاحقًا) باستخدام ee.Image()، وتتم إضافته إلى الخريطة باستخدام Map.addLayer()، ويتم توسيط الخريطة فوق الصورة:
أداة تعديل الرموز (JavaScript)
// Load an image. var image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318'); // Center the map on the image. Map.centerObject(image, 9); // Display the image. Map.addLayer(image);
المَعلمة الثانية في Map.centerObject() هي مستوى التكبير، حيث تشير الأرقام الأعلى إلى مقياس أكبر (تكبير أكثر). يتم شرح مَعلمات دوال Map بالتفصيل في مرجع واجهة برمجة التطبيقات الذي يمكن الوصول إليه من علامة التبويب المستندات. إذا لم يكن مظهر الصورة مرضيًا، يمكنك ضبط مَعلمات العرض باستخدام وسيطة إضافية في Map.addLayer(). على سبيل
المثال:
أداة تعديل الرموز (JavaScript)
// Load the image from the archive. var image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318'); // Define visualization parameters in an object literal. var vizParams = {bands: ['B5', 'B4', 'B3'], min: 0.02, max: 0.4, gamma: 1.3}; // Center the map on the image and display. Map.centerObject(image, 9); Map.addLayer(image, vizParams, 'Landsat 8 false color');
يُرجى ملاحظة أنّ مَعلمات العرض يتم تحديدها من خلال كائن حرفي يتضمّن قائمة بالنطاقات المطلوب عرضها، والحدّ الأدنى والأقصى لقيمة الانعكاس، وقيمة غاما. (يمكنك الاطّلاع على مزيد من المعلومات حول نطاقات Landsat هنا. يمكنك الاطّلاع على مزيد من المعلومات حول عرض الصور هنا.
استخدِم Map.addLayer() لإضافة عناصر ومجموعات عناصر إلى الخريطة. على سبيل المثال،
أداة تعديل الرموز (JavaScript)
var counties = ee.FeatureCollection('TIGER/2018/Counties'); Map.addLayer(counties, {}, 'counties');
العثور على الصور ومجموعات الصور ومجموعات الميزات
يمكن العثور على الصور ومجموعات الصور ومجموعات العناصر من خلال البحث في "كتالوج بيانات Earth Engine". على سبيل المثال، يؤدي إدخال "Landsat 8" في حقل البحث إلى عرض قائمة بمجموعات البيانات النقطية. (يمكنك الاطّلاع على القائمة الكاملة لمجموعات بيانات Earth Engine في كتالوج بيانات Earth Engine). انقر على اسم مجموعة البيانات للحصول على وصف موجز ومعلومات حول مدى توفّرها الزمني ومقدّم البيانات ومعرّف المجموعة. انقر على الزر استيراد لإنشاء قسم عمليات الاستيراد تلقائيًا في أعلى النص البرمجي باستخدام متغيّر لهذه المجموعة.
بدلاً من ذلك، يمكنك نسخ معرّف المجموعة ولصقه في الرمز البرمجي. على سبيل المثال، اختَر نتيجة Tier 1 TOA من بحث "Landsat 8" وانسخ المعرّف على النحو التالي:
أداة تعديل الرموز (JavaScript)
var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA');
بما أنّ هذه مجموعة من الصور المتعددة التي تغطي سطح الأرض، فإن العثور على صورة فردية في المجموعة يتطلب فلترة لتضييق نطاق البحث. ويمكن بدلاً من ذلك تقليل مجموعة الصور إلى صورة واحدة باستخدام تقنيات التركيب والفسيفساء. يمكنك الاطّلاع على مزيد من المعلومات حول الفلترة والتركيب (راجِع التقليل) في الأقسام التالية.
تتوفّر مجموعات العناصر أيضًا من خلال "قائمة البيانات". تمثيلها أصغر من مجموعات الصور، ولكن ستجد حدودًا دولية وحدودًا للتعداد السكاني ومستجمعات المياه والمناطق المحمية، على سبيل المثال لا الحصر. يمكنك الاطّلاع على مزيد من المعلومات حول استيراد مجموعات بيانات المتّجهات الخاصة بك هنا.
الفلترة والترتيب
غالبًا ما يكون من الضروري فلترة مجموعة حسب المساحة و/أو الوقت من أجل الحدّ من عدد النتائج. على سبيل المثال، لنفترض أنّك تريد ترتيب مجموعة صور Landsat 8
للعثور على صورة خالية من السُحب لمدينة بيروت. أولاً، من الضروري تحديد المنطقة محل الاهتمام. غالبًا ما تكون النقطة مفيدة لذلك. فعِّل علامة التبويب Inspector على الجانب الأيسر من "أداة تعديل الرموز" وانقر بالقرب من منتصف المنطقة التي تهمّك، ثم انسخ الإحداثيات من علامة التبويب Inspector، ثم أنشئ Point باستخدام:
أداة تعديل الرموز (JavaScript)
var point = ee.Geometry.Point(-122.262, 37.8719);
تاريخا البدء والانتهاء:
أداة تعديل الرموز (JavaScript)
var start = ee.Date('2014-06-01'); var finish = ee.Date('2014-10-01');
فلترة مجموعة Landsat 8 باستخدام النقطة والتواريخ، ثم الفرز باستخدام خاصية البيانات الوصفية (التي تم اكتشافها أثناء فحص البيانات الوصفية لمشهد Landsat 8):
أداة تعديل الرموز (JavaScript)
var filteredCollection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA') .filterBounds(point) .filterDate(start, finish) .sort('CLOUD_COVER', true);
يمكن طباعة هذه المجموعة وفحصها بأمان. (إذا كانت المجموعة تحتوي على عدد كبير جدًا من الصور، ستكون عملية طباعتها بطيئة جدًا أو ستنتهي مهلتها أو ستؤدي إلى ظهور خطأ). لاحظ أنّ الصور في المجموعة هي List مخزّنة في السمة "features" في ImageCollection. يمكن نسخ معرّف أي صورة في المجموعة إلى دالة الإنشاء Image كما هو موضّح أعلاه. بدلاً من ذلك، يمكنك الحصول على الصورة الأولى (أقل غطاء سحابي):
أداة تعديل الرموز (JavaScript)
var first = filteredCollection.first();
يمكنك الوصول إلى وظيفة الفلترة الكاملة في Earth Engine باستخدام filter() مع ee.Filter كوسيطة. (الطريقتان filterBounds() وfilterDate() المستخدَمتان أعلاه هما اختصاران). على سبيل المثال، ينشئ الرمز التالي Filter، ويستخدمه لفلترة FeatureCollection ويعرض النتيجة:
أداة تعديل الرموز (JavaScript)
// Load a feature collection. var featureCollection = ee.FeatureCollection('TIGER/2016/States'); // Filter the collection. var filteredFC = featureCollection.filter(ee.Filter.eq('NAME', 'California')); // Display the collection. Map.setCenter(-119.604, 37.798, 6); Map.addLayer(filteredFC, {}, 'California');
عمليات حسابية على النطاقات
يمكنك إجراء عمليات حسابية على الصور باستخدام طرق Image. وقد يشمل ذلك إعادة دمج النطاقات (المؤشرات الطيفية) أو تفاضل الصور أو العمليات الرياضية مثل الضرب في ثابت. على سبيل المثال، يمكنك حساب الفرق بين صور "مؤشر الغطاء النباتي ذي الفرق المعياري" (NDVI) التي تفصل بينها 20 عامًا:
أداة تعديل الرموز (JavaScript)
// This function gets NDVI from Landsat 5 imagery. var getNDVI = function(image) { return image.normalizedDifference(['B4', 'B3']); }; // Load two Landsat 5 images, 20 years apart. var image1 = ee.Image('LANDSAT/LT05/C02/T1_TOA/LT05_044034_19900604'); var image2 = ee.Image('LANDSAT/LT05/C02/T1_TOA/LT05_044034_20100611'); // Compute NDVI from the scenes. var ndvi1 = getNDVI(image1); var ndvi2 = getNDVI(image2); // Compute the difference in NDVI. var ndviDifference = ndvi2.subtract(ndvi1);
لاحظ استخدام function يحدده المستخدم في هذا المثال. سنتعرّف على المزيد حول الدوال في القسم التالي.
الدالة Map (ما يجب فعله بدلاً من حلقة for)
يمكنك استخدام map() للتكرار على العناصر في مجموعة. (حلقات For ليست الطريقة الصحيحة لتنفيذ ذلك في Earth Engine ويجب تجنّبها). يمكن تطبيق الدالة map() على ImageCollection أو FeatureCollection أو List، وهي تقبل function كوسيطة لها. وسيطة الدالة هي عنصر من المجموعة التي يتم ربطها بها. ويُعدّ ذلك مفيدًا لتعديل كل عنصر في المجموعة بالطريقة نفسها، مثل إضافة عناصر. على سبيل المثال، يضيف الرمز التالي نطاق NDVI إلى كل صورة في ImageCollection:
أداة تعديل الرموز (JavaScript)
// This function gets NDVI from Landsat 8 imagery. var addNDVI = function(image) { return image.addBands(image.normalizedDifference(['B5', 'B4'])); }; // Load the Landsat 8 TOA data, filter by location and date. var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA') .filterBounds(ee.Geometry.Point(-122.262, 37.8719)) .filterDate('2014-06-01', '2014-10-01'); // Map the function over the collection. var ndviCollection = collection.map(addNDVI);
من المهام الشائعة الأخرى إضافة سمة جديدة (أو "سمة" أو "حقل") إلى العناصر في
FeatureCollection. في المثال التالي، الخاصية الجديدة هي عملية حسابية تتضمن سمتين موجودتين:
أداة تعديل الرموز (JavaScript)
// This function creates a new property that is the sum of two existing properties. var addField = function(feature) { var sum = ee.Number(feature.get('property1')).add(feature.get('property2')); return feature.set({'sum': sum}); }; // Create a FeatureCollection from a list of Features. var features = ee.FeatureCollection([ ee.Feature(ee.Geometry.Point(-122.4536, 37.7403), {property1: 100, property2: 100}), ee.Feature(ee.Geometry.Point(-118.2294, 34.039), {property1: 200, property2: 300}), ]); // Map the function over the collection. var featureCollection = features.map(addField); // Print a selected property of one Feature. print(featureCollection.first().get('sum')); // Print the entire FeatureCollection. print(featureCollection);
يُرجى العِلم أنّه يجب تحويل القيمة إلى ee.Number ليتم التعرّف على قيمة السمة كرقم من أجل استخدام طريقة add(). يمكن تغيير نوع المجموعة من خلال map(). على سبيل المثال:
أداة تعديل الرموز (JavaScript)
// This function returns the image centroid as a new Feature. var getGeom = function(image) { return ee.Feature(image.geometry().centroid(), {foo: 1}); }; // Load a Landsat 8 TOA collection. var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA') .filterBounds(ee.Geometry.Point(-122.262, 37.8719)) .filterDate('2014-06-01', '2014-10-01'); // Map the function over the ImageCollection. var featureCollection = ee.FeatureCollection(collection.map(getGeom)); // Print the collection. print(featureCollection);
يُرجى ملاحظة السمة المضافة (foo) لكل عنصر تم إنشاؤه من مركز الصورة. في السطر الأخير، يجعل التحويل المجموعة الناتجة قابلة للتعرّف عليها كـ FeatureCollection.
الحدّ
التقليل هو طريقة تجميع البيانات بمرور الوقت والمساحة والنطاقات والمصفوفات وغيرها من بُنى البيانات في Earth Engine. تتوفّر طرق مختلفة لهذا الغرض في واجهة برمجة التطبيقات. على سبيل المثال، لإنشاء صورة مركّبة من ImageCollection، استخدِم reduce() لتقليل الصور في المجموعة إلى صورة واحدة. مثال بسيط هو إنشاء المركّب المتوسط لأقل خمسة مشاهد غائمة في مجموعة Landsat 8 المحددة سابقًا:
أداة تعديل الرموز (JavaScript)
// Load a Landsat 8 TOA collection. var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA') // Filter by date and location. .filterBounds(ee.Geometry.Point(-122.262, 37.8719)) .filterDate('2014-01-01', '2014-12-31') // Sort by increasing cloudiness. .sort('CLOUD_COVER'); // Compute the median of each pixel for each band of the 5 least cloudy scenes. var median = collection.limit(5).reduce(ee.Reducer.median());
Reducing is also the way to get statistics of an image in the regions defined by a
Feature or FeatureCollection. لنفترض أنّ المهمة هي حساب متوسط قيم وحدات البكسل ضمن منطقة معيّنة. استخدِم reduceRegion() لهذا الغرض. على سبيل المثال:
أداة تعديل الرموز (JavaScript)
// Load and display a Landsat TOA image. var image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318'); Map.addLayer(image, {bands: ['B4', 'B3', 'B2'], max: 0.3}); // Create an arbitrary rectangle as a region and display it. var region = ee.Geometry.Rectangle(-122.2806, 37.1209, -122.0554, 37.2413); Map.addLayer(region); // Get a dictionary of means in the region. Keys are bandnames. var mean = image.reduceRegion({ reducer: ee.Reducer.mean(), geometry: region, scale: 30 });
يمكنك الاطّلاع على مزيد من المعلومات حول أدوات الاختزال في مستند أدوات الاختزال.
وجه يرتدي قناعًا
كل بكسل في ee.Image له قيمة وقناع يتراوح من 0 (بدون بيانات) إلى 1. يتم التعامل مع وحدات البكسل المحجوبة (التي يكون فيها mask==0) على أنّها لا تحتوي على بيانات. أمّا وحدات البكسل التي تكون فيها قيمة القناع 0 < mask ≤ 1، فتحتوي على قيمة، ولكن يتم ترجيحها بواسطة القناع لإجراء العمليات الحسابية الرقمية.
يمكنك جعل وحدات البكسل شفافة أو استبعادها من التحليل باستخدام الأقنعة. يتم حجب وحدات البكسل عندما تكون قيمة القناع صفرًا. استكمالاً لمثال حساب الفرق بين الصور، يمكنك استخدام قناع لعرض المناطق التي شهدت زيادة أو انخفاضًا في مؤشر NDVI خلال الفترة الزمنية المحددة:
// This function gets NDVI from Landsat 5 imagery. var getNDVI = function(image) { return image.normalizedDifference(['B4', 'B3']); }; // Load two Landsat 5 images, 20 years apart. var image1 = ee.Image('LANDSAT/LT05/C02/T1_TOA/LT05_044034_19900604'); var image2 = ee.Image('LANDSAT/LT05/C02/T1_TOA/LT05_044034_20100611'); // Compute NDVI from the scenes. var ndvi1 = getNDVI(image1); var ndvi2 = getNDVI(image2); // Compute the difference in NDVI. var ndviDifference = ndvi2.subtract(ndvi1); // Load the land mask from the SRTM DEM. var landMask = ee.Image('CGIAR/SRTM90_V4').mask(); // Update the NDVI difference mask with the land mask. var maskedDifference = ndviDifference.updateMask(landMask); // Display the masked result. var vizParams = {min: -0.5, max: 0.5, palette: ['FF0000', 'FFFFFF', '0000FF']}; Map.setCenter(-122.2531, 37.6295, 9); Map.addLayer(maskedDifference, vizParams, 'NDVI difference');
في هذا المثال، يُرجى ملاحظة أنّه يتم تعديل قناع اختلاف NDVI من خلال قناع الأرض
باستخدام updateMask(). يؤدي ذلك إلى ضبط قناع وحدات بكسل الفرق في مؤشر NDVI على قناع اليابسة حيثما يكون قناع الفرق في مؤشر NDVI غير صفري.
يُعدّ الإخفاء مفيدًا أيضًا لاستبعاد البيانات من التحليل. لنتناول مثال reduceRegion() من قسم التقليل. لنفترض أنّ المهمة هي حساب متوسط مؤشر NDVI الموسمي لمقاطعة سانتا كلارا في كاليفورنيا،
باستثناء وحدات البكسل التي تحجبها السحب. يوضّح المثال التالي مفاهيم متعددة:
الفلترة، والربط، والتقليل، واستخدام قناع السحابة:
أداة تعديل الرموز (JavaScript)
// This function gets NDVI from a Landsat 8 image. var addNDVI = function(image) { return image.addBands(image.normalizedDifference(['B5', 'B4'])); }; // This function masks cloudy pixels. var cloudMask = function(image) { var clouds = ee.Algorithms.Landsat.simpleCloudScore(image).select(['cloud']); return image.updateMask(clouds.lt(10)); }; // Load a Landsat collection, map the NDVI and cloud masking functions over it. var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA') .filterBounds(ee.Geometry.Point([-122.262, 37.8719])) .filterDate('2014-03-01', '2014-05-31') .map(addNDVI) .map(cloudMask); // Reduce the collection to the mean of each pixel and display. var meanImage = collection.reduce(ee.Reducer.mean()); var vizParams = {bands: ['B5_mean', 'B4_mean', 'B3_mean'], min: 0.02, max: 0.4}; Map.addLayer(meanImage, vizParams, 'mean'); // Load a region in which to compute the mean and display it. var counties = ee.FeatureCollection('TIGER/2018/Counties'); var santaClara = ee.Feature(counties.filter(ee.Filter.eq('NAME', 'Santa Clara')).first()); Map.addLayer(santaClara); // Get the mean of NDVI in the region. var mean = meanImage.select(['nd_mean']).reduceRegion({ reducer: ee.Reducer.mean(), geometry: santaClara.geometry(), scale: 30 }); // Print mean NDVI for the region. mean.get('nd_mean').evaluate(function(val){ print('Santa Clara spring mean NDVI:', val); });