numpy.sqrt

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

Возвращает неотрицательный квадратный корень массива поэлементно.

Параметры:

x : array_like Значения, для которых требуется квадратный корень. out : ndarray, None, or tuple of ndarray and None, optional Расположение, в которое сохраняется результат. Если указано, оно должно иметь форму, к которой векторизуются входные данные. Если не указано или None, возвращается недавно выделенный массив. Кортеж (возможен только в качестве ключевого аргумента) должен иметь длину, равную числу выходов. where : array_like, optional Значения True указывают на то, что нужно вычислить ufunc в данной позиции, значения False указывают на то, что нужно оставить значение в выводе без изменений. **kwargs Для других ключевых аргументов см. документацию по ufunc.

Возвращает:

y : ndarray Массив такой же формы, как x, содержащий положительный квадратный корень каждого элемента в x. Если какой-либо элемент в x является комплексным, возвращается комплексный массив (и вычисляются квадратные корни отрицательных вещественных чисел). Если все элементы в x вещественные, то и y, а отрицательные элементы возвращают nan. Если out был предоставлен, y является ссылкой на него. Это скаляр, если x является скаляром.

См. также

lib.scimath.sqrt

Версия, которая возвращает комплексные числа при задании отрицательных вещественных чисел.

Замечания

sqrt имеет–в соответствии с общей конвенцией–в качестве своей разветвленной точки действительный «интервал» [-inf, 0), и является непрерывной сверху на нем. Разветвленная точка–это кривая в комплексной плоскости, через которую заданная комплексная функция перестает быть непрерывной.

Примеры

>>> 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, numpy.inf])
array([  2.,  NaN,  Inf])