s Chapter Contents
s Chapter Introduction
NAG C Library Manual

NAG Library Function Documentnag_arctanh (s11aac)

1  Purpose

nag_arctanh (s11aac) returns the value of the inverse hyperbolic tangent, $\mathrm{arctanh}x$.

2  Specification

 #include #include
 double nag_arctanh (double x, NagError *fail)

3  Description

nag_arctanh (s11aac) calculates an approximate value for the inverse hyperbolic tangent of its argument, $\mathrm{arctanh}x$.
For ${x}^{2}\le \frac{1}{2}$ the function is based on a Chebyshev expansion.
For $\frac{1}{2}<{x}^{2}<1$,
 $arctanh⁡x = 1 2 ln 1+x 1-x .$

4  References

Abramowitz M and Stegun I A (1972) Handbook of Mathematical Functions (3rd Edition) Dover Publications

5  Arguments

1:     xdoubleInput
On entry: the argument $x$ of the function.
Constraint: $\left|{\mathbf{x}}\right|<1.0$.
2:     failNagError *Input/Output
The NAG error argument (see Section 3.6 in the Essential Introduction).

6  Error Indicators and Warnings

NE_REAL_ARG_GE
On entry, $\left|{\mathbf{x}}\right|$ must not be greater than or equal to 1.0: ${\mathbf{x}}=〈\mathit{\text{value}}〉$.
The function has been called with an argument greater than or equal to 1.0 in magnitude, for which arctanh is not defined. The result is returned as zero.

7  Accuracy

If $\delta$ and $\epsilon$ are the relative errors in the argument and result, respectively, then in principle
 $ε ≃ x 1 - x 2 arctanh⁡x δ .$
That is, the relative error in the argument, $x$, is amplified by at least a factor
 $x 1 - x 2 arctanh⁡x$
in the result. The equality should hold if $\delta$ is greater than the machine precision ($\delta$ due to data errors etc.), but if $\delta$ is simply due to round-off in the machine representation then it is possible that an extra figure may be lost in internal calculation round-off.
The factor is not significantly greater than one except for arguments close to $\left|x\right|=1$. However, in the region where $\left|x\right|$ is close to one, $1-\left|x\right|\sim \delta$, the above analysis is inapplicable since $x$ is bounded by definition, $\left|x\right|<1$. In this region where arctanh is tending to infinity we have
 $ε ∼ 1 / ln⁡δ$
which implies an obvious, unavoidable serious loss of accuracy near $\left|x\right|\sim 1$, e.g., if $x$ and 1 agree to 6 significant figures, the result for $\mathrm{arctanh}x$ would be correct to at most about one figure.

None.

9  Example

The following program reads values of the argument $x$ from a file, evaluates the function at each value of $x$ and prints the results.

9.1  Program Text

Program Text (s11aace.c)

9.2  Program Data

Program Data (s11aace.d)

9.3  Program Results

Program Results (s11aace.r)