scipp.acosh

scipp.acosh(x, *, out=None)

Element-wise inverse hyperbolic cosine.

The input unit must be dimensionless and values must be >= 1.

Parameters:

• x (scipp.typing.VariableLike) – Input data.

• out (Optional[TypeVar(VariableLikeType, Variable, DataArray, Dataset, DataGroup[Any])], default: None) – Optional output buffer.

Returns:

Same type as input – The inverse hyperbolic cosine values of the input.

Examples

Compute the inverse hyperbolic cosine:

>>> import scipp as sc
>>> x = sc.array(dims=['x'], values=[1.0, 2.0, 3.0])
>>> sc.acosh(x)
<scipp.Variable> (x: 3)    float64  [dimensionless]  [0, 1.31696, 1.76275]

The domain is [1, ∞), and acosh(1) = 0.