Earth Engine תוכנן כך שכמעט אף פעם לא צריך לדאוג לגבי היטלי מפה כשמבצעים חישובים. כמו בקנה המידה, ההיטל שבו מתבצעים החישובים נקבע על בסיס "משיכה". באופן ספציפי, נדרשים קלטים בתחזית הפלט. אפשר לקבוע את הפלט באמצעות פרמטר של פונקציה (למשל crs), אובייקטים של מפות ב-Code Editor וב-geemap (עם היטל מרקטור (EPSG:3857)) או באמצעות קריאה ל-reproject(). כשמציגים תמונות בעורך הקוד או ב-geemap, הקלט מתבקש ב-maps mercator. נבחן את הפעולה הבאה על תמונת MODIS, שיש לה היטל סינוסואידלי:
Code Editor (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');
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. שימו לב שההיטל של הקלט נקבע לפי הפלט, ובאופן ספציפי לפי ההיטל maps mercator של תצוגת המפה בכלי לעריכת קוד. ההיטל הזה מופץ בחזרה דרך רצף הפעולות, כך שהקלט מתבקש בהיטל מרקטור של המפה, בקנה מידה שנקבע לפי רמת הזום של המפה.
ב-Earth Engine, ההיטלים מצוינים באמצעות מערכת קואורדינטות (CRS או הפרמטר crs של שיטות רבות). כדי לבדוק את ההיטל של תמונה, אפשר להפעיל עליה את הפונקציה projection():
Code Editor (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());
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 בקנה מידה של מעלה אחת.
לדוגמה:
Code Editor (JavaScript)
var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA'); var mosaic = collection.filterDate('2018-01-01', '2019-01-01').mosaic(); print(mosaic.projection());
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() יבוצעו בהיטל שצוין. לדוגמה, כדי לאלץ יצירה של תמונה מורכבת בהיטל ספציפי:
Code Editor (JavaScript)
// Some projection that is suitable for your area of interest. var proj = ee.Projection(...); var output = collection.reduce(...).reproject(proj);
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.gradientאוee.Terrain.slope). -
reduceResolution, כשרוצים לצבור פיקסלים ברזולוציה גבוהה יותר לרזולוציה נמוכה יותר. *(מידע נוסף על הפחתת הרזולוציה)
פונקציות בחבילה ee.Terrain (למשל, slope, aspect, hillshade) מחשבות ערכים על סמך פיקסלים סמוכים, והן רגישות לארטיפקטים של דגימה מחדש שנוצרים במהלך הטלה מחדש. כשההיטל של החישוב שונה מההיטל המקורי של ה-DEM, דגימה מחדש של השכן הקרוב ביותר כברירת מחדל יכולה ליצור דפוסים מלאכותיים בפלט. כדי לקבל את התוצאות הטובות ביותר, כדאי לבצע ניתוח של פני השטח בהיטל המקורי של ה-DEM. אם עובדים עם ImageCollection של משבצות DEM, צריך ליצור פסיפס ולהשתמש ב-setDefaultProjection() עם ההיטל המקורי של האוסף כדי לוודא שהניתוח פועל על הרשת הנכונה, כפי שמתואר בקטע היטל ברירת המחדל.
יש כמה סיבות שבגללן כדאי להימנע משימוש ב-reproject(), אלא אם אתם חייבים להשתמש בו. לדוגמה, נניח שאתם משנים את ההיטל של משהו ומוסיפים אותו למפה. אם קנה המידה שציינתם בקריאה ל-reproject() קטן בהרבה מרמת הזום של המפה, Earth Engine יבקש את כל הקלטים בקנה מידה קטן מאוד, על פני היקף מרחבי רחב מאוד. זה עלול לגרום לבקשה של יותר מדי נתונים בבת אחת ולהוביל לשגיאה.
אם הפלט הסופי הוא בהיטל שונה מזה שצוין בקריאה ל-reproject(), תתבצע הטלה מחדש נוספת. זו סיבה נוספת לכך שצריך להיזהר כשמשתמשים ב-reproject() בקוד. בדוגמה הבאה, תמונת MODIS עוברת קודם היטל מחדש ל-WGS84, ואז היטל מחדש ל-maps mercator כדי להציג אותה במפה של Code Editor:
Code Editor (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');
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 באופן אוטומטי כדי להציג את התוצאה במפה. שימו לב גם שהמידע על ההיטל שבו צריך להשתמש מועבר מהבקשה חזרה לקלט.