@cornerstonejs/core 1.42.0 → 1.43.0

package/src/utilities/roundNumber.ts

@@ -0,0 +1,56 @@
+import { EPSILON } from '../constants';
+
+/**
+ * Truncates decimal points to that there is at least 1+precision significant
+ * digits.
+ *
+ * For example, with the default precision 2 (3 significant digits)
+ * * Values larger than 100 show no information after the decimal point
+ * * Values between 10 and 99 show 1 decimal point
+ * * Values between 1 and 9 show 2 decimal points
+ *
+ * @param value - to return a fixed measurement value from
+ * @param precision - defining how many digits after 1..9 are desired
+ */
+function roundNumber(
+  value: string | number | (string | number)[],
+  precision = 2
+): string {
+  if (Array.isArray(value)) {
+    return value.map((v) => roundNumber(v, precision)).join(', ');
+  }
+  if (value === undefined || value === null || value === '') {
+    return 'NaN';
+  }
+  value = Number(value);
+  if (value < 0.0001) {
+    return `${value}`;
+  }
+  const fixedPrecision =
+    value >= 100
+      ? precision - 2
+      : value >= 10
+      ? precision - 1
+      : value >= 1
+      ? precision
+      : value >= 0.1
+      ? precision + 1
+      : value >= 0.01
+      ? precision + 2
+      : value >= 0.001
+      ? precision + 3
+      : precision + 4;
+  return value.toFixed(fixedPrecision);
+}
+
+/**
+ * Rounds a number to the nearest multiple of EPSILON.
+ * @param value - The number to round.
+ * @returns The rounded number.
+ */
+function roundToPrecision(value) {
+  return Math.round(value / EPSILON) * EPSILON;
+}
+
+export { roundToPrecision };
+export default roundNumber;