שדות תיאור של מערכי נתונים

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

מזהה נכס פרטי

המזהה של הנכס הקיים שעבר הטמעה. עליך להגדיר את הנכס כקריא לכולם.

המזהה המוצע של מערך הנתונים הציבורי

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

מומלץ לכלול במזהה מספר גרסה כמו v1, גם אם לא מתכננים ליצור גרסאות נוספות. אם מספר גרסה לא רלוונטי, מומלץ להשתמש בתאריך הפרסום של מערך הנתונים.

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

ההחלטה אם להשתמש בכמה רמות של תיקיות (למשל ORG/A/B/C/D/V001/20180310) או לכווץ את הרמות לתיקייה אחת (למשל ORG/A_B_C_D/V001/20180310) תלויה גם בסבירות שייווצרו עוד מערכי נתונים מאותו סוג. אם סביר להניח שיהיה מערך נתונים חדש עם ערכים שונים, כדאי להשתמש בכמה רמות (למשל FOO/E/F/G/V001/20180310). אם לא סביר שיתווספו מערכי נתונים נוספים בעתיד, אפשר לכווץ את הרמות.

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

דוגמאות לנכסים משולבים ומחולקים:

אוספים של תכונות ואוספי תמונות

אפשר להשתמש באוספים של תכונות ובאוספים של תמונות כדי לקבץ תכונות או תמונות קשורות.

דוגמאות לאוספים של תכונות ולאוספים של תמונות:

  • BLM AIM TerrADat TerrestrialAIM Point v1 שילוב של נתוני טבלאות קשורים ב-FeatureCollection. מכיוון שאין דרך קלה לבצע עדכונים שוטפים בטבלאות, כל עדכון צריך להיות FeatureCollection חדש.
  • LANDFIRE מכסה את כל ארה"ב, אלסקה והוואי. במקום להטמיע אותם יחד בנכס אחד, נאלצנו להעביר את הנכסים ל-ImageCollection, כי לקבצי המקור יש תצוגות שונות.

שם מערך הנתונים

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

דוגמה: Hansen Global Forest Change v1.7 (2000-2019)

כדי להבחין בין מערכי נתונים עם שמות דומים, מומלץ ליצור 50 תווים ייחודיים ראשונים. כך המשתמשים יוכלו למצוא בקלות רבה יותר את מערך הנתונים המתאים בתוצאות החיפוש.

שם הספק

מציינים את שם הספק של מערך הנתונים. אם מערך הנתונים נוצר בשיתוף פעולה של ארגונים שונים, צריך להשתמש בכמה שמות של ספקים.

לדוגמה: European Union/ESA/Copernicus

כתובת ה-URL של תיאור מערך הנתונים

מוסיפים קישור לדף האינטרנט הראשי של מערך הנתונים.

כתובת ה-URL להורדת הקובץ

אם רלוונטי, מוסיפים קישור למיקום שבו אפשר להוריד את הנתונים ישירות.

תאריכי ההתחלה והסיום של מערך הנתונים

ב-Earth Engine צריך להגדיר תאריך התחלה וסיום. מומלץ שהתאריכים ייצגו את מרווח התצפית. אם מדובר במערך נתונים מתמשך, אפשר להשאיר את תאריך הסיום ריק.

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

אזור הכיסוי של מערך הנתונים

יש לבחור באפשרות GLOBAL או באפשרות CUSTOM_EXTENT. כדי שמערך נתונים ייחשב כ-GLOBAL, הוא צריך לחפוף לקו האורך השני או לכסות יותר ממחצית כדור הארץ.

אם בוחרים באפשרות CUSTOM_EXTENT, מועברים לדף נפרד שבו אפשר לציין את תיבת הגבול. התיבה הזו יכולה להיות גדולה יותר מאזור הכיסוי בפועל, אבל חשוב לוודא שהיא לא חופפת לקו האורך המקביל. האתר geojson.io יכול להיות שימושי לחיפוש מהיר של קואורדינטות של נקודות במפה.

תיאור של מערך הנתונים

המאמר הזה צריך להכיל מספיק מידע כדי שמשתמש חדש יוכל להתחיל לעבוד.

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

אפשר להשתמש ב-markdown בתיאור כדי להוסיף קישורים ונקודות.

אין להזין בתיאור מידע שכפול של מידע בשדות אחרים בטופס הזה.

תגים

אנחנו משתמשים בתגים כדי לסווג את הנתונים ב-Earth Engine Data Catalog. כך המשתמשים יוכלו למצוא את הנתונים שלכם על ידי גלישה במערכי נתונים קשורים.

התגים יכולים להיות מילים כלשהן – לדוגמה: "carbon",‏ "pollution",‏ "ocean",‏ "landcover",‏ "nasa" וכו'.

כדאי לעיין ברשימה של התגים הקיימים ולנסות להשתמש בהם.

רישיון של מערך נתונים (תנאי השימוש)

אם כבר בחרתם את התנאים וההגבלות, יש לציין אותם בקטע הזה. מומלץ להחיל את הרישיון CC-BY-4. תנאים מגבילים יותר צריכים להיות מוסכמים עם צוות Earth Engine Data.

יש לציין קישור לדף באתר הראשי של מערך הנתונים שבו מופיע הרישיון.

ציטוטים

מציינים את הדרישות לגבי האופן והמועד שבהם צריך לצטט את הנתונים. אם רלוונטי, יש להשתמש בפורמט APA לציטוט.

דוגמאות ממערכי נתונים קיימים:

צריך להשתמש בפורמט https://doi.org/10.7265/N5V98602

פס רסטרים או נכסי וקטורים

בקטע הזה אפשר לרשום מאפיינים של פס רסטר או של וקטור (טבלה).

דוגמאות:

  • WDPA: World Database on Protected Areas הוא דוגמה לאופן שבו אפשר לרשום כל מאפיין טבלה עם תיאור וסוג נתונים.
  • RTMA הוא דוגמה לאופן שבו הלהקות יוצגו.

אם יש לכם יותר מ-10 רשומות, תוכלו ליצור רשימה בקובץ נפרד ולהעלות אותה לגיליון אלקטרוני ב-Google Sheets.

צריך לציין את סוג הרשומה (STRING / INT / DOUBLE) רק למאפייני וקטורים.

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

  • התמונות לדוגמה צריכות להיות בגודל 256x256 פיקסלים.
  • אין לכלול שום דבר אחר (ללא מפת רקע, גבולות, שמות של ערים וכו'). אם יש אזור ללא נתונים (למשל, אוקיינוסים סביב יבשות), צריך להגדיר את הרקע לבן כדי להתאים אותו לרקע של דף האינטרנט. לדוגמה, כדי להוסיף שכבה לבנה בכלי לעריכת קוד:
var white = ee.Image(1);
Map.addLayer(white, {min: 0, max: 1});
  • ממקמים את המצלמה במרכז של משהו שקל לזהות, למשל יבשת.
  • כדאי להציג תצוגה חזותית נקייה. כדאי להשתמש בממוצע או במדד חציוני אם הנתונים הבודדים מבולבלים מדי או שיש בהם יותר מדי רעשי רקע.

משתפים קישור לתצוגה החזותית לדוגמה בעורך הקוד. קטע הקוד הזה ישותף בדף הקטלוג של מערך הנתונים. בהמשך מופיעה דוגמה לשימוש במערך הנתונים של כיסוי פני השטח של תוכנית קופרניקוס CORINE.

var dataset = ee.Image('COPERNICUS/CORINE/V20/100m/2012');
var landCover = dataset.select('landcover');
Map.setCenter(16.436, 39.825, 6);
Map.addLayer(landCover, {}, 'Land Cover');

אם אתם רוצים לשתף דוגמה מורכבת יותר, תוכלו להוסיף אותה לקטע של הסקריפטים במאגר של קהילת Earth Engine.