atan

back to Command Reference / Math

Description

Calculates the arctangent (in radians) of an argument. The result will be between -HALF_PI and HALF_PI (see constants. For an unambiguous angle use atan2() instead.

Note: for conversion radians to degrees, use deg2rad().

Inclusion

• defined in misc.h
• auto-loaded in main_general.h
• no #define required

Syntax

a = atan(x)

Parameters

• input:

  • x: number to calculate arctangent for (float)

• output:

  • none

Returns

• The arctangent of the argument (float).

Example Code

The below code prints a table for y=atan(x) between -10..10 in degrees. Note that the example requires option #define USE_FTOA in file config.h for floating point output.

#include "main_general.h"
#include "uart1.h"
#include "putchar.h"

void setup() {

  float x,y;
  char  s1[20], s2[20];
  
  // init UART and printf()
  UART1_begin(115200);
  putcharAttach(UART1_write);
  
  // allow the terminal to launch
  sw_delay(1000);
  
  // print math table
  for (x=-10.0; x<=10.0; x+=0.5) {
    y = rad2deg(atan(x));
    printf("%s  %s\n", floatToString(s1,x,2), floatToString(s2,y,2));
  }
  
}

void loop() {
  // dummy
}

Relevant Tutorial

• tbd

See also

• deg2rad()
• rad2deg()
• cos()
• tan()
• sin()
• asin()
• acos()
• atan2()