2.7 KiB
2.7 KiB
layout, outline, lang
| layout | outline | lang |
|---|---|---|
| doc | deep | en-US |
ACOSH function
Overview
ACOSH is a function of the Math and Trigonometry category that calculates the inverse hyperbolic cosine (hyperbolic arccosine) of a number, returning a non-negative value in the range [0, +∞).
Usage
Syntax
ACOSH(number) => acosh
Argument descriptions
- number (number, required). The value whose hyperbolic arccosine is to be calculated. The value must be greater than or equal to 1.
Additional guidance
The hyperbolic arccosine function is defined as:
\operatorname{acosh}(x) = \ln(x + \sqrt{x^2 - 1})
Returned value
ACOSH returns a number in the range [0, +∞) that is the hyperbolic arccosine of the specified value, expressed in radians.
Error conditions
- In common with many other IronCalc functions, ACOSH propagates errors that are found in its argument.
- If no argument, or more than one argument, is supplied, then ACOSH returns the
#ERROR!error. - If the value of the number argument is not (or cannot be converted to) a number, then ACOSH returns the
#VALUE!error. - If the value of the number argument is less than 1, then ACOSH returns the
#NUM!error.
Details
- The ACOSH function utilizes the acosh() method provided by the Rust Standard Library.
- The figure below illustrates the output of the ACOSH function for values
x \geq 1in the range [0, +∞).
Examples
See some examples in IronCalc.
Links
- For more information about inverse hyperbolic functions, visit Wikipedia's Inverse hyperbolic functions page.
- See also IronCalc's COSH, ASINH and ATANH functions.
- Visit Microsoft Excel's ACOSH function page.
- Both Google Sheets and LibreOffice Calc provide versions of the ACOSH function.