iDevOS CALC "ACOSH" Command

Get the hyperbolic arc (inverse) cosine.

Description

CALC( y, a, "ACOSH" );      // y = acosh(a)     = hyperbolic arc cosine of a
CALC( y, a, b, "ACOSH" );   // y = acosh(a / b) = hyperbolic arc cosine of a divided b

This command returns the angle y as the hyperbolic arc cosine (or hyperbolic inverse cosine) of a. If the divider value b is specified then a is divided by b before the trigonometric calculation is performed.

The angle y by default is specified in Degrees. Angles used in trigonometric functions can be set globally to use Radians by the SYSTEM.angles property.

Note: The value passed into the trigonometric function (a or a/b) must be equal to or greater than +1 (inclusive) otherwise a system error will be generated. It is the responsibility of the user to check this.

Trigonometric functions: "COS", "SIN", "TAN", "ACOS", "ASIN", "ATAN", "ATAN2", "COSH", "SINH", "TANH", "ACOSH", "ASINH", "ATANH".

Parameters

y

Calculation result.
Parameter type: entity name of a numeric variable (eg U8, S32, FLT3 etc).

a and b

Input values.
Parameter type: immediate number, or entity name of a numeric variable (eg U8, S32, FLT3 etc).

"ACOSH"

CALC command operator.
Parameter type: immediate string.

Examples

Example 1

VAR(df,  0.0,    FLT4); // result
VAR(af1, 7.071,  FLT4); // value
VAR(af2, 35.355, FLT4); // value
VAR(bf,  5,      FLT4); // divider

CALC(df, af1, "ACOSH");     // df = 151.4964

CALC(df, af2, bf, "ACOSH" ); // df = 151.4964