@cornerstonejs/core 1.59.0 → 1.59.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cornerstonejs/core",
-  "version": "1.59.0",
+  "version": "1.59.2",
   "description": "",
   "main": "src/index.ts",
   "types": "dist/types/index.d.ts",
@@ -47,5 +47,5 @@
     "type": "individual",
     "url": "https://ohif.org/donate"
   },
-  "gitHead": "85e398173df425f594c5ebd4fb5cd96da9d7dbd4"
+  "gitHead": "ad8b39627c4f37c1a6007c39e358966b716f52bb"
 }

package/src/utilities/getRandomSampleFromArray.ts

@@ -0,0 +1,30 @@
+/**
+ * Gets a random sample of specified size from the array.
+ * If the requested size is greater than the array length, returns a shuffled clone of the original array.
+ * @param array - The source array from which to sample.
+ * @param size - The number of elements to sample from the array.
+ * @returns A new array containing the random sample.
+ */
+export function getRandomSampleFromArray<T>(array: T[], size: number): T[] {
+  const clonedArray = [...array]; // Copy the original array
+
+  // If requested size is greater than array length, shuffle and return clone of the original array
+  if (size >= clonedArray.length) {
+    shuffleArray(clonedArray);
+    return clonedArray;
+  }
+
+  shuffleArray(clonedArray);
+  return clonedArray.slice(0, size);
+}
+
+/**
+ * Shuffles an array
+ * @param array - The array to shuffle.
+ */
+function shuffleArray<T>(array: T[]): void {
+  for (let i = array.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [array[i], array[j]] = [array[j], array[i]]; // Swap elements
+  }
+}

package/src/utilities/index.ts

@@ -69,6 +69,7 @@ import VoxelManager from './VoxelManager';
 import roundNumber, { roundToPrecision } from './roundNumber';
 import convertToGrayscale from './convertToGrayscale';
 import getViewportImageIds from './getViewportImageIds';
+import { getRandomSampleFromArray } from './getRandomSampleFromArray';
 
 // name spaces
 import * as planar from './planar';
@@ -156,4 +157,5 @@ export {
   roundNumber,
   roundToPrecision,
   getViewportImageIds,
+  getRandomSampleFromArray,
 };