ArcSin (FPScript)
Calculates the inverse sine of the argument. The result is output in radians.
Syntax
ArcSin(Number)
The syntax of the ArcSin function consists of the following parts:
Part |
Description |
|---|---|
Number |
The sine of the angle you want to calculate. All data structures are allowed. All numeric data types are permitted. |
Remarks
The result has the same structure as the argument Number. The calculation is done element by element where appropriate.
The result has the unit rad, if Number has a unit. Otherwise, it has no unit.
For aggregate data structures, only the Y component is calculated.
The real inverse sine function is calculated for a real argument. The result is of the 64-bit floating point value data type. The range for Number is then limited to the interval [-1, 1]. For each value of Number outside of this interval, the function returns a void value. The following illustration shows the course of the function in this interval:
If Number is complex, then the complex inverse sine function is calculated, which can be defined as follows:
-i * Log(i * Number + Sqrt(1 - Number2)) with the imaginary unit i = (0, 1).
The result is of the complex 64-bit floating point value data type. The following illustration shows the course of the absolute value of the function:
If the argument is a list, then the function is executed for each element of the list and the result is also a list.
Available in
FlexPro Basic, Professional, Developer Suite
Examples
ArcSin(0) |
Results in 0. |
ArcSin(-1.0) |
Results in -1.570796. (= -PI/2) |
ArcSin(1.0) |
Results in 1.570796. (= PI/2) |
ArcSin(2) |
Results in ?, since the domain was exceeded. |
ArcSin((0, 1)) |
Results in (0, 0.88137). (= -(0, 1) * Log(Sqrt(2) - 1))) |
Dim x |
Calculates a signal with the course of the curve in the interval [-1, 1]. |