numpy.log#

numpy.log(x, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature]) = <ufunc 'log'>#

逐元素自然對數。

自然對數 log 是指數函數的反函數，因此 log(exp(x)) = x。自然對數是以 e 為底的對數。

參數:

x陣列型 (array_like): 輸入值。
outndarray、None 或 ndarray 與 None 的元組，選用: 結果儲存的位置。如果提供，則必須具有輸入廣播到的形狀。如果未提供或為 None，則會返回新分配的陣列。元組（僅可作為關鍵字參數）的長度必須等於輸出數量。
where陣列型 (array_like)，選用: 此條件會廣播到輸入。在條件為 True 的位置，out 陣列將設定為 ufunc 結果。在其他位置，out 陣列將保留其原始值。請注意，如果透過預設 out=None 建立未初始化的 out 陣列，則條件為 False 的位置將保持未初始化。
**kwargs: 對於其他僅限關鍵字的參數，請參閱 ufunc 文件。

返回:

參見

註解

對數是一個多值函數：對於每個 x，都有無限多個 z 使得 exp(z) = x。慣例是返回虛部在 (-pi, pi] 範圍內的 z。

對於實值輸入資料類型，log 始終返回實數輸出。對於每個不能表示為實數或無窮大的值，它會產生 nan 並設定 invalid 浮點錯誤標誌。

對於複數值輸入，log 是一個複數解析函數，它具有分支切割 [-inf, 0] 並且在其上從上方連續。log 將浮點負零處理為無窮小的負數，符合 C99 標準。

在輸入具有負實部和非常小的負虛部（接近 0）的情況下，結果非常接近 -pi，以至於它評估為正好 -pi。

參考文獻

[1]

M. Abramowitz and I.A. Stegun, “Handbook of Mathematical Functions”, 10th printing, 1964, pp. 67. https://personal.math.ubc.ca/~cbm/aands/page_67.htm

[2]

範例

>>> import numpy as np
>>> np.log([1, np.e, np.e**2, 0])
array([  0.,   1.,   2., -inf])