numpy.cbrt
numpy.cbrt(x, *ufunc_args) = <ufunc 'cbrt'>
Функция 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.
Примеры
>>> 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])