downsample

整数係数によるサンプル レートの低減

構文

y = downsample(x,n)

y = downsample(x,n,phase)

説明

y = downsample(x,n) は、最初のサンプルと以降の n 個ごとのサンプルを残すことで x のサンプル レートを低減させます。x が行列の場合、この関数は各列を個別シーケンスとして扱います。

y = downsample(x,n,phase) では、ダウンサンプルしたシーケンスをオフセットするサンプル数が指定されます。

例

サンプル レートの低減

シーケンスのサンプル レートを係数 3 で減少させます。

x = [1 2 3 4 5 6 7 8 9 10];
y = downsample(x,3)

y = 1×4

     1     4     7    10

シーケンスのサンプル レートを係数 3 で減少させ、位相オフセット 2 を適用します。

y = downsample(x,3,2)

y = 1×3

     3     6     9

行列のサンプル レートを係数 3 で減少させます。

x = [1  2  3;
     4  5  6;
     7  8  9;
    10 11 12];
y = downsample(x,3)

y = 2×3

     1     2     3
    10    11    12

入力引数

x — 入力配列

ベクトル | 行列

入力配列。ベクトルまたは行列として指定します。x が行列の場合、この関数は列を独立チャネルとして扱います。

例: cos(pi/4*(0:159)) + randn(1,160) は、ホワイト ガウス ノイズに含まれる正弦波を指定します。

例: cos(pi./[4;2]*(0:159))' + randn(160,2) では 2 チャネルのノイズを含んだ正弦波を指定します。

n — ダウンサンプリング係数

正の整数

ダウンサンプリング係数。正の整数で指定します。

データ型: single | double

phase — オフセット

0 (既定値) | 正の整数

オフセット。0 から n – 1 までの正の整数で指定します。

データ型: single | double

出力引数

y — ダウンサンプリングされた配列

ベクトル | 行列

ダウンサンプリングされた配列。ベクトルまたは行列として返されます。

拡張機能

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

GPU コード生成
GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

GPU 配列

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

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

バージョン履歴

R2006a より前に導入

R2024a: downsample は GPU コード生成をサポートする

関数 downsample は、グラフィックス処理装置 (GPU) 用のコード生成をサポートします。CUDA^® コードを生成するには、MATLAB^® Coder™ および GPU Coder™ が必要です。

参考

decimate | interp | interp1 | resample | spline | upfirdn | upsample