mechanical-tolerance-calculator 1.0.4 → 1.0.5

package/README.md

@@ -29,7 +29,7 @@ console.log(housingTolerances["housingBoresTolerances"]);
 
 ---
 
-## API
+## API EXACPLES
 
 ### `getAllTolerancesFor(materialType: String)`
 

package/index.js

@@ -117,12 +117,14 @@ const MATERIAL_TYPE_CONFIG = {
   shafts: {
     specification: "h9",
     itGrade: "IT5",
+
     rangeMatch: (nominal, spec) =>
       nominal > spec.minimum_diameter && nominal <= spec.maximum_diameter,
   },
   housingBores: {
     specification: "H8",
     itGrade: "IT6",
+
     rangeMatch: (nominal, spec) =>
       nominal >= spec.minimum_diameter && nominal < spec.maximum_diameter,
   },
@@ -147,8 +149,8 @@ function calculateComputedBounds(nominal, spec) {
 
 function calculateUncomputedBounds(nominal, spec) {
   return {
-    upperBound: parseUncomputedBound(nominal, spec.upper_deviation),
-    lowerBound: parseUncomputedBound(nominal, spec.lower_deviation),
+    upperBound: parseUncomputedBound(nominal, spec.upper_deviation, "+"),
+    lowerBound: parseUncomputedBound(nominal, spec.lower_deviation, "-"),
   };
 }
 
@@ -194,6 +196,13 @@ function processMeasurement(materialType, measurement, tolerances) {
 
   // Check if measurement meets specification
   const meetsSpec = checkMeetsSpecification(measurement, computedBounds);
+  const specMeetingReason = meetsSpec
+    ? `${parseToFixedThreeString(measurement)} falls between ${
+        computedBounds.lowerBound
+      } and ${computedBounds.upperBound}`
+    : `${parseToFixedThreeString(measurement)} doesn't fall between ${
+        computedBounds.lowerBound
+      } and ${computedBounds.upperBound}`;
 
   return {
     measurement: parseStringFloat(measurement),
@@ -202,9 +211,21 @@ function processMeasurement(materialType, measurement, tolerances) {
     IT_grade: config.itGrade,
     computed_specification_bounds: computedBounds,
     uncomputed_specification_bounds: uncomputedBounds,
-    meet_specification: meetsSpec,
-    meets_IT_tolerance: meetsSpec,
     matched_spec: matchedSpec,
+
+    meets_specification: { meetsSpec, reason: specMeetingReason },
+  };
+}
+
+function processOneMeasurement(materialType, measurement, tolerances) {
+  const processedMeasurement = processMeasurement(
+    materialType,
+    measurement,
+    tolerances
+  );
+  return {
+    ...processedMeasurement,
+    meets_IT_tolerance: processedMeasurement.meet_specification,
   };
 }
 
@@ -222,7 +243,7 @@ function checkOneMeasurementFor(materialType, measurement) {
     };
   }
 
-  return processMeasurement(
+  return processOneMeasurement(
     camcoStandardTolerances.type,
     measurement,
     camcoStandardTolerances
@@ -233,17 +254,23 @@ function parseComputedBound(base, value, decimalCount) {
   return Number(base + parseStringFloat(value)).toFixed(decimalCount);
 }
 
-function parseUncomputedBound(value1, value2) {
+function parseUncomputedBound(value1, value2, sign) {
   if (value2.startsWith("-")) {
     return (
       parseToFixedThreeString(value1) +
-      " - " +
+      " " +
+      sign +
+      " " +
       parseToFixedThreeString(value2.slice(1, value2.length))
     );
   }
 
   return (
-    parseToFixedThreeString(value1) + " + " + parseToFixedThreeString(value2)
+    parseToFixedThreeString(value1) +
+    " " +
+    sign +
+    " " +
+    parseToFixedThreeString(value2)
   );
 }
 
@@ -276,10 +303,98 @@ function parseStringFloat(value) {
   // Return 0 if parsing fails (NaN)
   return isNaN(parsed) ? 0 : parsed;
 }
+function processIndividualMeasurement(
+  materialType,
+  measurement,
+  tolerances,
+  meetsIT,
+  ITMeetingReason
+) {
+  const processedMeasurement = processMeasurement(
+    materialType,
+    measurement,
+    tolerances
+  );
+  return {
+    ...processedMeasurement,
+  };
+}
+
+function checkMultipleMeasurementsFor(materialType, measurements) {
+  const validation = validateMeasurements(measurements);
+  if (validation?.error) {
+    return validation;
+  }
+  const camcoStandardTolerances = getCamcoStandardTolerancesFor(materialType);
+
+  let largestMeasurement = Math.max(...measurements);
+  let smallestMeasurement = Math.min(...measurements);
+  let ITDifference = parseToFixedThreeString(
+    largestMeasurement - smallestMeasurement
+  );
+
+  const ITs = {
+    IT5: 0,
+    IT6: 0,
+    IT7: 0,
+    IT8: 0,
+    IT9: 0,
+  };
+
+  const results = measurements.map((measurement) => {
+    const result = processIndividualMeasurement(
+      camcoStandardTolerances.type,
+      measurement,
+      camcoStandardTolerances
+    );
+
+    ITs[result.IT_grade]++;
+
+    return result;
+  });
+
+  const baseSpec = results[0];
+  const baseITValue = baseSpec.matched_spec[baseSpec.IT_grade];
+
+  const meetsIT = ITDifference <= baseITValue;
+  const itMeetingReason = meetsIT
+    ? `The difference between ${parseToFixedThreeString(
+        largestMeasurement
+      )} and ${parseToFixedThreeString(
+        smallestMeasurement
+      )} is less than or equal to ${baseITValue}.`
+    : `The difference between ${parseToFixedThreeString(
+        largestMeasurement
+      )} and ${parseToFixedThreeString(
+        smallestMeasurement
+      )} is greater than to ${baseITValue}.`;
+
+  return {
+    baseSpec,
+    meets_IT_Tolerance: { meetsIT, reason: itMeetingReason },
+  };
+}
+
+function validateMeasurements(measurements) {
+  if (!Array.isArray(measurements)) {
+    return {
+      error: "Measurements must be an array of numbers",
+    };
+  }
+
+  if (measurements.length === 0) {
+    return {
+      error: "Measurements array cannot be empty",
+    };
+  }
+
+  return null;
+}
 
 module.exports = {
   getAllTolerancesFor,
   getCamcoStandardTolerancesFor,
   parseNominalFromMeasurement,
   checkOneMeasurementFor,
+  checkMultipleMeasurementsFor,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mechanical-tolerance-calculator",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Calculates international standard specification and  tolerances for bores, round bars and metals of mechanical units. For examples; H7, H8, H9, h8, h9 specifications and IT5/IT6 tolerances.",
   "main": "index.js",
   "scripts": {