Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/RobTillaart/Angle
Arduino library for basic math for Angles in degrees, minute, seconds
https://github.com/RobTillaart/Angle
angle degrees math radians
Last synced: 28 days ago
JSON representation
Arduino library for basic math for Angles in degrees, minute, seconds
- Host: GitHub
- URL: https://github.com/RobTillaart/Angle
- Owner: RobTillaart
- License: mit
- Created: 2020-03-26T14:02:57.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-13T08:51:14.000Z (8 months ago)
- Last Synced: 2024-11-19T06:34:28.123Z (about 1 month ago)
- Topics: angle, degrees, math, radians
- Language: C++
- Homepage:
- Size: 31.3 KB
- Stars: 6
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/marketplace/actions/arduino_ci)
[](https://github.com/RobTillaart/Angle/actions/workflows/arduino-lint.yml)
[](https://github.com/RobTillaart/Angle/actions/workflows/jsoncheck.yml)
[](https://github.com/RobTillaart/Angle/issues)
[](https://github.com/RobTillaart/Angle/blob/master/LICENSE)
[](https://github.com/RobTillaart/Angle/releases)
[](https://registry.platformio.org/libraries/robtillaart/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)**.
Degree sign ° = ALT-0176 (Windows)
#### Related
- https://github.com/RobTillaart/AngleConvertor
- https://github.com/RobTillaart/AverageAngle
- https://github.com/RobTillaart/Angle
- https://github.com/RobTillaart/runningAngle
## Interface
```cpp
#include "Angle.h"
```
#### 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.
More conversions - https://github.com/RobTillaart/AngleConvertor
#### 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
#### Must
- improve documentation
#### Should
- Test normalize code
- unit tests, sketch?
- test more
- TOCHECK in code
- improve code quality
#### Could
- optimize code where possible
- low priority
- move all code to .cpp
- change output format to confirm standard 4°12'14.1234"
#### Wont
## Support
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,