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

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

זהירות: הווידג'ט ui.Chart זמין רק ל-API של עורך הקוד של JavaScript.

תרשימים של DataTable

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

• DataTable תרשימים

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

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

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

• Feature תרשימים
• FeatureCollection תרשימים
• Image תרשימים
• ImageCollection תרשימים
• Array תרשימים
• List תרשימים

סוגי תרשימים

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

משתמשים במחרוזות הבאות כקלט לשיטה 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:

• במסוף של Code Editor

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

• בווידג'ט ui.Panel

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 ו-series. אפשר להגדיל ולזוז בצייר על ידי הפעלת הפונקציונליות של 'כלי הניווט' בתרשים.

עיצוב

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

מגבלות

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

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