numpy.cbrt

numpy.cbrt(x, *ufunc_args) = <ufunc 'cbrt'>

Функция numpy.cbrt() возвращает кубический корень элементов массива.

Данная функция эквивалентна команде x**(1/3).

Однако, numpy.cbrt() является универсальной функцией, т.е. поддерживает целый ряд параметров, которые позволяют оптимизировать ее работу в зависимости от специфики алгоритма, в котором она необходима.

Параметры:
x - число, массив или подобный массиву объект
Входные данные.
*ufunc_args - аргументы универсальной функции
Аргументы, позволяющие настроить и оптимизировать работу функции (подробнее см. универсальные функции).
Возвращает:
результат - массив NumPy или вещественное число
Массив вычисленных кубических корней элементов из x или число, если на вход подано одно число.

Замечание

Не смотря на то, что кубический корень определен для комплексных чисел, данная функция его не вычисляет. Для комплексных x можно воспользоваться функцией np.power(x, 1/3)

>>> np.power(1 + 1j, 1/3)
(1.0842150814913512+0.2905145555072514j)
>>> 

Доступно в NumPy с версии 1.10.0.

Смотрите так же: power, float_power, sqrt

Примеры

>>> import numpy as np
>>> 
>>> np.cbrt([-8, -1, 27, 64])
array([-2., -1.,  3.,  4.])
>>> 
>>> np.cbrt([-np.inf, 0.001, 2, np.inf, np.nan])
array([      -inf, 0.1       , 1.25992105,        inf,        nan])