From e39bfe912aba174732d171b74debc0a01bde3600 Mon Sep 17 00:00:00 2001 From: Elsa Minsut Date: Wed, 24 Sep 2025 19:36:30 +0200 Subject: [PATCH] docs: improve consistency in ATAN2, ASINH, ACOSH, ATANH documentation --- docs/src/functions/math_and_trigonometry/acosh.md | 6 +++--- docs/src/functions/math_and_trigonometry/asinh.md | 5 ++--- docs/src/functions/math_and_trigonometry/atan2.md | 6 +++--- docs/src/functions/math_and_trigonometry/atanh.md | 5 ++--- 4 files changed, 10 insertions(+), 12 deletions(-) diff --git a/docs/src/functions/math_and_trigonometry/acosh.md b/docs/src/functions/math_and_trigonometry/acosh.md index 696b4d8..db59df0 100644 --- a/docs/src/functions/math_and_trigonometry/acosh.md +++ b/docs/src/functions/math_and_trigonometry/acosh.md @@ -16,11 +16,11 @@ ACOSH is a function of the Math and Trigonometry category that calculates the in The hyperbolic arccosine function is defined as: $$ -\text{acosh(x)} = \ln(x + \sqrt{x^2 - 1}) +\operatorname{acosh}(x) = \ln(x + \sqrt{x^2 - 1}) $$ ### Returned value -ACOSH returns a [number](/features/value-types#numbers) that is the hyperbolic arccosine of the specified value, expressed in radians. +ACOSH returns a [number](/features/value-types#numbers) 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!`](/features/error-types.md#error) error. @@ -30,7 +30,7 @@ ACOSH returns a [number](/features/value-types#numbers) that is the hyperbolic a ## Details * The ACOSH function utilizes the *acosh()* method provided by the [Rust Standard Library](https://doc.rust-lang.org/std/). * The figure below illustrates the output of the ACOSH function for values $x \geq 1$ in the range [0, +∞). -
Graph showing acosh(x) for x ≥ 0.
+
Graph showing acosh(x) for x ≥ 1.
## Examples [See some examples in IronCalc](https://app.ironcalc.com/?example=acosh). diff --git a/docs/src/functions/math_and_trigonometry/asinh.md b/docs/src/functions/math_and_trigonometry/asinh.md index f24deca..c81ffb5 100644 --- a/docs/src/functions/math_and_trigonometry/asinh.md +++ b/docs/src/functions/math_and_trigonometry/asinh.md @@ -18,12 +18,11 @@ $$ \operatorname{asinh}(x) = \ln\!\left(x + \sqrt{x^2 + 1}\,\right) $$ ### Returned value -ASINH returns a real [number](/features/value-types#numbers) that is the hyperbolic arcsine of the specified value, expressed in radians. +ASINH returns a real [number](/features/value-types#numbers) in the range (-∞, +∞) that is the hyperbolic arcsine of the specified value, expressed in radians. ### Error conditions * In common with many other IronCalc functions, ASINH propagates errors that are found in its argument. * If no argument, or more than one argument, is supplied, then ASINH returns the [`#ERROR!`](/features/error-types.md#error) error. * If the value of the *number* argument is not (or cannot be converted to) a [number](/features/value-types#numbers), then ASINH returns the [`#VALUE!`](/features/error-types.md#value) error. -* For some argument values, ASINH may return a [`#DIV/0!`](/features/error-types.md#div-0) error. ## Details * The ASINH function utilizes the *asinh()* method provided by the [Rust Standard Library](https://doc.rust-lang.org/std/). @@ -35,6 +34,6 @@ ASINH returns a real [number](/features/value-types#numbers) that is the hyperbo ## Links * For more information about inverse hyperbolic functions, visit Wikipedia's [Inverse hyperbolic functions](https://en.wikipedia.org/wiki/Inverse_hyperbolic_functions) page. -* See also IronCalc's [SINH](/functions/math_and_trigonometry/sinh), [COSH](/functions/math_and_trigonometry/cosh) and [TANH](/functions/math_and_trigonometry/tanh) functions. +* See also IronCalc's [SINH](/functions/math_and_trigonometry/sinh), [ACOSH](/functions/math_and_trigonometry/acosh) and [ATANH](/functions/math_and_trigonometry/atanh) functions. * Visit Microsoft Excel's [ASINH function](https://support.microsoft.com/de-de/office/asinh-function-62b4f5b6-d9cc-4c17-9d04-aa5371806c74) page. * Both [Google Sheets](https://support.google.com/docs/answer/3093393) and [LibreOffice Calc](https://wiki.documentfoundation.org/Documentation/Calc_Functions/ASINH) provide versions of the ASINH function. \ No newline at end of file diff --git a/docs/src/functions/math_and_trigonometry/atan2.md b/docs/src/functions/math_and_trigonometry/atan2.md index 30b6ac4..73a6dac 100644 --- a/docs/src/functions/math_and_trigonometry/atan2.md +++ b/docs/src/functions/math_and_trigonometry/atan2.md @@ -9,15 +9,15 @@ lang: en-US ATAN2 is a function of the Math and Trigonometry category that calculates the inverse tangent (arctangent) for the specified *x* and *y* coordinates. The arctangent returns the angle defined by the x-axis and a line defined by the origin and a point with coordinates (x,y). The returned angle is expressed in radians, in the range (-$\pi$, +$\pi$]. ## Usage ### Syntax -**ATAN2 (x,y) => atan2** +**ATAN2(x,y) => atan2** ### Argument descriptions -* *x* ([number](/features/value-types#numbers), required). Value of the x coordinate. +* *x* ([number](/features/value-types#numbers), required). Value of the x coordinate. * *y* ([number](/features/value-types#numbers), required). Value of the y coordinate. ### Additional guidance If the returned value is positive, it represents a counterclockwise angle from the x-axis, while a negative value represents a clockwise angle. ATAN2(x,y) is equivalent to ATAN(y/x), with the difference that the x argument in ATAN2 can be 0. ### Returned value -ATAN2 returns a number in radians in the range (-$\pi$ to +$\pi$] that is the inverse tangent for the specified x and y coordinates. +ATAN2 returns a number in radians in the range (-$\pi$, +$\pi$] that is the inverse tangent for the specified x and y coordinates. ### Error conditions * In common with many other IronCalc functions, ATAN2 propagates errors that are found in its argument. * If no argument, or arguments other than 2, are supplied, then ATAN2 returns the [`#ERROR!`](/features/error-types.md#error) error. diff --git a/docs/src/functions/math_and_trigonometry/atanh.md b/docs/src/functions/math_and_trigonometry/atanh.md index eb1a2d1..63e28f4 100644 --- a/docs/src/functions/math_and_trigonometry/atanh.md +++ b/docs/src/functions/math_and_trigonometry/atanh.md @@ -6,7 +6,7 @@ lang: en-US # ATANH function ## Overview -ATANH is a function of the Math and Trigonometry category that calculates the inverse hyperbolic tangent (hyperbolic arctangent) of a number, returning the hyperbolic angle expressed in radians. +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** @@ -18,13 +18,12 @@ $$ \operatorname{atanh}(x) = \tfrac{1}{2}\,\ln\!\left(\dfrac{1+x}{1-x}\right),\quad |x| < 1 $$ ### Returned value -ATANH returns a real [number](/features/value-types#numbers) that is the hyperbolic arctangent of the specified value, expressed in radians. +ATANH returns a real [number](/features/value-types#numbers) 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!`](/features/error-types.md#error) error. * If the value of the *number* argument is not (or cannot be converted to) a [number](/features/value-types#numbers), then ATANH returns the [`#VALUE!`](/features/error-types.md#value) error. * If the value of the *number* argument lies outside the domain (-1, +1), then ATANH returns the [`#NUM!`](/features/error-types.md#num) error. -* For some argument values, ATANH may return a [`#DIV/0!`](/features/error-types.md#div-0) error. ## Details * The ATANH function utilizes the *atanh()* method provided by the [Rust Standard Library](https://doc.rust-lang.org/std/).