Difference between revisions of "ASIN"

From QB64 Wiki
Jump to navigation Jump to search
imported>SMcNeill
(availability added)
m (Nomalise Availability section text)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:_ASIN}}
{{DISPLAYTITLE:_ASIN}}
The '''_ASIN''' function returns the angle measured in radians based on an input [[SIN]]e value ranging from -1 to 1.
The [[_ASIN]] function returns the angle measured in radians based on an input [[SIN]]e value ranging from -1 to 1.




{{PageSyntax}}  
{{PageSyntax}}
::::: radian_angle! = _ASIN(''sine_value!'')
: {{Parameter|radian_angle!}} = [[_ASIN]]({{Parameter|sine_value!}})




* 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.  
{{PageDescription}}
* The {{Parameter|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 [[SIN]]e, and turns a [[SIN]]e value back into an angle.
* ARCSINE is the inverse function of [[SIN]]e, and turns a [[SIN]]e 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]].
* 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]].




''Availability:''
{{PageAvailability}}
* '''Version 1.000 and up'''
* Version 1.000 and up.




{{PageExamples}}
''Example:'' Converting a radian angle to its SINe and using that value to find the angle in degrees again using _ASIN:
''Example:'' Converting a radian angle to its SINe and using that value to find the angle in degrees again using _ASIN:
{{CodeStart}} '' ''
{{CodeStart}} '' ''
Line 38: Line 40:




''See also:''
{{PageSeeAlso}}
* [[_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)}}, [[_R2G]] {{text|(radian to gradient}}
* [[_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)}}, [[ATN]] {{text|(arc tangent)}}
* [[_ACOSH]] {{text|(arc hyperbolic  cosine)}}, [[_ASINH]] {{text|(arc hyperbolic  sine)}}, [[_ATANH]] {{text|(arc hyperbolic  tangent)}}
* [[_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)}}

Latest revision as of 03:20, 8 March 2021

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!)


Description

  • 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.


Availability

  • Version 1.000 and up.


Examples

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)

Example by SMcNeill

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



Navigation:
Keyword Reference - Alphabetical
Keyword Reference - By Usage
Main Wiki Page