numpy.sqrt#

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

傳回陣列的非負平方根,逐元素運算。

參數:
x類陣列

需要計算平方根的值。

outndarray、None 或 ndarray 與 None 的 tuple (選用)

儲存結果的位置。如果提供此值,則其形狀必須與輸入廣播到的形狀一致。如果未提供或為 None,則會傳回新配置的陣列。tuple (僅能作為關鍵字引數) 的長度必須等於輸出的數量。

where類陣列, 選用

此條件會廣播到輸入。在條件為 True 的位置,out 陣列將設定為 ufunc 的結果。在其他位置,out 陣列將保留其原始值。請注意,如果透過預設的 out=None 建立未初始化的 out 陣列,則其中條件為 False 的位置將保持未初始化。

**kwargs

關於其他僅限關鍵字的引數,請參閱 ufunc 文件

傳回值:
yndarray

x 形狀相同的陣列,包含 x 中每個元素的正平方根。如果 x 中有任何元素是複數,則會傳回複數陣列 (並計算負實數的平方根)。如果 x 中的所有元素都是實數,則 y 也是實數,負數元素會傳回 nan。如果提供了 out,則 y 是對它的參照。如果 x 是純量,則這會是純量。

另請參閱

emath.sqrt

當給定負實數時,會傳回複數的版本。請注意,對於複數輸入,0.0 和 -0.0 的處理方式不同。

註解

sqrt 依照常見慣例,將實數「區間」[-inf, 0) 作為其分支切割,並在其上方是連續的。分支切割是複數平面中的一條曲線,給定的複數函數沿著這條曲線會變成不連續。

範例

>>> import numpy as np
>>> np.sqrt([1,4,9])
array([ 1.,  2.,  3.])
>>> np.sqrt([4, -1, -3+4J])
array([ 2.+0.j,  0.+1.j,  1.+2.j])
>>> np.sqrt([4, -1, np.inf])
array([ 2., nan, inf])