このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

logspace

対数的に等間隔なベクトルの作成

構文

y = logspace(a,b)

y = logspace(a,b,n)

y = logspace(a,pi)

y = logspace(a,pi,n)

説明

y = logspace(a,b) は、10^a と 10^b の間で対数的に等間隔な 50 点の行ベクトル y を作成します。関数 logspace は、特に周波数ベクトルの作成に便利です。この関数は linspace や ‘:’ 演算子を対数的にしたものです。

y = logspace(a,b,n) は、10^a と 10^b の間で n 個の点を生成します。

y = logspace(a,pi) は、10^a と pi の間に 50 点を生成するため、デジタル信号処理で区間 [10^a,pi] 内で対数的に等間隔な周波数を作成する場合に便利です。

y = logspace(a,pi,n) は、10^a と pi の間に n 個の点を作成します。

例

対数的に等間隔な数値のベクトル

区間 [10^1,10^5] 内で対数的に等間隔な 50 個の点のベクトルを作成します。

y = logspace(1,5);

指定された数の値を含むベクトル

区間 [10^1,10^5] 内で対数的に等間隔な 7 個の点のベクトルを作成します。

y1 = logspace(1,5,7)

y1 = 1×7
105 ×

    0.0001    0.0005    0.0022    0.0100    0.0464    0.2154    1.0000

対数的に等間隔な複素数のベクトル

10^(1+2i) および 10^(5+5i) の間で対数的に等間隔な 8 個の点をもつ複素数のベクトルを作成します。

y = logspace(1+2i,5+5i,8)

y = 1×8 complex
104 ×

  -0.0001 - 0.0010i   0.0029 - 0.0024i   0.0133 + 0.0040i   0.0147 + 0.0497i  -0.1242 + 0.1479i  -0.7150 - 0.0822i  -1.2137 - 2.3924i   4.9458 - 8.6913i

入力引数

a — 最初の限界

数値スカラー

最初の限界。数値スカラーとして指定します。引数 a は、logspace が点を生成する区間の片方の限界を定義します。a には実数または複素数を指定でき、もう一方の限界 b は、a より大きい値または小さい値に設定できます。b が a より小さい場合、ベクトルには降順で値が格納されます。

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

b — 2 番目の限界

数値スカラー

2 番目の限界。数値スカラーとして指定します。引数 b は、logspace が点を生成する区間の片方の限界を定義します。b には実数または複素数を指定できます。b は a より大きい値または小さい値に設定できます。b が a より小さい場合、ベクトルには降順で値が格納されます。

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

n — 点の数

50 (既定値) | 実数の数値スカラー

点の数。実数の数値スカラーとして指定します。

• n が 1 の場合は、logspace は 10^b を返します。

• n がゼロまたは負値の場合、logspace は空の行ベクトルを返します。

• n が整数でない場合、logspace は n を負方向に丸めて floor(n) 個の点を返します。

拡張機能

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

スレッドベースの環境

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

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

GPU 配列

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

logspace 関数は GPU 配列入力をサポートしますが、次の使用上の注意および制限があります。

• この関数を GPU で実行し、gpuArray 出力を取得するには、以下のいずれかの構文を使用します。

  y = gpuArray.logspace(a,b)
  y = gpuArray.logspace(a,b,n)
  y = gpuArray.logspace(a,pi)
  y = gpuArray.logspace(a,pi,n)

• あるいは、gpuArray として a、b、または pi を指定することもできます。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

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

• logspace の分散バージョンを呼び出すには distributed.logspace を使用します。

詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a より前に導入

参考

linspace | colon