[![Arduino CI](https://github.com/RobTillaart/Angle/workflows/Arduino%20CI/badge.svg)](https://github.com/marketplace/actions/arduino_ci)
[![Arduino-lint](https://github.com/RobTillaart/Angle/actions/workflows/arduino-lint.yml/badge.svg)](https://github.com/RobTillaart/Angle/actions/workflows/arduino-lint.yml)
[![JSON check](https://github.com/RobTillaart/Angle/actions/workflows/jsoncheck.yml/badge.svg)](https://github.com/RobTillaart/Angle/actions/workflows/jsoncheck.yml)
[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/RobTillaart/Angle/blob/master/LICENSE)
[![GitHub release](https://img.shields.io/github/release/RobTillaart/Angle.svg?maxAge=3600)](https://github.com/RobTillaart/Angle/releases)


# 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**  -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.