סקירה כללית על התרשים

עורך הקוד של Earth Engine JavaScript משתלב בצורה חלקה עם Google Charts כדי להציג בצורה נוחה נתונים בטבלה באמצעות פונקציות ui.Chart. אפשר להציג תרשימים באופן אינטראקטיבי במסוף של עורך הקוד, בווידג'טים של ui.Panel ובכרטיסיות בדפדפן נפרדות.

‫DataTable תרשימים

‫Earth Engine משתמש ב-Google Visualization API כדי לתמוך בתרשימים. ה-API מקבל DataTable, שהוא טבלה דו-ממדית שבה השורות הן תצפיות והעמודות הן מאפייני תצפית. כל התרשימים ב-Earth Engine נגזרים מ-DataTable. הווידג'ט ui.Chart מאפשר לספק DataTable ישירות. היא מספקת את ההזדמנות הטובה ביותר להתאמה אישית של תרשימים, אבל יכול להיות שהיא פחות נוחה משיטות ליצירת תרשימים של אובייקטים ספציפיים ב-Earth Engine (ראו את הסעיף הבא). מידע נוסף על יצירת תרשימים מ-DataTable:

תרשימי אובייקטים ב-Earth Engine

הווידג'ט ui.Chart מספק שיטות עזר ליצירת DataTable ולעיבוד תרשימים מאובייקטים מסוג Image,‏ ImageCollection,‏ Feature,‏ FeatureCollection,‏ Array ו-List. כל פונקציה מקבלת סוג נתונים ספציפי וכוללת שיטות לצמצום הנתונים לפורמט טבלאי במגוון סידורים שמכתיבים את הקצאת הנתונים לסדרות ולצירים של התרשים.

בקישורים הבאים מוסבר איך ליצור תרשים לכל סוג נתונים:

סוגי תרשימים

אפשר ליצור מגוון סוגי תרשימים, למשל: פיזור, קו, עמודות, עוגה והיסטוגרמה. באופן ספציפי, אפשר ליצור כל סוג תרשים שזמין בחבילת corechart של Google Charts. משתמשים ב-ui.Chart.setChartType() כדי להגדיר את סוג התרשים. כל דף שמקושר בקטעים תרשימים של אובייקטים ב-Earth Engine ותרשימים של DataTable כולל דוגמאות ליצירת כמה סוגי תרשימים.

משתמשים במחרוזות הבאות כקלט ל-method‏ ui.Chart.setChartType():

'ScatterChart'
'LineChart'
'ColumnChart'
'BarChart'
'PieChart'
'AreaChart'

לדוגמה:

var data = ee.List([0, 1, 2, 3, 4, 5]);
var chart = ui.Chart.array.values(data, 0, data)
  .setChartType('ColumnChart');
print(chart);

הצגה והורדה

אפשר להציג את הווידג'טים של ui.Chart בשלוש דרכים:

var data = ee.List([0, 1, 2, 3, 4, 5]);
var chart = ui.Chart.array.values(data, 0, data);
print(chart);
var data = ee.List([0, 1, 2, 3, 4, 5]);
var chart = ui.Chart.array.values(data, 0, data);
var chartPanel = ui.Panel(chart);
Map.add(chartPanel);
  • בכרטיסייה נפרדת בדפדפן: לוחצים על סמל החלון הקופץ () בפינה הימנית העליונה של הווידג'ט של ui.Chart. בדף החדש מוצג חלון מלא ואפשרויות להורדת התרשים כקובץ גרפי (PNG או SVG) או כקובץ CSV של הנתונים הבסיסיים.

אינטראקטיביות

כברירת מחדל, התרשימים הם אינטראקטיביים. מעבירים את העכבר מעל נקודות, קווים, עמודות וכו' כדי לראות את ערכי ה-X, ה-Y והסדרות המתאימים. אפשר להגדיל ולהזיז את הצירים על ידי הפעלת הפונקציונליות של "סייר" בתרשים.

סגנון התרשים

אפשר להתאים אישית את Google Charts באמצעות מאפייני סגנון. משתמשים ב-method‏ ui.Chart.setOptions() כדי להגדיר את מאפייני הסגנון של התרשים. פרטים מלאים מופיעים במדריך עיצוב תרשימים.

מגבלות

פונקציות ui.Chart יעבדו רק 5,000 ישויות. אם ב-FeatureCollection, ב-ImageCollection, ב-Array או ב-List יש יותר רכיבים, כדאי לשקול דרכים להגבלת הנתונים. אם יש לכם סדרת זמן ארוכה עם קצב דגימה גבוה, נסו להשתמש בתקופה קצרה יותר, בדגימה זמנית או ליצור קומפוזיציות זמניות. אם הבעיה היא מרחבית, נסו להשתמש בקבוצת משנה אקראית. אם אתם עובדים עם פיקסלים ברשימה או במערך, נסו להשתמש בקנה מידה קצת יותר גדול או באזור קטן יותר.

חישובים ארוכים עלולים להיכשל ביצירת תרשים בגלל מגבלות התגובה האינטראקטיבית של Code Editor. אם הזמן הקצוב לבקשת התרשים נגמר, נסו לייצא את שלבי הביניים של הניתוח וליצור מחדש את התרשים מהנכסים שיוצאו.