Pengumuman: Semua project nonkomersial yang terdaftar untuk menggunakan Earth Engine sebelum
15 April 2025 harus
memverifikasi kelayakan nonkomersial untuk mempertahankan akses Earth Engine.
ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menjalankan deteksi titik henti, mirip dengan fungsi strucchange::breakpoints R.
Setiap piksel disesuaikan dengan model harmonik/linear sepotong-sepotong, dalam bentuk
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)) + ...
Dalam persamaan ini, 't' adalah waktu mulai gambar dalam format yang ditentukan oleh 'dateFormat', dan 'season(t)' adalah tahun pecahan waktu mulai tersebut (lihat deskripsi dateFormat untuk mengetahui detailnya). Orde maksimum suku harmonik ditentukan oleh 'seasonalModelOrder'.
Hasilnya adalah gambar yang berisi dua band, ditambah dua band per band dalam input:
tStart, tEnd: masing-masing menyimpan array 1D, dengan satu entri per segmen dalam kecocokan linear sepotong-sepotong; setiap entri berisi waktu mulai gambar pertama atau terakhir dalam segmen tersebut. Secara default, nilai di sini dinyatakan dalam tahun pecahan, agar mudah digunakan dengan koefisien.
coefs_BANDNAME: akan ada satu band output per band input. Setiap elemen ini menyimpan array 2D, dengan satu baris per segmen. Nilai dalam baris tersebut adalah koefisien kecocokan linear untuk segmen tersebut, yaitu nilai A, B, C, ... untuk segmen tersebut. Seperti yang dijelaskan di atas, nilai di sini dipengaruhi oleh 'dateFormat'
.rmse_BANDNAME: akan ada satu band output seperti itu per band input. Array ini menyimpan array 1D, dengan satu entri per segmen. Nilai untuk setiap segmen adalah RMSE untuk residual kecocokan linear untuk segmen tersebut.
| Penggunaan | Hasil |
|---|
ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints(collection, breakpointBand, seasonalModelOrder, minSpacing, maxBreaks, dateFormat) | Gambar |
| Argumen | Jenis | Detail |
|---|
collection | ImageCollection | Kumpulan gambar untuk mendeteksi titik henti sementara. |
breakpointBand | String, default: null | Nama band yang akan digunakan untuk deteksi titik henti sementara. Opsional hanya jika gambar hanya memiliki satu band. |
seasonalModelOrder | Bilangan bulat, default: 3 | Urutan model musiman harmonik. |
minSpacing | Float, default: 0,15 | Jarak minimum antar-titik henti. Jika nilainya antara 0 dan 1 (eksklusif), nilai ini akan ditafsirkan sebagai pecahan dari jumlah gambar dalam koleksi. Jika tidak, nilai akan ditafsirkan sebagai jumlah sampel. |
maxBreaks | Bilangan bulat, default: 0 | Jumlah titik henti sementara maksimum. |
dateFormat | Bilangan bulat, default: 1 | Representasi waktu yang akan digunakan dalam hasil: 1 = tahun pecahan, 2 = waktu Unix dalam milidetik. Hal ini memengaruhi nilai dalam rentang tStart dan tEnd serta nilai 't' yang digunakan dalam model harmonik. Tahun pecahan yang digunakan di sini dan dalam model tersebut ditentukan sebagai bilangan pecahan tahun 365,25 hari sejak 1 Januari 1970. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]
