@thi.ng/math 5.9.1 → 5.10.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-02-10T08:59:56Z
+- **Last updated**: 2024-02-16T20:01:44Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [5.10.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/math@5.10.0) (2024-02-16)
+
+#### 🚀 Features
+
+- add fromDMS()/toDMS() conversions ([1714067](https://github.com/thi-ng/umbrella/commit/1714067))
+
 ## [5.9.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/math@5.9.0) (2024-02-06)
 
 #### 🚀 Features

package/README.md

@@ -82,7 +82,7 @@ For Node.js REPL:
 const math = await import("@thi.ng/math");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 4.63 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 4.70 KB
 
 ## Dependencies
 

package/angle.d.ts

@@ -101,4 +101,30 @@ export declare const fastCos: FnN;
  * @param theta - in radians
  */
 export declare const fastSin: FnN;
+/**
+ * Converts angle from DMS to decimal.
+ *
+ * @remarks
+ * See {@link toDMS} for reverse op.
+ *
+ * Reference:
+ * https://en.wikipedia.org/wiki/Decimal_degrees
+ *
+ * @param deg
+ * @param min
+ * @param sec
+ */
+export declare const fromDMS: (deg: number, min: number, sec: number) => number;
+/**
+ * Converts decimal angle to DMS. Returns result as 3-tuple with the first item
+ * (degrees) having the same sign as the input.
+ *
+ * @remarks
+ * See {@link fromDMS} for reverse op.
+ *
+ * Reference: https://en.wikipedia.org/wiki/Decimal_degrees
+ *
+ * @param theta
+ */
+export declare const toDMS: (theta: number) => number[];
 //# sourceMappingURL=angle.d.ts.map

package/angle.js

@@ -41,6 +41,15 @@ const fastCos = (theta) => {
   }
 };
 const fastSin = (theta) => fastCos(HALF_PI - theta);
+const fromDMS = (deg2, min, sec2) => deg2 + min / 60 + sec2 / 3600;
+const toDMS = (theta) => {
+  const sign = Math.sign(theta);
+  theta = Math.abs(theta);
+  const deg2 = Math.trunc(theta);
+  theta = (theta - deg2) * 60;
+  const min = Math.trunc(theta);
+  return [deg2 * sign, min, (theta - min) * 60];
+};
 export {
   absInnerAngle,
   absTheta,
@@ -52,10 +61,12 @@ export {
   deg,
   fastCos,
   fastSin,
+  fromDMS,
   loc,
   normCos,
   quadrant,
   rad,
   sec,
-  sincos
+  sincos,
+  toDMS
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/math",
-  "version": "5.9.1",
+  "version": "5.10.0",
   "description": "Assorted common math functions & utilities",
   "type": "module",
   "module": "./index.js",
@@ -142,5 +142,5 @@
   "thi.ng": {
     "year": 2013
   },
-  "gitHead": "e5e7d5c6ed2eadee7a91d59cbd0c86ce880ab1c5\n"
+  "gitHead": "25ee18f7db6d03f0b76787267ab071d16df94888\n"
 }