Appearance

ATANH function ​

Overview ​

ATANH is a function of the Math and Trigonometry category that calculates the inverse hyperbolic tangent (hyperbolic arctangent) of a number in the range (-1, +1), returning the hyperbolic angle expressed in radians.

Usage ​

Syntax ​

ATANH(number) => atanh

Argument descriptions ​

  • number (number, required). The value whose inverse hyperbolic tangent is to be calculated, in the range (-1,+1).

Additional guidance ​

The hyperbolic arctangent function is defined as:

atanh(x)=12ln(1+x1−x),|x|<1

Returned value ​

ATANH returns a real number in the range (-∞, +∞) that is the hyperbolic arctangent of the specified value, expressed in radians.

Error conditions ​

  • In common with many other IronCalc functions, ATANH propagates errors that are found in its argument.
  • If no argument, or more than one argument, is supplied, then ATANH returns the #ERROR! error.
  • If the value of the number argument is not (or cannot be converted to) a number, then ATANH returns the #VALUE! error.
  • If the value of the number argument lies outside the domain (-1, +1), then ATANH 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 ATANH function utilizes the atanh() method provided by the Rust Standard Library.
  • The figure below illustrates the output of the ATANH function.

Examples ​

See some examples in IronCalc.