محاسبات بااستفاده از تصاویر

اکنون که می‌دانید چگونه تصویر را بار کنید و نمایش دهید، وقت آن است که محاسباتی را روی آن اعمال کنید. برای مثال، می‌توانید شیب زمین را با ارسال تصویر ارتفاع SRTM به روش slope از بسته ee.Terrain محاسبه کنید.

ویرایشگر کد (جاوا اسکریپت)

// Load the SRTM image.
var srtm = ee.Image('CGIAR/SRTM90_V4');

// Apply an algorithm to an image.
var slope = ee.Terrain.slope(srtm);

// Display the result.
Map.setCenter(-112.8598, 36.2841, 9); // Center on the Grand Canyon.
Map.addLayer(slope, {min: 0, max :60}, 'slope');

توجه داشته باشید که در کد ee.Terrain.slope(srtm)، تصویر srtm به‌عنوان آرگومان برای الگوریتم شیب ارائه شده است. نتیجه باید چیزی شبیه به شکل ۳ باشد.

Tutorial_api_03_slope.png
شکل ۳. تصویر شیب.

ریاضی تصویری

همچنین روش‌هایی در کلاس ee.Image وجود دارد که می‌توان آن‌ها را در شیء تصویر فراخوانی کرد. برای مثال، فرض کنید می‌خواهید بااستفاده از باندهای تصویر، محاسبات ریاضی انجام دهید (گاهی اوقات محاسبات ریاضی باند یا جبر نقشه نامیده می‌شود). برای مثال، ممکن است به عملیات مثلثاتی روی تصویر نسبت ابعاد علاقه‌مند باشید. برای انجام این کار، ابتدا تصویر جهت شیب را به رادیان تبدیل کنید، سپس sin() را روی آن فراخوانی کنید. استفاده مجدد از تصویر srtm ما،

ویرایشگر کد (جاوا اسکریپت)

// Get the aspect (in degrees).
var aspect = ee.Terrain.aspect(srtm);

// Convert to radians, compute the sin of the aspect.
var sinImage = aspect.divide(180).multiply(Math.PI).sin();

// Display the result.
Map.addLayer(sinImage, {min: -1, max: 1}, 'sin');

نتیجه باید چیزی شبیه به شکل ۴ باشد. ارزشش را دارد که نگاه دقیق‌تری به کد aspect.divide(180).multiply(Math.PI).sin() بیندازید. با زنجیر کردن چند روش به این صورت، کد می‌گوید: «زاویه را بر ۱۸۰ تقسیم کن، نتیجه را در π ضرب کن، و درنهایت سینوس آن را بگیر». با ترکیب روش‌ها به این صورت، می‌توانید عملیات ریاضی پیچیده‌ای را روی تصاویر انجام دهید. برای مشاهده فهرست کامل عملیات ریاضی، add()، subtract()، multiply()، و غیره، اسناد Image را ببینید.

Tutorial_api_04_sin.png
شکل ۴. سینوس جهت شیب زمین.

آمار تصویر

کلاس مفید دیگری از عملیات روی تصاویر شامل محاسبه آمار پیکسل در مناطق تصویر یا هم‌پوشانی‌های برداری-شطرنجی است. برای محاسبه آمار در Earth Engine، از یک کاهنده استفاده کنید که توسط کلاس‌ها در ee.Reducer بسته نشان داده شده است. برای مثال، فرض کنید به میانگین ارتفاع در منطقه‌ای خاص علاقه‌مند هستید. می‌توانید با کشیدن چندضلعی بااستفاده از ابزارهای رسم هندسی، منطقه‌ای را تعریف کنید. برای رسم تعاملی یک منطقه، ابزار رسم چندضلعی () را دریافت کنید، سپس یک چندضلعی را روی منطقه موردنظر خود دیجیتالی کنید و پس‌از اتمام کار روی خروج کلیک کنید. توجه داشته باشید که شیء ee.Geometry حاصل به‌طور خودکار geometry نام‌گذاری می‌شود و به‌عنوان واردات در بالای نوشتار شما اضافه می‌شود. با کلیک کردن روی نام متغیر در واردشده‌ها و تایپ کردن نام جدید، نام آن متغیر را به «polygon» تغییر دهید.

سپس، بااستفاده از کد زیر، مقدار میانگین پیکسل را در چندضلعی دریافت کنید:

ویرایشگر کد (جاوا اسکریپت)

// Compute the mean elevation in the polygon.
var meanDict = srtm.reduceRegion({
  reducer: ee.Reducer.mean(),
  geometry: polygon,
  scale: 90
});

// Get the mean from the dictionary and print it.
var mean = meanDict.get('elevation');
print('Mean elevation', mean);

چند نکته در اینجا قابل‌توجه است. ابتدا توجه کنید که reduceRegion() روشی است که برای اشیاء Image دردسترس است (در اینجا درباره کاهش مناطق بیشتر بدانید). دوم، متغیرهای مستقل روش در یک شیء جاوا اسکریپت ارائه می‌شوند که به‌عنوان یک متغیر مستقل ارسال می‌شود. (به‌طور مشخص، کلیدهای شیء نام پارامترهای روش هستند. مقادیر، متغیرهای مستقل برای روش هستند). سوم، پارامتر reducer نوع آمار را برای محاسبه مشخص می‌کند و پارامتر geometry منطقه‌ای را که آمار در آن محاسبه می‌شود مشخص می‌کند. پارامتر scale اندازه پیکسل برحسب متر است که باید استفاده شود. برای اجتناب از ابهام، همیشه باید مقیاس را هنگام کاهش مشخص کنید زیرا Earth Engine ممکن است نتواند به‌طور خودکار مقیاس مناسب را از ورودی‌ها تعیین کند. (درباره مقیاس در Earth Engine بیشتر بدانید).

درنهایت، مقدار برگشتی reduceRegion() یک واژه‌نامه است که در آن کلیدها نام باندها و مقادیر آمار پیکسل برای باندها هستند. روش get() در یک فرهنگ لغت، مقدار مربوط به کلید ارائه‌شده به‌عنوان آرگومان را برمی‌گرداند. در این مورد، تصویر srtm یک باند دارد، «ارتفاع»، بنابراین کد نمونه آن آمار را از واژه‌نامه دریافت می‌کند و آن را چاپ می‌کند.

وقتی این کد را اجرا می‌کنید، اگر خطایی مانند زیر دریافت کردید:

نگران نباشید! چند کار می‌توانید برای رفع این خطا انجام دهید. روش reduceRegion() دارای بررسی‌ای است تا مطمئن شود که آیا واقعاً می‌خواهید این تعداد پیکسل را در محاسباتتان لحاظ کنید یا نه. هدف از این کار جلوگیری از انجام تصادفی کارهای احمقانه است، مثل تلاش برای محاسبه میانگین هر پیکسل ۱ متری در جهان (این کار را نکنید). برای برطرف کردن این خطا، یا پارامتر bestEffort را با افزودن bestEffort: true به واژه‌نامه پارامترها روی true تنظیم کنید، یا پارامتر maxPixels را روی مقداری بالاتر از مقدار پیش‌فرض ۱۰ میلیون پیکسل تنظیم کنید، یا هر دو کار را انجام دهید. اگر bestEffort درست باشد، Earth Engine به‌طور خودکار مقیاس را دوباره محاسبه می‌کند تا از maxPixels فراتر نرود.

Digression: Scale in Earth Engine

در مثال قبلی، scale تقریباً روی وضوح اصلی تصویر SRTM تنظیم شده است. می‌توانید وضوح اصلی تصویر را با این موارد پیدا کنید:

ویرایشگر کد (جاوا اسکریپت)

var scale = srtm.projection().nominalScale();
print('SRTM scale in meters', scale);

اگر مقیاسی کوچک‌تر از وضوح اصلی مشخص کنید، Earth Engine با کمال میل تصویر ورودی را بااستفاده از نزدیک‌ترین همسایه بازنمونه‌گیری می‌کند، سپس همه آن پیکسل‌های کوچک‌تر را در محاسبه لحاظ می‌کند. اگر مقیاس را بزرگ‌تر تنظیم کنید، Earth Engine از پیکسل‌های ورودی نسخه انبوهشی ورودی استفاده خواهد کرد (یعنی پیکسل‌ها را از سطح بالاتری از هرم تصویر دریافت می‌کند). در این سند درباره نحوه مدیریت مقیاس توسط Earth Engine بیشتر بدانید.

تاکنون با یک تصویر با یک باند کار کرده‌اید. در صفحه بعدی، با تصاویر چندباندی و مجموعه‌های تصویر آشنا خواهید شد.