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)
,逐元素運算。若 x1 或 x2 為純量型 (即,可明確轉換為純量型別),則會廣播以用於另一個引數的每個元素。(請參閱範例)- 參數:
- x1, x2類陣列
三角形的股。若
x1.shape != x2.shape
,則它們必須可廣播為通用形狀 (這會成為輸出的形狀)。- outndarray、None 或 ndarray 和 None 的元組,選用
儲存結果的位置。如果提供,則必須具有輸入廣播到的形狀。如果未提供或為 None,則會傳回新分配的陣列。元組 (僅可作為關鍵字引數) 的長度必須等於輸出的數量。
- where類陣列,選用
此條件會廣播到輸入。在條件為 True 的位置,out 陣列將設定為 ufunc 結果。在其他位置,out 陣列將保留其原始值。請注意,如果透過預設的
out=None
建立未初始化的 out 陣列,則其中條件為 False 的位置將保持未初始化。- **kwargs
對於其他僅限關鍵字引數,請參閱 ufunc 文件。
- 回傳值:
- zndarray
三角形的斜邊。如果 x1 和 x2 都是純量,則這是一個純量。
範例
>>> 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.]])