ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints

Exécute la détection des points d'arrêt, comme la fonction breakpoints de strucchange::breakpoints de R.

Chaque pixel est ajusté par un modèle linéaire/harmonique par morceaux, de la forme

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)) + ...

Dans cette équation, "t" correspond à l'heure de début de l'image au format spécifié par "dateFormat", et "season(t)" correspond à la fraction de l'année de cette heure de début (consultez la description de dateFormat pour en savoir plus). L'ordre maximal des termes harmoniques est déterminé par "seasonalModelOrder".

Le résultat est une image contenant deux bandes, plus deux bandes par bande dans l'entrée :

tStart, tEnd : chacun de ces éléments contient un tableau à une dimension, avec une entrée par segment dans l'ajustement linéaire par morceaux. Chaque entrée contient l'heure de début des première et dernière images de ce segment. Par défaut, les valeurs sont exprimées en fractions d'année pour faciliter l'utilisation des coefficients.

coefs_BANDNAME : il y aura une bande de sortie par bande d'entrée. Chacun d'eux contient un tableau 2D, avec une ligne par segment. Les valeurs de cette ligne correspondent aux coefficients de l'ajustement linéaire pour ce segment, c'est-à-dire les valeurs de A, B, C, etc. pour ce segment. Comme décrit ci-dessus, les valeurs ici sont affectées par "dateFormat".

.rmse_BANDNAME : une bande de sortie est générée pour chaque bande d'entrée. Il contient un tableau 1D, avec une entrée par segment. La valeur de chaque segment correspond à la RMSE des résidus d'ajustement linéaire pour ce segment.

Utilisation	Renvoie
ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints(collection, breakpointBand, seasonalModelOrder, minSpacing, maxBreaks, dateFormat)	Image

Argument	Type	Détails
collection	ImageCollection	Collection d'images sur lesquelles détecter les points d'arrêt.
breakpointBand	Chaîne, valeur par défaut : null	Nom de la bande à utiliser pour la détection des points d'arrêt. Facultatif uniquement si les images ne comportent qu'une seule bande.
seasonalModelOrder	Entier, par défaut : 3	Ordre du modèle saisonnier harmonique.
minSpacing	Float, valeur par défaut : 0,15	Espacement minimal entre les points d'arrêt. Si cette valeur est comprise entre 0 et 1 (exclus), elle sera interprétée comme une fraction du nombre d'images de la collection. Sinon, il sera interprété comme un nombre d'échantillons.
maxBreaks	Entier, valeur par défaut : 0	Nombre maximal de points d'arrêt.
dateFormat	Entier, valeur par défaut : 1	Représentation temporelle à utiliser dans les résultats : 1 = années fractionnaires, 2 = heure Unix en millisecondes. Cela affecte les valeurs des bandes tStart et tEnd, ainsi que les valeurs "t" utilisées dans le modèle harmonique. Les années fractionnaires utilisées ici et dans ce modèle sont définies comme le nombre fractionnaire d'années de 365,25 jours depuis le 1er janvier 1970.