Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de
15 de abril de 2025 precisam
verificar a qualificação não comercial para manter o acesso ao Earth Engine.
ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Executa a detecção de pontos de interrupção, semelhante à função strucchange::breakpoints do R.
Cada pixel é ajustado por um modelo linear/harmônico em trechos, da 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)) + ...
Nessa equação, "t" é o horário de início da imagem no formato especificado por "dateFormat", e "season(t)" é o ano fracionário desse horário de início. Consulte a descrição de "dateFormat" para mais detalhes. A ordem máxima dos termos harmônicos é determinada por "seasonalModelOrder".
O resultado é uma imagem com duas bandas, além de duas bandas por banda na entrada:
tStart, tEnd: cada um deles contém uma matriz 1D, com uma entrada por segmento no ajuste linear por partes. Cada entrada contém o horário de início da primeira ou da última imagem nesse segmento. Por padrão, os valores aqui estão em anos fracionários para facilitar o uso com os coeficientes.
coefs_BANDNAME: haverá uma banda de saída para cada banda de entrada. Cada um deles contém uma matriz 2D, com uma linha por segmento. Os valores nessa linha são os coeficientes do ajuste linear para esse segmento, ou seja, os valores de A, B, C etc. para esse segmento. Conforme descrito acima, os valores aqui são afetados por "dateFormat".
.rmse_BANDNAME: haverá uma banda de saída para cada banda de entrada. Ela contém uma matriz 1D, com uma entrada por segmento. O valor de cada segmento é o RMSE dos resíduos de ajuste linear desse segmento.
| Uso | Retorna |
|---|
ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints(collection, breakpointBand, seasonalModelOrder, minSpacing, maxBreaks, dateFormat) | Imagem |
| Argumento | Tipo | Detalhes |
|---|
collection | ImageCollection | Coleção de imagens em que os pontos de interrupção serão detectados. |
breakpointBand | String, padrão: null | O nome da faixa a ser usada para detecção de ponto de interrupção. Opcional apenas se as imagens tiverem uma única banda. |
seasonalModelOrder | Número inteiro, padrão: 3 | A ordem do modelo harmônico sazonal. |
minSpacing | Ponto flutuante, padrão: 0,15 | O espaçamento mínimo entre os pontos de interrupção. Se estiver entre 0 e 1 (exclusivo), será interpretado como uma fração do número de imagens na coleção. Caso contrário, ele será interpretado como um número de amostras. |
maxBreaks | Número inteiro, padrão: 0 | O número máximo de pontos de interrupção. |
dateFormat | Número inteiro, padrão: 1 | A representação de tempo a ser usada nos resultados: 1 = anos fracionários, 2 = tempo Unix em milissegundos. Isso afeta os valores nas faixas tStart e tEnd e os valores "t" usados no modelo harmônico. Os anos fracionários usados aqui e nesse modelo são definidos como o número fracionário de anos de 365,25 dias desde 1º de janeiro de 1970. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 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. |"]]
