ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints

تشغيل ميزة رصد نقاط التوقّف، على غرار دالة strucchange::breakpoints في R

يتم احتواء كل بكسل من خلال نموذج توافقي/خطي متقطع، بالشكل

Y = A + B * t + C * cos(2 * pi * season(t)) + D * sin(2 * pi * season(t)) + E * cos(4 * pi * season(t)) + F * sin(4 * pi * season(t)) + ...

في هذه المعادلة، يمثّل "t" وقت بدء الصورة بالتنسيق المحدّد بواسطة "dateFormat"، ويمثّل "season(t)" الجزء الكسري من السنة لوقت البدء هذا (راجِع وصف dateFormat للحصول على التفاصيل). يتم تحديد الحد الأقصى لترتيب الحدود التوافقية من خلال 'seasonalModelOrder'.

النتيجة هي صورة تحتوي على فرقتَين، بالإضافة إلى فرقتَين لكل فرقة في الإدخال:

‫tStart وtEnd: يحتوي كل منهما على مصفوفة أحادية الأبعاد، مع إدخال واحد لكل جزء في النموذج الخطي المتواصل، ويحتوي كل إدخال على وقت بدء الصور الأولى أو الأخيرة في هذا الجزء. تكون القيم هنا تلقائيًا بالسنوات الجزئية، وذلك لتسهيل استخدامها مع المعاملات.

coefs_BANDNAME: سيكون هناك نطاق إخراج واحد لكل نطاق إدخال. يحتوي كلّ منها على مصفوفة ثنائية الأبعاد، مع صف واحد لكلّ شريحة. القيم في هذا الصف هي معاملات المطابقة الخطية لهذه الشريحة، أي قيم A وB وC وما إلى ذلك لهذه الشريحة. كما هو موضّح أعلاه، تتأثّر القيم هنا بـ "dateFormat"

‫.rmse_BANDNAME: سيكون هناك نطاق إخراج واحد لكل نطاق إدخال. يحتوي هذا الحقل على مصفوفة أحادية البُعد، مع إدخال واحد لكل جزء. قيمة كل شريحة هي الجذر التربيعي لمتوسط مربعات الخطأ (RMSE) لمتبقيات الملاءمة الخطية لهذه الشريحة.

الاستخدام	المرتجعات
ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints(collection, breakpointBand, seasonalModelOrder, minSpacing, maxBreaks, dateFormat)	صورة

الوسيطة	النوع	التفاصيل
collection	ImageCollection	مجموعة من الصور التي سيتم رصد نقاط التوقّف فيها
breakpointBand	سلسلة، القيمة التلقائية: null	اسم النطاق المستخدَم لرصد نقاط التوقف اختياري فقط إذا كانت الصور تحتوي على نطاق واحد فقط.
seasonalModelOrder	عدد صحيح، القيمة التلقائية: 3	تمثّل هذه السمة ترتيب النموذج الموسمي التوافقي.
minSpacing	التعويم، القيمة التلقائية: 0.15	الحدّ الأدنى للمسافة بين نقاط التوقّف إذا كان هذا الرقم بين 0 و1 (باستثناء هذين الرقمين)، سيتم تفسيره على أنّه جزء من عدد الصور في المجموعة. بخلاف ذلك، سيتم تفسيرها على أنّها عدد من العيّنات.
maxBreaks	عدد صحيح، القيمة التلقائية: 0	تمثّل هذه السمة الحد الأقصى لعدد نقاط التوقّف.
dateFormat	عدد صحيح، القيمة التلقائية: 1	تمثيل الوقت الذي سيتم استخدامه في النتائج: 1 = سنوات كسرية، 2 = التوقيت بتنسيق Unix بالملّي ثانية يؤثّر ذلك في القيم ضمن النطاقَين tStart وtEnd وقيم "t" المستخدَمة في النموذج التوافقي. يتم تعريف السنوات الجزئية المستخدَمة هنا وفي هذا النموذج على أنّها العدد الجزئي للسنوات التي تبلغ 365.25 يومًا منذ 1 يناير 1970.