ee.Algorithms.TemporalSegmentation.C2c

הטמעה של אלגוריתם Composite 2 Change (C2C). האלגוריתם הזה מפלח סדרת זמן באמצעות התאמה לינארית מקטעית עם המספר המינימלי של פלחים שנדרשים להתאמת הנתונים בתוך השגיאה הריבועית הממוצעת (RMSE) המקסימלית שצוינה. לכל פס קלט, האלגוריתם מחזיר את פסי הפלט הבאים:

• ‫changeDate (מערך [מספרים עשרוניים]): התאריכים שבהם זוהו שינויים. פורמט התאריך נקבע על ידי הארגומנט dateFormat.
• ‫value (מערך [מספר כפול]): ערך הרצועה בכל changeDate.
• ‫magnitude (מערך [מספר כפול]): ההבדל בין הערכים לפני ואחרי תאריך השינוי. הגודל הראשון הוא תמיד NaN.
• ‫duration (מערך [מספר כפול]): משך הפלח שקדם לתאריך השינוי. הערך של משך הזמן הראשון הוא תמיד NaN.
• ‫rate (מערך [מספר כפול]): קצב השינוי של הנתונים שקדמו לתאריך השינוי. הערך הראשון הוא תמיד NaN.

אם includePostMetrics הוא true, המשתנים הבאים נכללים לכל פס.

• ‫postMagnitude (מערך [מספר כפול]): ההפרש המוחלט בין הערך בתחילת הפלח הבא לבין הערך בתאריך השינוי. הערך האחרון של postMagnitude הוא תמיד NaN.
• ‫postDuration (מערך [מספרים עשרוניים]): משך הפלח אחרי תאריך השינוי. הערך האחרון של postDuration הוא תמיד NaN.
• ‫postRate (מערך[מספר]): קצב השינוי של הנתונים אחרי תאריך השינוי. הערך של postRate האחרון הוא תמיד NaN.

אם הערך של includeRegrowth הוא true, המשתנים הבאים נכללים לכל פס.

• ‫indexRegrowth (מערך[מספר עשרוני]): ההפרש בין הערך בתאריך השינוי לבין הערך חמש נקודות נתונים אחרי.
• ‫recoveryIndicator (מערך [מספר כפול]): היחס בין indexRegrowth לבין magnitude.
• ‫regrowth60 (מערך[מספר כפול]): הפרש הזמן בין תאריך השינוי לבין נקודה על הגרף שבה ערך הסדרה הוא 60% מהערך לפני ההפרעה.
• ‫regrowth80 (מערך [מספרים עשרוניים]): הפרש הזמן בין תאריך השינוי לבין נקודה על הגרף שבה ערך הסדרה הוא 80% מהערך שלפני ההפרעה.
• ‫regrowth100 (מערך[מספר עשרוני]): הפרש הזמן בין תאריך השינוי לבין נקודה על הגרף שבה ערך הסדרה הוא 100% מהערך לפני ההפרעה.

פרטים נוספים על האלגוריתם המקורי זמינים במאמר של הרמוסייה ואחרים (2015) בכתובת https://doi.org/10.1016/j.rse.2014.11.005. הטמעה של האלגוריתם זמינה ב-GitHub: https://github.com/saveriofrancini/C2C-GEE תודות: FORWARDS ו-NextGenCarbon.

ציטוט: Txomin Hermosilla, Michael A. Wulder, Joanne C. White, Nicholas C. קופס, דניאל קואלו, ג'ובאני צ'אטו, נואל גורליק וסאבריו פרנצ'יני. בהכנה. שילוב תמונות, זיהוי שינויים בסדרת זמנים ומדדים זמניים: הטמעה של אלגוריתם Composite2Change ‏ (C2C) ב-Google Earth Engine.

האלגוריתם הזה נמצא בגרסת טרום-השקה (Preview) ועשוי להשתנות.

שימוש	החזרות
ee.Algorithms.TemporalSegmentation.C2c(collection, dateFormat, maxErrorList, spikesToleranceList, spikeRemovalMagnitudeList, maxError, maxSegments, infill, spikesTolerance, spikeRemovalMagnitude, includePostMetrics, includeRegrowth, interpolateRegrowth, useRelativeRegrowth, negativeMagnitudeOnly)	תמונה

ארגומנט	סוג	פרטים
collection	ImageCollection	אוסף תמונות שרוצים להריץ עליהן C2C.
dateFormat	מספר שלם, ברירת מחדל: 0	ייצוג הזמן שבו צריך להשתמש במהלך ההתאמה: 0 = ימים, 1 = שברים של שנים, 2 = זמן יוניקס באלפיות השנייה. שעות ההתחלה, הסיום וההפסקה של כל מקטע זמני יקודדו בצורה הזו.
maxErrorList	רשימה, ברירת מחדל: {}	רשימה של ערכי השגיאה המקסימלית (RMSE) לשימוש בכל פס. אם לא תציינו ערך, המערכת תשתמש בערך של maxError לכל הטווחים.
spikesToleranceList	רשימה, ברירת מחדל: {}	רשימה של ערכי סבילות לעלייה חדה לשימוש בכל פס. ערך של 1 מציין שלא תתבצע הסרה של נקודות חריגות. אם לא תציינו ערך, המערכת תשתמש בערך של spikesTolerance לכל הטווחים.
spikeRemovalMagnitudeList	רשימה, ברירת מחדל: {}	רשימה של ערכי עוצמה להסרת נקודות חריגות שמשמשים לכל פס. עליות חדות בעוצמה שמעל הערך הזה יוסרו. אם לא תציינו ערך, המערכת תשתמש בערך של spikeRemovalMagnitude לכל הטווחים.
maxError	מספר ממשי (float), ברירת המחדל: 0.075	הערך המקסימלי המותר של RMSE של ההתאמה הליניארית החלקית; שולט ברגישות הפילוח.
maxSegments	מספר שלם, ברירת מחדל: 6	מספר הקטעים המקסימלי שמותר להשתמש בהם בנתיב המותאם.
infill	בוליאני, ברירת מחדל: true	האפשרות הזו מאפשרת השלמה של פערים בסדרת הזמן כדי לתמוך בהתאמה יציבה בנוכחות ערכים חסרים (כלומר, ערכים ששווים ל-0).
spikesTolerance	מספר ממשי (float), ברירת מחדל: 0.85	ההגדרה הזו קובעת את הסבילות לעליות פתאומיות בסדרת הזמן. הערך נע בין 0 ל-1. ערך של 1 מציין שלא תתבצע הסרה של עליות פתאומיות, וערכים נמוכים יותר מציינים הסרה אגרסיבית יותר.
spikeRemovalMagnitude	מספר ממשי (float), ברירת מחדל: 0.1	סף עוצמת ההסרה של נקודות חריגות. עליות חדות בעוצמה (ההפרש המוחלט מהממוצע של השכנים) מעל הערך הזה יוסרו.
includePostMetrics	בוליאני, ברירת מחדל: true	הפונקציה מחזירה מתארים של שינויים (postMagnitude, ‏ postDuration, ‏ postRate).
includeRegrowth	ערך בוליאני, ברירת מחדל: false	מדדי התאוששות/צמיחה חוזרת של החזרות (indexRegrowth, ‏ recoveryIndicator, ‏ regrowth60/80/100).
interpolateRegrowth	בוליאני, ברירת מחדל: true	מבצעים אינטרפולציה לינארית של סדרת הזמן באמצעות השינויים שזוהו לפני חישוב מדדי הצמיחה מחדש.
useRelativeRegrowth	ערך בוליאני, ברירת מחדל: false	חישוב ספי צמיחה מחדש במונחים יחסיים לתנאים לפני ההפרעה.
negativeMagnitudeOnly	ערך בוליאני, ברירת מחדל: false	שומר רק את נקודות ההפסקה שמשויכות לשינויים שליליים (סינון לפי כיוון).