Trigonomectric constants Polar and spherical to rectangular coordinates transform

Dependents:   DISCO-F746NG_Lidar ZAILLEL_Interface

Revision:
1:eb028056d162
Parent:
0:2f533ad7c611
Child:
2:fe695d6c9c83
diff -r 2f533ad7c611 -r eb028056d162 Trigo.h
--- a/Trigo.h	Sun Nov 25 11:13:56 2012 +0000
+++ b/Trigo.h	Sun Nov 25 11:35:18 2012 +0000
@@ -1,16 +1,29 @@
 #ifndef MBED_TRIGO_H
 #define MBED_TRIGO_H
 
+// Trigo Library
+// trogonometric constants and utilities
+// rémi cormier 2012
+
 
 const float Pi=3.141592653590;
-const float Pis2=Pi/2.0;
-const float DeuxPi=2.0*Pi;
-const float degre=Pi/180.0;
+const float halfPi=Pi/2.0;
+const float twoPi=2.0*Pi;
+const float degre=Pi/180.0;// radian
 
+// rectangular (x,y) to polar coordinates (r : radius, a : angle) transform
+// a is the angle (radian, counter clockwise), with origin on x axis 
+// -pi <= a <= pi
 void RecPol(float x, float y, float *r, float *a);
 
+// polar (r : radius, a : angle (rd))) to rectangular (x,y) transform
 void PolRec(float r, float a, float *x, float *y);
 
+// Rectangular (x,y,z) to sphérical (r : radius, a : angle, b : angle)
+// a is the angle (radian, counter clockwise) betwen the projection of (x,y,z) on xy plane and the x axis
+// -pi <= a <= pi
+// b is the angle (radian, counter clockwise) betwen (x,y,z) and the xy plane
+// -pi/2 <= b <= pi/2
 void RecSph(float x, float y, float z, float *r, float *a, float *b);
 
 void SphRec(float r, float a, float b, float *x, float *y, float *z);