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:

$$\mathrm{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.
• For more information about the different types of errors that you may encounter when using IronCalc functions, visit our Error Types page.

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\ge 1$ in 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.