dSin
Syntax
Assignment Variable = dSin(pVariable)
Overview
Deduce the Sine of a 64-bit floating point value
Parameter
pVariable can be a constant, variable or expression that requires the Sine extracted. The value expected and returned by dSin is in radians. Assignment Variable can be any valid variable type.
Example
Device = 24FJ64GA002 ' Select the device to compile for
Declare Xtal = 16 ' Tell the compiler the device will be operating at 16MHz
Declare Hserial_Baud = 9600 ' USART1 Baud rate
Declare Hrsout1_Pin = PORTB.14 ' Select the pin for TX with USART1
Dim DoubleIn as Double ' Holds the value to Sin
Dim DoubleOut as Double ' Holds the result of the Sin
RPOR7 = 3 ' Make PPS Pin RP14 U1TX
DoubleIn = 123 ' Load the variable
DoubleOut = dSin(DoubleIn) ' Extract the Sin of the value
HrsoutLn Dec DoubleOut ' Display the resultNotes.
64-bit floating point trigonometry is rather memory hungry, so do not be surprised if a large chunk of the microcontroller’s code memory is used with a single operator. This also means that floating point trigonometry is comparatively slow to operate.
The compiler uses the stack as temporary storage when performing 64-bit floating point library routines, therefore, it may be required to increase the stack size from the default 120 words to 200 words using the Stack_Size declare. If the program resets with a stack underflow/overflow exception when running, the stack size is insufficient and requires increasing.
When implementing trigonometry, or other built in, functions within an expression, always wrap them in parenthesis, otherwise the parser may consider the extra operands as part of the trigonometry parameter and produce an incorrect result. For example:
MyAssignment = (dSin(MyVar1)) + MyVar2