log10

常用対数 (10 を底とする)

構文

Y = log10(X)

説明

Y = log10(X) は、配列 X の各要素の常用対数を返します。この関数は、実数入力と複素数入力の両方を受け入れます。区間が (0, Inf) に X の実数値が存在する場合、log10 は、区間 (-Inf ,Inf) の実数値を返します。X の値が複素数および負の実数である場合、関数 log10 は複素数値を返します。

例

スカラーの常用対数値の計算

10 を底とする対数関数のいくつかの値を調べます。

1 の常用対数を計算します。

log10(1)

ans = 
0

結果は 0 で、これが関数 log10 の x 切片です。

10 の常用対数を計算します。

log10(10)

ans = 
1

$$10^1=10$$ のため、結果は 1 になります。

100 の常用対数を計算します。

log10(100)

ans = 
2

$$10^2=100$$ のため、結果は 2 になります。

0 の常用対数を計算します。

log10(0)

ans = 
-Inf

$$10^{-\infty }=0$$ のため、結果は -Inf になります。

実数値の常用対数

区間 [0.5 5] の実数ベクトルを作成します。

X = (0.5:0.5:5)';

X の常用対数を計算します。

Y = log10(X)

Y = 10×1

   -0.3010
         0
    0.1761
    0.3010
    0.3979
    0.4771
    0.5441
    0.6021
    0.6532
    0.6990

複素数値の常用対数

X と Y の 2 つのデカルト格子を作成します。

[X,Y] = meshgrid(0:0.5:1.5,-2:0.5:2);

10 を底とする複素数の対数 $$lo{g}_{10}(X+iY)$$ をグリッド上で計算します。速度の向上と信頼性の高い複素数計算のために 1i を使用します。

Z = log10(X + 1i*Y)

Z = 9×4 complex

   0.3010 - 0.6822i   0.3142 - 0.5758i   0.3495 - 0.4808i   0.3979 - 0.4027i
   0.1761 - 0.6822i   0.1990 - 0.5425i   0.2559 - 0.4268i   0.3266 - 0.3411i
   0.0000 - 0.6822i   0.0485 - 0.4808i   0.1505 - 0.3411i   0.2559 - 0.2554i
  -0.3010 - 0.6822i  -0.1505 - 0.3411i   0.0485 - 0.2014i   0.1990 - 0.1397i
     -Inf + 0.0000i  -0.3010 + 0.0000i   0.0000 + 0.0000i   0.1761 + 0.0000i
  -0.3010 + 0.6822i  -0.1505 + 0.3411i   0.0485 + 0.2014i   0.1990 + 0.1397i
   0.0000 + 0.6822i   0.0485 + 0.4808i   0.1505 + 0.3411i   0.2559 + 0.2554i
   0.1761 + 0.6822i   0.1990 + 0.5425i   0.2559 + 0.4268i   0.3266 + 0.3411i
   0.3010 + 0.6822i   0.3142 + 0.5758i   0.3495 + 0.4808i   0.3979 + 0.4027i

入力引数

X — 入力配列

スカラー | ベクトル | 行列 | 多次元配列 | table | timetable

入力配列。スカラー、ベクトル、行列、多次元配列、table または timetable として指定します。

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

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

log10 関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

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

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

スレッドベースの環境

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

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

GPU 配列

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

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

• GPU で実行される関数の出力が複素数になる可能性がある場合は、入力引数を明示的に複素数として指定しなければなりません。詳細については、GPU 上での複素数の処理 (Parallel Computing Toolbox)を参照してください。

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

分散配列

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

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

バージョン履歴

R2006a より前に導入

R2023a: table および timetable で直接計算を実行

関数 log10 は、table または timetable 内のすべての変数に対して、それらの変数にアクセスするためのインデックス付けを行うことなく計算できます。すべての変数のデータ型で計算がサポートされている必要があります。詳細については、table および timetable での直接計算を参照してください。

参考

exp | log | log2 | logm | loglog | log1p | semilogx | semilogy | reallog