最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

detrend

線形トレンドを除去

構文

y = detrend(x)
y = detrend(x,'constant')
y = detrend(x,'linear',bp)


説明

関数 detrend は、ベクトルまたは行列から、平均値または線形トレンドを除去します。これらは、通常、FFT の前処理で使用します。

y = detrend(x) は、ベクトル x から最適な直線近似を行い、それを除去し、結果を y に返します。x が行列の場合、関数 detrend は、各列単位に処理します。

y = detrend(x,'constant') は、平均値をベクトル x から除去します。x が行列の場合は、行列の各列から除去します。

y = detrend(x,'linear',bp) は、連続する区分的線形トレンドをベクトル x から除去します。x が行列の場合は、行列の各列から除去します。ベクトル bp は、隣接する線形セグメント間のブレークポイントのインデックスを含んでいます。2 つのセグメント間のブレークポイントは、2 つのセグメントが共有するデータ点として定義されます。

detrend(x,'linear') は、ブレークポイント ベクトルを定義していない場合、detrend(x) と同じです。

例

sig = [0 1 -2 1 0 1 -2 1 0];      % signal with no linear trend
trend = [0 1 2 3 4 3 2 1 0];      % two-segment linear trend
x = sig+trend;                    % signal with added trend
y = detrend(x,'linear',5)         % breakpoint at 5th element

y =

   -0.0000
    1.0000
   -2.0000
    1.0000
    0.0000
    1.0000
   -2.0000
    1.0000
   -0.0000

ブレークポイントを 5 番目の要素で設定していることに注意してください。この点は、2 つのセグメントが共有する点です。

アルゴリズム

関数 detrend は、データに対する直線の最小二乗近似 (または、区分的線形トレンドから構成するライン) を計算し、データから結果の関数を引きます。直線近似の方程式を得るには、polyfit を使います。

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意事項および制限事項:

• 空でない入力引数 bp を指定する場合、次の要件を満たさなければなりません。

  • 実数であること。

  • 昇順に並べ替えられていること。

  • 要素は区間 [1, n-2] 内の整数に限定すること。n は入力引数 X の列の要素数または X が行ベクトルの場合は、X の要素数です。

  • すべて一意の値を含んでいること。

• ツールボックス関数のコード生成に対する可変サイズの制限 (MATLAB Coder)を参照してください。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

この関数は GPU 配列を完全にサポートしています。詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

参考

polyfit

R2006a より前に導入