@naturalcycles/js-lib 14.73.0 → 14.74.0

package/dist/math/math.util.d.ts

@@ -24,6 +24,10 @@ export declare function _averageWeighted(values: number[], weights: number[]): n
  * // 3
  */
 export declare function _percentile(values: number[], pc: number): number;
+/**
+ * A tiny bit more efficient function than calling _percentile individually.
+ */
+export declare function _percentiles(values: number[], pcs: number[]): Record<number, number>;
 /**
  * @example
  *

package/dist/math/math.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._median = exports._percentile = exports._averageWeighted = exports._average = void 0;
+exports._median = exports._percentiles = exports._percentile = exports._averageWeighted = exports._average = void 0;
 const number_util_1 = require("../number/number.util");
 /**
  * @returns Average of the array of numbers
@@ -45,6 +45,23 @@ function _percentile(values, pc) {
     return _averageWeighted([sorted[floorPos], sorted[ceilPos]], [1 - dec, dec]);
 }
 exports._percentile = _percentile;
+/**
+ * A tiny bit more efficient function than calling _percentile individually.
+ */
+function _percentiles(values, pcs) {
+    const r = {};
+    const sorted = (0, number_util_1._sortNumbers)(values);
+    pcs.forEach(pc => {
+        // Floating pos in the range of [0; length - 1]
+        const pos = ((values.length - 1) * pc) / 100;
+        const dec = pos % 1;
+        const floorPos = Math.floor(pos);
+        const ceilPos = Math.ceil(pos);
+        r[pc] = _averageWeighted([sorted[floorPos], sorted[ceilPos]], [1 - dec, dec]);
+    });
+    return r;
+}
+exports._percentiles = _percentiles;
 /**
  * @example
  *

package/dist/math/stack.util.d.ts

@@ -35,6 +35,8 @@ export declare class NumberStack extends Stack<number> {
      * Returns null if Stack is empty.
      */
     avgOrNull(): number | null;
+    median(): number;
+    medianOrNull(): number | null;
     /**
      * `pc` is a number from 0 to 100 inclusive.
      */
@@ -44,6 +46,5 @@ export declare class NumberStack extends Stack<number> {
      * Returns null if Stack is empty.
      */
     percentileOrNull(pc: number): number | null;
-    median(): number;
-    medianOrNull(): number | null;
+    percentiles(pcs: number[]): Record<number, number>;
 }

package/dist/math/stack.util.js

@@ -60,6 +60,12 @@ class NumberStack extends Stack {
     avgOrNull() {
         return this.items.length === 0 ? null : (0, index_1._average)(this.items);
     }
+    median() {
+        return (0, index_1._percentile)(this.items, 50);
+    }
+    medianOrNull() {
+        return this.items.length === 0 ? null : (0, index_1._percentile)(this.items, 50);
+    }
     /**
      * `pc` is a number from 0 to 100 inclusive.
      */
@@ -74,11 +80,8 @@ class NumberStack extends Stack {
     percentileOrNull(pc) {
         return this.items.length === 0 ? null : (0, index_1._percentile)(this.items, pc);
     }
-    median() {
-        return (0, index_1._percentile)(this.items, 50);
-    }
-    medianOrNull() {
-        return this.items.length === 0 ? null : (0, index_1._percentile)(this.items, 50);
+    percentiles(pcs) {
+        return (0, index_1._percentiles)(this.items, pcs);
     }
 }
 exports.NumberStack = NumberStack;

package/dist-esm/math/math.util.js

@@ -39,6 +39,22 @@ export function _percentile(values, pc) {
     const ceilPos = Math.ceil(pos);
     return _averageWeighted([sorted[floorPos], sorted[ceilPos]], [1 - dec, dec]);
 }
+/**
+ * A tiny bit more efficient function than calling _percentile individually.
+ */
+export function _percentiles(values, pcs) {
+    const r = {};
+    const sorted = _sortNumbers(values);
+    pcs.forEach(pc => {
+        // Floating pos in the range of [0; length - 1]
+        const pos = ((values.length - 1) * pc) / 100;
+        const dec = pos % 1;
+        const floorPos = Math.floor(pos);
+        const ceilPos = Math.ceil(pos);
+        r[pc] = _averageWeighted([sorted[floorPos], sorted[ceilPos]], [1 - dec, dec]);
+    });
+    return r;
+}
 /**
  * @example
  *

package/dist-esm/math/stack.util.js

@@ -1,4 +1,4 @@
-import { _average, _percentile, _range } from '../index';
+import { _average, _percentile, _percentiles, _range } from '../index';
 /**
  * Implements a "round-robin" Stack ("first-in last-out" aka FILO) with a limited size.
  * Like an array of a fixed size. When it runs out of space - it starts writing on top of itself
@@ -56,6 +56,12 @@ export class NumberStack extends Stack {
     avgOrNull() {
         return this.items.length === 0 ? null : _average(this.items);
     }
+    median() {
+        return _percentile(this.items, 50);
+    }
+    medianOrNull() {
+        return this.items.length === 0 ? null : _percentile(this.items, 50);
+    }
     /**
      * `pc` is a number from 0 to 100 inclusive.
      */
@@ -70,10 +76,7 @@ export class NumberStack extends Stack {
     percentileOrNull(pc) {
         return this.items.length === 0 ? null : _percentile(this.items, pc);
     }
-    median() {
-        return _percentile(this.items, 50);
-    }
-    medianOrNull() {
-        return this.items.length === 0 ? null : _percentile(this.items, 50);
+    percentiles(pcs) {
+        return _percentiles(this.items, pcs);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.73.0",
+  "version": "14.74.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

package/src/math/math.util.ts

@@ -47,6 +47,27 @@ export function _percentile(values: number[], pc: number): number {
   return _averageWeighted([sorted[floorPos]!, sorted[ceilPos]!], [1 - dec, dec])
 }
 
+/**
+ * A tiny bit more efficient function than calling _percentile individually.
+ */
+export function _percentiles(values: number[], pcs: number[]): Record<number, number> {
+  const r = {} as Record<number, number>
+
+  const sorted = _sortNumbers(values)
+
+  pcs.forEach(pc => {
+    // Floating pos in the range of [0; length - 1]
+    const pos = ((values.length - 1) * pc) / 100
+    const dec = pos % 1
+    const floorPos = Math.floor(pos)
+    const ceilPos = Math.ceil(pos)
+
+    r[pc] = _averageWeighted([sorted[floorPos]!, sorted[ceilPos]!], [1 - dec, dec])
+  })
+
+  return r
+}
+
 /**
  * @example
  *

package/src/math/stack.util.ts

@@ -1,4 +1,4 @@
-import { _average, _percentile, _range } from '../index'
+import { _average, _percentile, _percentiles, _range } from '../index'
 
 /**
  * Implements a "round-robin" Stack ("first-in last-out" aka FILO) with a limited size.
@@ -64,6 +64,14 @@ export class NumberStack extends Stack<number> {
     return this.items.length === 0 ? null : _average(this.items)
   }
 
+  median(): number {
+    return _percentile(this.items, 50)
+  }
+
+  medianOrNull(): number | null {
+    return this.items.length === 0 ? null : _percentile(this.items, 50)
+  }
+
   /**
    * `pc` is a number from 0 to 100 inclusive.
    */
@@ -80,11 +88,7 @@ export class NumberStack extends Stack<number> {
     return this.items.length === 0 ? null : _percentile(this.items, pc)
   }
 
-  median(): number {
-    return _percentile(this.items, 50)
-  }
-
-  medianOrNull(): number | null {
-    return this.items.length === 0 ? null : _percentile(this.items, 50)
+  percentiles(pcs: number[]): Record<number, number> {
+    return _percentiles(this.items, pcs)
   }
 }