Spec-Zone.ru › NumPy 1.20

numpy.sqrt

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

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

Параметры
xarray_like

Значения, для которых требуются квадратные корни.

outndarray, None, or tuple of ndarray and None, optional

Место, в которое сохраняется результат. Если указано, оно должно иметь форму, к которой векторизуются входные данные. Если не указано или равно None, возвращается свежевыделенный массив. Кортеж (возможен только как ключевой аргумент) должен иметь длину, равную количеству выходов.

wherearray_like, optional

Это условие векторизуется по входным данным. В местах, где условие истинно, массив out будет установлен в результат ufunc. В противном случае массив out сохранит свое исходное значение. Обратите внимание, что если массив out создается через значение по умолчанию out=None, места в нем, где условие ложно, останутся неинициализированными.

**kwargs

Для других ключевых аргументов см. документацию ufunc.

Возвращает
yndarray

Массив той же формы, что и 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, np.inf])
array([ 2., nan, inf])

© 2005–2021 NumPy Developers
Licensed under the 3-clause BSD License.
https://numpy.org/doc/1.20/reference/generated/numpy.sqrt.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API