Annuncio: tutti i progetti non commerciali registrati per l'utilizzo di Earth Engine prima del
15 aprile 2025 devono
verificare l'idoneità non commerciale per mantenere l'accesso a Earth Engine.
ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Esegue il rilevamento dei punti di interruzione, in modo simile alla funzione strucchange::breakpoints di R.
Ogni pixel viene adattato a un modello lineare/armonico piecewise, della forma
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)) + ...
In questa equazione, "t" è l'ora di inizio dell'immagine nel formato specificato da "dateFormat" e "season(t)" è l'anno frazionario di quell'ora di inizio (vedi la descrizione di dateFormat per i dettagli). L'ordine massimo dei termini armonici è determinato da "seasonalModelOrder".
Il risultato è un'immagine contenente due bande, più due bande per banda nell'input:
tStart
, tEnd
: ognuno di questi contiene un array 1D, con una voce per segmento nell'adattamento lineare a tratti; ogni voce contiene l'ora di inizio della prima o dell'ultima immagine in quel segmento. Per impostazione predefinita, i valori sono espressi in anni frazionari, per facilitare l'utilizzo con i coefficienti.
coefs_BANDNAME
: ci sarà una banda di output per ogni banda di input. Ognuna contiene una matrice 2D, con una riga per segmento. I valori in quella riga sono i coefficienti dell'adattamento lineare per quel segmento, ovvero i valori di A, B, C e così via per quel segmento. Come descritto sopra, i valori qui sono influenzati da "dateFormat".
.rmse_BANDNAME
: ci sarà una banda di output per ogni banda di input. Contiene un array 1D con una voce per segmento. Il valore di ogni segmento è l'RMSE dei residui dell'adattamento lineare per quel segmento.
Utilizzo | Resi |
---|
ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints(collection, breakpointBand, seasonalModelOrder, minSpacing, maxBreaks, dateFormat) | Immagine |
Argomento | Tipo | Dettagli |
---|
collection | ImageCollection | Raccolta di immagini su cui rilevare i punti di interruzione. |
breakpointBand | Stringa, valore predefinito: null | Il nome della band da utilizzare per il rilevamento dei punti di interruzione. Facoltativo solo se le immagini hanno una sola banda. |
seasonalModelOrder | Numero intero, valore predefinito: 3 | L'ordine del modello stagionale armonico. |
minSpacing | Float, valore predefinito: 0,15 | La spaziatura minima tra i breakpoint. Se questo valore è compreso tra 0 e 1 (escluso), verrà interpretato come una frazione del numero di immagini nella raccolta. In caso contrario, verrà interpretato come numero di campioni. |
maxBreaks | Numero intero, valore predefinito: 0 | Il numero massimo di punti di interruzione. |
dateFormat | Numero intero, valore predefinito: 1 | La rappresentazione del tempo da utilizzare nei risultati: 1 = anni frazionari, 2 = ora Unix in millisecondi. Ciò influisce sui valori nelle bande tStart e tEnd e sui valori "t" utilizzati nel modello armonico. Gli anni frazionari utilizzati qui e in questo modello sono definiti come il numero frazionario di anni di 365,25 giorni a partire dal 1° gennaio 1970. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 2025-07-26 UTC."],[[["\u003cp\u003eDetects breakpoints in an image collection using a piecewise linear/harmonic model, similar to R's \u003ccode\u003estrucchange::breakpoints\u003c/code\u003e function.\u003c/p\u003e\n"],["\u003cp\u003eOutputs an image with bands indicating breakpoint start/end times, model coefficients for each segment, and RMSE for each segment's fit.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of the harmonic model's order, minimum breakpoint spacing, maximum number of breakpoints, and time representation format.\u003c/p\u003e\n"],["\u003cp\u003eUses a model that incorporates a linear trend and seasonal harmonics to fit pixel values over time.\u003c/p\u003e\n"],["\u003cp\u003eThe algorithm identifies the optimal breakpoints by minimizing the residual error of the piecewise model.\u003c/p\u003e\n"]]],["The function `StructuralChangeBreakpoints` detects breakpoints in an image collection, fitting each pixel with a piecewise linear/harmonic model. Input parameters include `collection`, `breakpointBand`, `seasonalModelOrder`, `minSpacing`, `maxBreaks`, and `dateFormat`. The output image contains `tStart` and `tEnd` bands, which hold segment start and end times. Additionally, there are `coefs_BANDNAME` bands, that contain linear fit coefficients and `rmse_BANDNAME` bands with the root-mean-square error for each segment.\n"],null,["# ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints\n\nRuns breakpoint detection, similar to R's strucchange::breakpoints function.\n\n\u003cbr /\u003e\n\nEach pixel is fit by a piecewise linear/harmonic model, of the form\n\nY = 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)) + ...\n\nIn this equation, 't' is the start time of the image in the format specified by 'dateFormat', and 'season(t)' is the fractional year of that start time (see the description of dateFormat for details). The maximum order of the harmonic terms is determined by 'seasonalModelOrder'.\n\nThe result is an image containing two bands, plus two bands per band in the input:\n\n`tStart`, `tEnd`: each of these holds a 1D array, with one entry per segment in the piecewise linear fit; each entry contains the start time of the first or last images in that segment. By default the values here are in fractional years, for easy use with the coefficients.\n\n`coefs_BANDNAME`: there will be one such output band per input band. Each of these holds a 2D array, with one row per segment. The values in that row are the coefficients of the linear fit for that segment - that is, the values of A, B, C, ... for that segment. As described above, the values here are affected by 'dateFormat'\n\n.`rmse_BANDNAME`: there will be one such output band per input band. This holds a 1D array, with one entry per segment. The value for each segment is the RMSE for the linear fit residuals for that segment.\n\n| Usage | Returns |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|\n| `ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints(collection, `*breakpointBand* `, `*seasonalModelOrder* `, `*minSpacing* `, `*maxBreaks* `, `*dateFormat*`)` | Image |\n\n| Argument | Type | Details |\n|----------------------|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `collection` | ImageCollection | Collection of images on which to detect breakpoints. |\n| `breakpointBand` | String, default: null | The name of the band to use for breakpoint detection. Optional only if the images have only a single band. |\n| `seasonalModelOrder` | Integer, default: 3 | The order of the harmonic seasonal model. |\n| `minSpacing` | Float, default: 0.15 | The minimum spacing between breakpoints. If this is between 0 and 1 (exclusive), it will be interpreted as a fraction of the number of images in the collection. Otherwise, it will be interpreted as a number of samples. |\n| `maxBreaks` | Integer, default: 0 | The maximum number of breakpoints. |\n| `dateFormat` | Integer, default: 1 | The time representation to use in the results: 1 = fractional years, 2 = unix time in milliseconds. This affects the values in the tStart and tEnd bands and the 't' values used in the harmonic model. The fractional years used here and in that model are defined as the fractional number of 365.25-day years since 1 Jan 1970. |"]]