Arduino library for converting angles (degrees/radians) to less known formats.

AngleConvertor is an Arduino class to convert an angle from and to less known formats.

Since 0.2.0 the class uses degrees as internal format as that improved precision a bit compared to the pre-0.2.0 version that used radians. Furthermore to improve precision the class uses doubles, so platforms that support the double data type can gain extra precision (might be slower).

If there are formats missing please open an issue, with a link to its description.

To convert from one less known format to another just takes two calls, example:

  AngleConvertor AC;

  AC.setPechus(24.2);
  float x = AC.getAngularMil();

If you need to convert a lot of data between two formats, it is also possible to pre-calculate a factor so the conversion is faster. On an UNO R3 the gain goes up to 20%, see example.

  AngleConvertor AC;

  AC.setDegrees(1);  //  any non zero value will work.
  float factor = AC.getAngularMil() / AC.getPechus();
  sum = 0;
  for (int i = 0; i < 1000; i++)
  {
    sum += i * factor;
  }

• https://github.com/RobTillaart/AngleConvertor
• https://github.com/RobTillaart/AverageAngle
• https://github.com/RobTillaart/Angle
• https://github.com/RobTillaart/runningAngle

#include "AngleConvertor.h"

• AngleConvertor() create an AngleConvertor, default value is zero.

• void setDegrees(double value = 0)
• void setRadians(double value = 0)
• void setGradians(double value = 0)
• void setAngularMil(double value = 0)
• void setBinaryRadians(double value = 0)
• void setCentiTurn(double value = 0)
• void setDiameterPart(double value = 0)
• void setHexacontade(double value = 0)
• void setHourAngle(double value = 0)
• void setMilliRadians(double value = 0)
• void setMilliTurn(double value = 0)
• void setMinuteTime(double value = 0)
• void setOctant(double value = 0)
• void setPechus(double value = 0)
• void setPercent(double value = 0)
• void setPoints(double value = 0)
• void setQuadrant(double value = 0)
• void setQuarterPoint(double value = 0)
• void setSecondsTime(double value = 0)
• void setSextant(double value = 0)
• void setSign(double value = 0)
• void setTurn(double value = 0)

• double getDegrees()
• double getRadians()
• double getGradians()
• double getAngularMil()
• double getBinaryRadians()
• double getCentiTurn()
• double getDiameterPart()
• double getHexacontade()
• double getHourAngle()
• double getMilliRadians()
• double getMilliTurn()
• double getMinuteTime()
• double getOctant()
• double getPechus()
• double getPercent()
• double getPoints()
• double getQuadrant()
• double getQuarterPoint()
• double getSecondsTime()
• double getSextant()
• double getSign()
• double getTurn()

From: https://forum.arduino.cc/t/function-optimization-wind-direction-open-for-ideas/92493/10

Converts an angle in degrees to a char array like "WSW". 0 and 360 degrees is considered North.

• char * windrose() converter version.
• char * windrose(double degrees) stand alone version. degrees should be between 0 and 360, as function does no normalization.

• improve documentation

• add more conversions
• integrate with Angle class ?
  • printing can be a lot of work
• windrose array in PROGMEM

If you appreciate my libraries, you can support the development and maintenance. Improve the quality of the libraries by providing issues and Pull Requests, or donate through PayPal or GitHub sponsors.

Thank you,