numpy.hypot#

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

給定直角三角形的「兩股」,回傳斜邊。

等同於 sqrt(x1**2 + x2**2),逐元素運算。若 x1x2 為純量型 (即,可明確轉換為純量型別),則會廣播以用於另一個引數的每個元素。(請參閱範例)

參數:
x1, x2類陣列

三角形的股。若 x1.shape != x2.shape,則它們必須可廣播為通用形狀 (這會成為輸出的形狀)。

outndarray、None 或 ndarray 和 None 的元組,選用

儲存結果的位置。如果提供,則必須具有輸入廣播到的形狀。如果未提供或為 None,則會傳回新分配的陣列。元組 (僅可作為關鍵字引數) 的長度必須等於輸出的數量。

where類陣列,選用

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

**kwargs

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

回傳值:
zndarray

三角形的斜邊。如果 x1x2 都是純量,則這是一個純量。

範例

>>> import numpy as np
>>> np.hypot(3*np.ones((3, 3)), 4*np.ones((3, 3)))
array([[ 5.,  5.,  5.],
       [ 5.,  5.,  5.],
       [ 5.,  5.,  5.]])

範例展示純量型引數的廣播

>>> np.hypot(3*np.ones((3, 3)), [4])
array([[ 5.,  5.,  5.],
       [ 5.,  5.,  5.],
       [ 5.,  5.,  5.]])