חישובים באמצעות תמונות

עכשיו, אחרי שלמדתם איך לטעון ולהציג תמונה, הגיע הזמן להחיל עליה חישוב. לדוגמה, אפשר לחשב את השיפוע של פני השטח על ידי העברת תמונת הגובה של SRTM ל-method‏ slope של החבילה ee.Terrain.

Code Editor (JavaScript)

// 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 מסופקת כארגומנט לאלגוריתם השיפוע. התוצאה אמורה להיראות בערך כמו באיור 3.

Tutorial_api_03_slope.png
איור 3. תמונה של שיפוע.

מתמטיקה עם תמונות

יש גם שיטות במחלקה ee.Image שאפשר להפעיל על אובייקט תמונה. לדוגמה, נניח שאתם רוצים לבצע חישוב מתמטי באמצעות רצועות תמונה (לפעמים נקרא חישוב רצועות או אלגברה של מפות). לדוגמה, יכול להיות שתרצו לבצע פעולות טריגונומטריות על תמונה של היבט. כדי לעשות את זה, קודם צריך להמיר תמונת כיוון לרדיאנים, ואז להפעיל עליה את sin(). נשתמש שוב בתמונה srtm,

Code Editor (JavaScript)

// 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');

התוצאה אמורה להיראות בערך כמו באיור 4. כדאי לבחון מקרוב את הקוד של aspect.divide(180).multiply(Math.PI).sin(). כשמשרשרים כמה שיטות כמו בדוגמה הזו, הקוד אומר: "חלק את ההיבט ב-180, הכפל את התוצאה ב-π, ולבסוף חשב את הסינוס". אתם יכולים לבצע פעולות מתמטיות מורכבות על תמונות על ידי שילוב שיטות באופן הזה. במסמכי התיעוד של Image מופיעה רשימה מלאה של פעולות מתמטיות, add(),‏ subtract(),‏ multiply() וכו'.

Tutorial_api_04_sin.png
איור 4. סינוס של כיוון פני השטח.

נתונים סטטיסטיים של תמונות

סוג שימושי נוסף של פעולות על תמונות כולל חישוב נתונים סטטיסטיים של פיקסלים באזורי תמונה, או שכבות-על של וקטור רסטר. כדי לחשב נתונים סטטיסטיים ב-Earth Engine, משתמשים במפחית, שמיוצג על ידי מחלקות בחבילה ee.Reducer. לדוגמה, נניח שאתם מתעניינים בממוצע הגובה באזור מסוים. כדי להגדיר אזור, אפשר לשרטט פוליגון באמצעות כלי השרטוט הגיאומטריים. כדי לשרטט אזור באופן אינטראקטיבי, פותחים את כלי השרטוט של הפוליגון (), יוצרים פוליגון דיגיטלי מעל האזור הרצוי ולוחצים על Exit כשמסיימים. שימו לב שהאובייקט ee.Geometry שנוצר מקבל באופן אוטומטי את השם geometry ומתווסף כייבוא בחלק העליון של הסקריפט. משנים את שם המשתנה ל-"polygon" על ידי לחיצה על שם המשתנה בייבוא והקלדת השם החדש.

בשלב הבא, מקבלים את ערך הפיקסל הממוצע בפוליגון באמצעות הקוד הבא:

Code Editor (JavaScript)

// 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 (מידע נוסף על צמצום אזורים). שנית, הארגומנטים של השיטה מסופקים באובייקט ב-JavaScript שמועבר כארגומנט יחיד. (באופן ספציפי, המפתחות של האובייקט הם השמות של הפרמטרים של השיטה. הערכים הם הארגומנטים של השיטה). שלישית, הפרמטר reducer מציין את סוג הנתון הסטטיסטי שצריך לחשב, והפרמטר geometry מציין את האזור שבו צריך לחשב את הנתון הסטטיסטי. הפרמטר scale הוא גודל הפיקסל במטרים שבו רוצים להשתמש. כדי למנוע אי-בהירות, תמיד צריך לציין את קנה המידה כשמבצעים הפחתות, כי יכול להיות ש-Earth Engine לא יוכל לקבוע באופן אוטומטי את קנה המידה המתאים מהקלט. (מידע נוסף על קנה מידה ב-Earth Engine).

לבסוף, ערך ההחזרה של reduceRegion() הוא מילון שבו המפתחות הם שמות של ערוצים והערכים הם הנתונים הסטטיסטיים של הפיקסלים בערוצים. ה-method get() במילון מחזיר את הערך שתואם למפתח שסופק כארגומנט. במקרה הזה, לתמונה srtm יש פס אחד, "elevation", אז הקוד לדוגמה מקבל את הנתון הסטטיסטי הזה מהמילון ומדפיס אותו.

אם מריצים את הקוד הזה ומוצגת שגיאה שנראית כך:

אל דאגה! יש כמה דברים שאפשר לעשות כדי לפתור את השגיאה. השיטה reduceRegion() כוללת בדיקה כדי לוודא שאתם באמת רוצים לכלול כל כך הרבה פיקסלים בחישוב. המטרה היא למנוע מכם לעשות בטעות משהו לא הגיוני, כמו לנסות לחשב את הממוצע של כל פיקסל בגודל מטר אחד בעולם (אל תעשו את זה). כדי לפתור את השגיאה, צריך להגדיר את הפרמטר bestEffort לערך true על ידי הוספת bestEffort: true למילון הפרמטרים, או להגדיר את הפרמטר maxPixels לערך גבוה יותר מברירת המחדל של 10 מיליון פיקסלים, או את שניהם. אם bestEffort הוא true, ‏Earth Engine יחשב מחדש באופן אוטומטי את קנה המידה כך ש-maxPixels לא יחרוג.

סטייה מהנושא: קנה מידה ב-Earth Engine

בדוגמה הקודמת, הערך של scale מוגדר בערך לרזולוציה המקורית של תמונת ה-SRTM. כדי לגלות את הרזולוציה המקורית של תמונה, אפשר להשתמש בכלים הבאים:

Code Editor (JavaScript)

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

אם תציינו קנה מידה קטן יותר מהרזולוציה המקורית, מערכת Earth Engine תדגום מחדש את תמונת הקלט באמצעות השכן הקרוב ביותר, ואז תכלול את כל הפיקסלים הקטנים יותר בחישוב. אם תגדירו קנה מידה גדול יותר, Earth Engine ישתמש בפיקסלים של קלט מגרסה נצברת של הקלט (כלומר, יקבל פיקסלים מרמה גבוהה יותר של פירמידת התמונה). במסמך הזה מוסבר איך Earth Engine מטפל בקנה מידה.

עד עכשיו עבדתם עם תמונה אחת עם פס אחד. בדף הבא נלמד על תמונות עם כמה ערוצים ועל אוספי תמונות.