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 的元组, 可选: 结果存储的位置。如果提供，其形状必须与输入广播后的形状兼容。如果未提供或为 None，则返回一个新分配的数组。元组（只能作为关键字参数）的长度必须等于输出的数量。
where类数组对象, 可选: 此条件将广播到输入上。在条件为 True 的位置，out 数组将设置为 ufunc 结果。在其他位置，out 数组将保留其原始值。请注意，如果通过默认的 out=None 创建了一个未初始化的 out 数组，则其中条件为 False 的位置将保持未初始化状态。
**kwargs: 有关其他仅关键字参数，请参阅 ufunc 文档。

返回:

yndarray: 与 x 形状相同的数组，包含 x 中每个元素的正平方根。如果 x 中任一元素是复数，则返回一个复数数组（并计算负实数的平方根）。如果 x 中的所有元素都是实数，则 y 也是实数，其中负元素返回 nan。如果提供了 out，则 y 是对其的引用。如果 x 是标量，则结果也是标量。

另请参阅

备注

根据惯例，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])