Функция arccosh

Функция arccosh вычисляет обратный гиперболический косинус (иногда называемый area hyperbolic cosine) для каждого элемента массива. Она принимает на вход массив чисел и возвращает новый массив с вычисленными значениями. Входные значения должны быть вещественными числами больше или равными 1, так как область определения обратного гиперболического косинуса - это [1, ∞). Для комплексных чисел функция определена для всей комплексной плоскости, но в стандартной практике работы с NumPy обычно используются вещественные числа.

Синтаксис

np.arccosh(x, out=None, where=True)

Основным параметром является x - массив или скалярное значение, для которого требуется вычислить обратный гиперболический косинус. Дополнительные параметры: out - место для сохранения результата и where - условие для вычисления (по умолчанию вычисления выполняются для всех элементов).

Пример

Давайте вычислим обратный гиперболический косинус для нескольких чисел:

import numpy as np

arr = np.array([1, 2, 3, 4, 5])
res = np.arccosh(arr)
print(res)

Результат выполнения кода:

[0. 1.3169579 1.76274717 2.06343707 2.29243167]

Пример

Функцию arccosh можно применять к многомерным массивам. Вычислим значения для двумерного массива:

import numpy as np

arr = np.array([[1, 2, 3], [4, 5, 6]])
res = np.arccosh(arr)
print(res)

Результат выполнения кода:

[[0.		 1.3169579  1.76274717]
 [2.06343707 2.29243167 2.47788873]]

Пример

При работе с числами меньше 1 функция возвращает nan (Not a Number), что указывает на недопустимое значение для вещественной области определения. Для чисел, равных 1, результат будет равен 0:

import numpy as np

arr = np.array([0.5, 1.0, 1.5, 2.0])
res = np.arccosh(arr)
print(res)

Результат выполнения кода:

[nan 0. 0.96242365 1.3169579 ]

Пример

С помощью параметра out можно сохранить результат в заранее созданный массив. Это полезно для экономии памяти при работе с большими объемами данных:

import numpy as np

arr = np.array([1, 2, 3, 4, 5])
out_arr = np.empty_like(arr, dtype=np.float64)
np.arccosh(arr, out=out_arr)
print(out_arr)

Результат выполнения кода:

[0. 1.3169579 1.76274717 2.06343707 2.29243167]

Смотрите также

функцию cosh,
которая вычисляет гиперболический косинус для каждого элемента массива
функцию arcsinh,
которая вычисляет обратный гиперболический синус для каждого элемента массива
функцию arctanh,
которая вычисляет обратный гиперболический тангенс для каждого элемента массива
функцию sinh,
которая вычисляет гиперболический синус для каждого элемента массива