お知らせ:
2025 年 4 月 15 日より前に Earth Engine の使用を登録したすべての非商用プロジェクトは、Earth Engine へのアクセスを維持するために
非商用目的での利用資格を確認する必要があります。
ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
R の strucchange::breakpoints 関数と同様に、ブレークポイント検出を実行します。
各ピクセルは、次の形式の区分的線形/調和モデルで適合されます。
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 によって決まります。
結果は、2 つのバンドと、入力のバンドごとに 2 つのバンドを含む画像になります。
tStart、tEnd: それぞれが 1 次元配列を保持します。区分線形フィットのセグメントごとに 1 つのエントリがあります。各エントリには、そのセグメントの最初または最後の画像の開始時間が含まれます。デフォルトでは、係数で簡単に使用できるように、値は年単位の分数で表されます。
coefs_BANDNAME: 入力バンドごとに 1 つの出力バンドがあります。それぞれが 2 次元配列を保持し、セグメントごとに 1 行が含まれます。その行の値は、そのセグメントの線形適合の係数（そのセグメントの A、B、C などの値）です。前述のとおり、ここでの値は dateFormat の影響を受けます。
.rmse_BANDNAME: 入力バンドごとに 1 つの出力バンドがあります。これは 1D 配列を保持し、セグメントごとに 1 つのエントリがあります。各セグメントの値は、そのセグメントの線形適合残差の 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」の値に影響します。ここで使用される年数（小数）は、1970 年 1 月 1 日からの 365.25 日の年数の小数として定義されます。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-26 UTC。
[null,null,["最終更新日 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. |"]]
