rssq

二乗和平方根レベル

構文

y = rssq(x)

y = rssq(x,dim)

説明

y = rssq(x) は、入力配列 x の二乗和平方根 (RSS) レベル y を返します。x が行ベクトルまたは列ベクトルの場合、y は実数値のスカラーになります。x が複数次元配列である場合、rssq は、サイズが 1 より大きい最初の配列次元に沿って動作します。

y = rssq(x,dim) は、次元 dim に沿って x の RSS レベルを計算します。

例

正弦波の RSS レベル

1 kHz でサンプリングされた 100 Hz の正弦波の RSS レベルを計算します。

t = 0:0.001:1-0.001;
x = cos(2*pi*100*t);

y = rssq(x)

y = 
22.3607

2 次元行列の RSS レベル

各列が、1 kHz でサンプリングされた異なる振幅をもつ 100 Hz の正弦波である行列を作成します。振幅は列のインデックスと等しくなります。

列の RSS レベルを計算します。

t = 0:0.001:1-0.001;
x = cos(2*pi*100*t)'*(1:4);

y = rssq(x)

y = 1×4

   22.3607   44.7214   67.0820   89.4427

指定された次元に沿った 2 次元行列の RSS レベル

各行が、1 kHz でサンプリングされた異なる振幅をもつ 100 Hz の正弦波である行列を作成します。振幅は行のインデックスと等しくなります。

引数 dim で次元を指定して、行の RSS レベルを計算します。

t = 0:0.001:1-0.001;
x = (1:4)'*cos(2*pi*100*t);

y = rssq(x,2)

y = 4×1

   22.3607
   44.7214
   67.0820
   89.4427

入力引数

x — 入力配列

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

入力配列。ベクトル、行列、または N 次元配列として指定します。

例: cos(2*pi*100*(0:0.001:1-0.001)) は、1 kHz で 1 秒間サンプリングされた正弦波を指定します。

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

dim — 動作する対象の次元

正の整数スカラー

動作する対象の次元。正の整数スカラーとして指定します。

データ型: single | double

出力引数

y — 二乗和平方根レベル

スカラー | ベクトル | 行列 | N 次元配列

二乗和平方根レベル。スカラー、ベクトル、行列または N 次元配列として返されます。

詳細

二乗和平方根レベル

ベクトル x の二乗和平方根 (RSS) レベルは次のとおりです。

$$x_{\text{RSS}}=\sqrt{{\displaystyle \sum _{n=1}^N{\left|x_n\right|}^2}},$$

指定された次元に沿って加算が実行されます。RSS レベルは 2 ノルムとも呼ばれています。

参照

[1] IEEE^® Standard on Transitions, Pulses, and Related Waveforms, IEEE Standard 181, 2003.

拡張機能

C/C++ コード生成

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

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

• dim を指定する場合、定数でなければなりません。

• 可変サイズ入力に関連した制限については、既定の次元の選択に関する MATLAB との非互換性 (MATLAB Coder)を参照してください。

• コード生成では、この関数のスパース行列入力はサポートされません。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数は、スレッドベースの環境を完全にサポートします。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

GPU 配列

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

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

バージョン履歴

R2012a で導入

R2023a: gpuArray オブジェクトの使用

関数 rssq は gpuArray オブジェクトをサポートしています。この機能を使用するには、Parallel Computing Toolbox™ が必要です。

参考

mean | peak2peak | peak2rms | rms | std