このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

detrend

多項式のトレンドを削除

構文

y = detrend(x)

y = detrend(x,n)

y = detrend(x,n,bp)

y = detrend(___,nanflag)

y = detrend(___,Name,Value)

説明

y = detrend(x) は、x のデータから最良近似直線を除去します。

• x がベクトルの場合、detrend は x の要素からトレンドを減算。

• x が行列の場合、detrend は各列を個別に処理し、対応する列から各トレンドを減算。

y = detrend(x,n) は、n 次多項式トレンドを除去します。たとえば、n = 0 の場合、detrend は x から平均値を除去します。n = 1 の場合、detrend は線形トレンドを除去し、これは前述の構文と等価です。n = 2 の場合、detrend はニ次トレンドを除去します。

y = detrend(x,n,bp) は、ブレーク ポイント bp で定義されたセグメントでの連続の区分的トレンドを除去します。

y = detrend(___,nanflag) は、前述のいずれかの構文での NaN 値の処理方法を指定します。たとえば、detrend(x,'omitnan') は、トレンドを計算する前に NaN 値を削除しますが、detrend(x,'includenan') にはそれらが含まれます (既定)。

y = detrend(___,Name,Value) は、1 つ以上の名前と値のペアを使用して追加のパラメーターを指定します。たとえば、detrend(x,1,bp,'Continuous',false) は近似トレンドに不連続点があってもよいことを示します。

例

連続の線形トレンド

データのベクトルを作成し、連続の線形トレンドを除去します。元のデータ、トレンド除去後のデータ、および線形トレンドをプロットします。

t = 0:20;
x = 3*sin(t) + t;
y = detrend(x);
plot(t,x,t,y,t,x-y,':k')
legend('Input Data','Detrended Data','Trend','Location','northwest') 

連続の二次トレンド

データのベクトルを作成し、連続の二次トレンドを除去します。元のデータ、トレンド除去後のデータ、およびトレンドをプロットします。

t = 0:20;
x = 20*sin(t) + t.^2;
y = detrend(x,2);
plot(t,x,t,y,t,x-y,':k')
legend('Input Data','Detrended Data','Trend','Location','northwest') 

不連続の線形トレンド

データのベクトルを作成し、ブレーク ポイント 0 を使用して区分的線形トレンドを除去します。結果の出力が不連続であってもよいことを指定します。元のデータ、トレンド除去後のデータ、およびトレンドをプロットします。

t = -10:10;
x = t.^3 + 6*t.^2 + 4*t + 3;
bp = 0;
y = detrend(x,1,bp,'SamplePoints',t,'Continuous',false);
plot(t,x,t,y,t,x-y,':k')
legend('Input Data','Detrended Data','Trend','Location','northwest') 

入力引数

x — 入力配列

ベクトル | 行列 | 多次元配列

入力配列。ベクトル、行列または多次元配列として指定します。x が多次元配列の場合、detrend はすべての次元にわたって列方向に動作します。

データ型: double | single
複素数のサポート: あり

n — 多項式の次数

非負の整数スカラー | 'constant' | 'linear'

多項式の次数。非負の整数スカラーとして、あるいは 'constant' (0 と等価) または 'linear' (1 と等価) として指定します。

bp — ブレーク ポイント

ベクトル

データの区分的セグメントを定義するブレーク ポイント。次のいずれかを含むベクトルとして指定します。

• ブレーク ポイントの位置を示すサンプル点の値。サンプル点の値は、既定のサンプル点ベクトル [1 2 3 ...]、または 'SamplePoints' パラメーターで指定されるベクトルに格納されます。

• logical 値。ここで、logical 1 (true) は、入力データの対応する要素にブレーク ポイントがあることを示します。bp が logical 値を含む場合、サンプル点と同じ長さでなければなりません。

ブレーク ポイントは、データのセグメントごとに別々のトレンドを計算する場合に便利です。

データ型: double | single | datetime | duration | logical

nanflag — NaN の条件

'includenan' (既定値) | 'omitnan'

NaN の条件。次の値のいずれかとして指定します。

• 'includenan' — トレンドを計算するときに、入力データに NaN 値を含めます。

• 'omitnan' — トレンドを計算するときに、入力のすべての NaN 値を無視します。

名前と値のペアの引数

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。

例: y = detrend(x,'SamplePoints',1:10:1000)

Continuous — 連続性の制約

true (既定値) | false

連続性の制約。'Continuous' と、次のいずれかで構成されるコンマ区切りのペアとして指定します。

• true — 近似トレンドはすべての位置で連続でなければなりません。

• false — 近似トレンドは不連続点を含むことができます。

SamplePoints — サンプル点

[1 2 3 ...] (既定値) | ベクトル

サンプル点。'SamplePoints' とベクトルで構成されるコンマ区切りのペアとして指定します。サンプル点は入力データの x 軸上の位置を表し、一意かつ順に並べ替えられていなければなりません。

データ型: double | single | datetime | duration

拡張機能

C/C++ コード生成

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

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

• 入力引数 bp が提供されているものの、logical ではない場合、引数は昇順で並べ替えなければなりません。

• 入力引数 bp が提供されているものの、可変サイズが無効な場合は、引数の区間 [1,m-2] に整数が含まれていなければなりません。この場合、m は入力引数 x の列の要素数であるか、x が行ベクトル (m = length(x)) の場合は x の要素数です。

• 'SamplePoints' パラメーターの値が提供されている場合は、可変サイズが必要です。

• 多項式の次数 n が定数でも logical でもない場合は、可変サイズが必要です。

• コード生成では、MATLAB^® とは異なる方法を使用して、一意ではない問題や悪条件の問題を検出し、警告を表示します。コード生成の警告は、MATLAB の警告と常に一致するわけではありません。

• 関数 detrend は、コード生成で rand を使用しません。

GPU 配列

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

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

参考

polyfit | トレンドの除去

トピック

• データのトレンド除去

R2006a より前に導入

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい