# Difference between revisions of "ASIN"

imported>SMcNeill (Created page with '{{DISPLAYTITLE:_ASIN}} The '''_ASIN''' function returns the angle measured in radians based on an input SINe value ranging from -1 to 1. {{PageSyntax}} ::::: radian_angle!…') |
imported>SMcNeill |
||

Line 39: | Line 39: | ||

* [[_D2G]] {{text|(degree to gradient}}, [[_D2R]] {{text|(degree to radian)}} | * [[_D2G]] {{text|(degree to gradient}}, [[_D2R]] {{text|(degree to radian)}} | ||

* [[_G2D]] {{text|(gradient to degree)}}, [[_G2R]] {{text|(gradient to degree}} | * [[_G2D]] {{text|(gradient to degree)}}, [[_G2R]] {{text|(gradient to degree}} | ||

* [[_R2D]] {{text|(radian to degree)}}, [[ | * [[_R2D]] {{text|(radian to degree)}}, [[_R2G]] {{text|(radian to gradient}} | ||

* [[COS]] {{text|(cosine)}}, [[SIN]] {{text|(sine)}}, [[TAN]] {{text|(tangent)}} | * [[COS]] {{text|(cosine)}}, [[SIN]] {{text|(sine)}}, [[TAN]] {{text|(tangent)}} | ||

* [[_ACOS]] {{text|(arc cosine)}}, [[_ASIN]] {{text|(arc sine)}}, [[ATN]] {{text|(arc tangent)}} | * [[_ACOS]] {{text|(arc cosine)}}, [[_ASIN]] {{text|(arc sine)}}, [[ATN]] {{text|(arc tangent)}} | ||

* [[_ACOSH]] {{text|(arc hyperbolic cosine)}}, [[_ASINH]] {{text|(arc hyperbolic sine)}}, [[ | * [[_ACOSH]] {{text|(arc hyperbolic cosine)}}, [[_ASINH]] {{text|(arc hyperbolic sine)}}, [[_ATANH]] {{text|(arc hyperbolic tangent)}} | ||

* [[_ATAN2]] {{text|(Compute arc tangent with two parameters)}} | * [[_ATAN2]] {{text|(Compute arc tangent with two parameters)}} | ||

* [[_HYPOT]] {{text|(hypotenuse)}} | * [[_HYPOT]] {{text|(hypotenuse)}} |

## Revision as of 20:06, 10 July 2014

The **_ASIN** function returns the angle measured in radians based on an input SINe value ranging from -1 to 1.

## Syntax

- radian_angle! = _ASIN(
*sine_value!*)

- radian_angle! = _ASIN(

- The
*sine_value!*must be measured >= -1 and <= 1, or else it will generate a return value of -1.#IND, which is basically QB64's way of telling us that the number doesn't exist. - ARCSINE is the inverse function of SINe, and turns a SINe value back into an angle.
- Note: Due to rounding with floating point math, the _ASIN may not always give a perfect match for the SIN angle which generated this. You can reduce the number of rounding errors by increasing the precision of your calculations by using DOUBLE or _FLOAT precision variables instead of SINGLE.

*(Only available in QB64-GL, from Dirty Builds after 06/20/2014. Previous versions of QB64 don't support this command.)*

*Example:* Converting a radian angle to its SINe and using that value to find the angle in degrees again using _ASIN:

* *
DEFDBL A-Z
INPUT "Give me an Angle (in Degrees) => "; Angle
PRINT
C = SIN(_D2R(Angle)) '_D2R is the command to convert Degrees to Radians, which is what SIN expects
PRINT "The SINE of the Angle is: "; C
A = _ASIN(C)
PRINT "The ASIN of "; C; " is: "; A
PRINT "Notice, A is the Angle in Radians. If we convert it to degrees, the value is "; _R2D(A) * *

Give me an Angle (in Degrees) => ? 60 The SINE of the Angle is: .8660254037844386 The ACOS of .8660254037844386 is: 1.047197551196598 Notice, A is the Angle in Radians. If we convert it to degrees, we discover the value is 60

*See also:*

- _D2G (degree to gradient, _D2R (degree to radian)
- _G2D (gradient to degree), _G2R (gradient to degree
- _R2D (radian to degree), _R2G (radian to gradient
- COS (cosine), SIN (sine), TAN (tangent)
- _ACOS (arc cosine), _ASIN (arc sine), ATN (arc tangent)
- _ACOSH (arc hyperbolic cosine), _ASINH (arc hyperbolic sine), _ATANH (arc hyperbolic tangent)
- _ATAN2 (Compute arc tangent with two parameters)
- _HYPOT (hypotenuse)
- Mathematical Operations
- Derived Mathematical Functions

*Navigation:*