ee.Algorithms.TemporalSegmentation.C2c

تنفيذ خوارزمية Composite 2 Change (C2C) تقسّم هذه الخوارزمية سلسلة زمنية باستخدام دالة خطية مجزّأة مع الحد الأدنى من الأجزاء المطلوبة لتوفيق البيانات ضمن الحد الأقصى المحدّد لجذر متوسط الخطأ التربيعي (RMSE). بالنسبة إلى كل نطاق إدخال، تعرض الخوارزمية نطاقات الإخراج التالية:
  • ‫changeDate (مصفوفة[مزدوجة]): التواريخ التي تم فيها رصد التغييرات. يتم تحديد تنسيق التاريخ من خلال وسيطة dateFormat.
  • value (مصفوفة[مزدوجة]): قيمة النطاق في كل changeDate.
  • المقدار (Array[Double]): الفرق بين القيم قبل تاريخ التغيير وبعده. تكون القيمة الأولى للمقدار دائمًا NaN.
  • duration (مصفوفة [مضاعف]): مدة المقطع الذي يسبق تاريخ التغيير. تكون المدة الأولى دائمًا NaN.
  • rate (Array[Double]): معدّل التغيير في البيانات التي تسبق تاريخ التغيير. يكون المعدّل الأول دائمًا NaN.
إذا كانت قيمة includePostMetrics صحيحة، يتم تضمين المتغيرات التالية لكل نطاق.
  • ‫postMagnitude (مصفوفة[مضاعف]): الفرق المطلق بين القيمة في بداية المقطع التالي والقيمة في تاريخ التغيير. تكون قيمة postMagnitude الأخيرة دائمًا NaN.
  • ‫postDuration (مصفوفة[مزدوجة]): مدة المقطع بعد تاريخ التغيير. تكون قيمة postDuration الأخيرة دائمًا NaN.
  • ‫postRate (Array[Double]): معدّل التغيير في البيانات بعد تاريخ التغيير. تكون قيمة postRate الأخيرة دائمًا NaN.
إذا كانت قيمة includeRegrowth صحيحة، يتم تضمين المتغيرات التالية لكل نطاق.
  • ‫indexRegrowth (مصفوفة[مزدوجة]): الفرق بين القيمة في تاريخ التغيير والقيمة بعد خمس نقاط بيانات.
  • recoveryIndicator (مصفوفة [مزدوجة]): نسبة indexRegrowth إلى magnitude.
  • ‫regrowth60 (مصفوفة[مزدوجة]): الفرق الزمني بين تاريخ التغيير ونقطة البيانات التي تكون فيها قيمة السلسلة% 60 من القيمة قبل حدوث الاضطراب.
  • ‫regrowth80 (مصفوفة[مزدوجة]): فرق الوقت بين تاريخ التغيير ونقطة البيانات التي تكون فيها قيمة السلسلة% 80 من القيمة قبل الاضطراب.
  • ‫regrowth100 (Array[Double]): الفرق الزمني بين تاريخ التغيير ونقطة البيانات التي تكون فيها قيمة السلسلة% 100 من القيمة قبل حدوث الاضطراب
لمزيد من التفاصيل حول الخوارزمية الأصلية، يُرجى الاطّلاع على: Hermosilla et al. (2015) https://doi.org/10.1016/j.rse.2014.11.005. يمكنك العثور على تنفيذ الخوارزمية على GitHub: https://github.com/saveriofrancini/C2C-GEE. الشكر والتقدير: FORWARDS وNextGenCarbon.

Citation: Txomin Hermosilla, Michael A. Wulder, Joanne C. White, Nicholas C. Coops وDaniel Coelho وGiovanni Ciatto وNoel Gorelick وSaverio Francini في طور التحضير Image compositing, time-series change detection and temporal metrics: Implementation of the Composite2Change (C2C) algorithm on Google Earth Engine.

هذه الخوارزمية في مرحلة المعاينة وقد تتغيّر.

الاستخدامالمرتجعات
ee.Algorithms.TemporalSegmentation.C2c(collection, dateFormat, maxErrorList, spikesToleranceList, spikeRemovalMagnitudeList, maxError, maxSegments, infill, spikesTolerance, spikeRemovalMagnitude, includePostMetrics, includeRegrowth, interpolateRegrowth, useRelativeRegrowth, negativeMagnitudeOnly)صورة
الوسيطةالنوعالتفاصيل
collectionImageCollectionمجموعة من الصور التي سيتم تشغيل C2C عليها
dateFormatعدد صحيح، القيمة التلقائية: 0تمثّل هذه السمة طريقة عرض الوقت التي سيتم استخدامها أثناء عملية المطابقة: 0 = أيام جوليانية، 1 = سنوات كسرية، 2 = وقت يونكس بالمللي ثانية. سيتم ترميز أوقات البدء والانتهاء والاستراحة لكل مقطع زمني بهذه الطريقة.
maxErrorListالقائمة، القيمة التلقائية: {}قائمة بقيم الحد الأقصى للخطأ (RMSE) التي سيتم استخدامها لكل نطاق. في حال عدم توفيرها، سيتم استخدام قيمة maxError لجميع النطاقات.
spikesToleranceListالقائمة، القيمة التلقائية: {}قائمة بقيم التفاوت المسموح بها في الارتفاعات الحادة التي سيتم استخدامها لكل نطاق. تشير القيمة 1 إلى عدم إزالة أي ارتفاعات مفاجئة. في حال عدم توفيرها، سيتم استخدام قيمة spikesTolerance لجميع النطاقات.
spikeRemovalMagnitudeListالقائمة، القيمة التلقائية: {}قائمة بقيم حجم إزالة التشويش التي سيتم استخدامها لكل نطاق. تتم إزالة الارتفاعات الحادة التي تزيد عن هذه القيمة. في حال عدم توفيرها، سيتم استخدام قيمة spikeRemovalMagnitude لجميع النطاقات.
maxErrorالنوع Float، القيمة التلقائية: 0.075الحدّ الأقصى المسموح به لجذر الخطأ التربيعي المتوسّط في الملاءمة الخطية المتعددة الأجزاء، ويتحكّم في حساسية التقسيم.
maxSegmentsعدد صحيح، القيمة التلقائية: 6الحد الأقصى لعدد الأجزاء المسموح بها في المسار المحدّد
infillقيمة منطقية، القيمة التلقائية: trueتتيح هذه السمة ملء الفجوات في السلسلة الزمنية لإتاحة عملية مطابقة ثابتة في حال عدم توفّر قيم (أي قيم تساوي 0).
spikesToleranceعدد عائم، القيمة التلقائية: 0.85تتحكّم هذه السمة في مدى التفاوت المسموح به في السلسلة الزمنية. تتراوح القيم بين 0 و1. تشير القيمة 1 إلى عدم إزالة أي ارتفاعات مفاجئة، بينما تشير القيم الأقل إلى إزالة المزيد من الارتفاعات المفاجئة.
spikeRemovalMagnitudeعدد عشري، القيمة التلقائية: 0.1الحد الأدنى لمقدار إزالة الارتفاعات المفاجئة. تتم إزالة الارتفاعات الحادة التي تزيد قيمتها (الفرق المطلق عن متوسط القيم المجاورة) عن هذه القيمة.
includePostMetricsقيمة منطقية، القيمة التلقائية: trueتعرض هذه السمة واصفات ما بعد التغيير (postMagnitude وpostDuration وpostRate).
includeRegrowthقيمة منطقية، القيمة التلقائية: falseتعرض هذه السمة مقاييس الاسترداد/إعادة النمو (indexRegrowth وrecoveryIndicator وregrowth60/80/100).
interpolateRegrowthقيمة منطقية، القيمة التلقائية: trueإجراء استيفاء خطي للسلسلة الزمنية باستخدام التغييرات التي تم رصدها قبل احتساب مقاييس إعادة النمو
useRelativeRegrowthقيمة منطقية، القيمة التلقائية: falseتحسب هذه السمة حدود إعادة النمو من حيث الصلة بظروف ما قبل الاضطراب.
negativeMagnitudeOnlyقيمة منطقية، القيمة التلقائية: falseيحتفظ فقط بنقاط التوقف المرتبطة بالتغييرات السلبية (الفلترة الاتجاهية).