GY-63_MS5611/libraries/Angle

Angle

Arduino library for basic math for Angles in degrees, minute, seconds and ten-thousands.

Description

Angle is an Arduino class to print, compare and do basic maths with angles in degrees, minutes seconds and ten-thousands. The class was created to be able to print an angle with minutes and seconds instead of as a floating point or radians.

To make the library more useful basic maths ( + - * / ) and comparisons ( == != < <= > >= ) are added to the class.

The library implements the Printable interface, allowing one to call

Serial.println(angle) or SD.print(angle).

Interface

Constructors

• Angle(int dd = 0, int mm = 0, int ss = 0, int tt = 0) create an Angle, default is zero.
• Angle(double alpha) create an Angle from a double.
• Angle(char * str) create an Angle from a string e.g. "45.31234".

base

• int sign() returns -1 or 1.
• int degree() returns # degrees.
• int minute() returns # minutes.
• int second() returns # seconds.
• int tenthousand() returns # ten-thousands of a second.

Conversions

• double toDouble() returns the angle as a double (0..360.0, float on UNO).
• double toRadians() returns the angle in radians (0..TWO_PI).
• void fromRadian(double rad) create an angle from radians.

Equality operators

The library supports equality operator "==", "!=", "<" "<=" ">" and ">=" .

Math operators

• negate returns -angle.
• addition and subtract add angles to angles.
• multiplication and division multiply an angle with a double.
• ratio ratio = Angle/Angle.

Operation

See examples.

Note

The library has not been tested extensively and it could still contain bugs. Especially the constructor does not check input so use it carefully.

Future

• improve documentation
• test more
• optimize code where possible
  • performance sketch
• improve code quality
  • fix TODO in code
  • use better variable names in code
  • move all code to .cpp