fable 3.1.50 → 3.1.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fable",
-  "version": "3.1.50",
+  "version": "3.1.51",
   "description": "A service dependency injection, configuration and logging library.",
   "main": "source/Fable.js",
   "scripts": {

package/source/services/Fable-Service-ExpressionParser/Fable-Service-ExpressionParser-FunctionMap.json

@@ -119,6 +119,30 @@
 		"Name": "Mode",
 		"Address": "fable.Math.modePrecise"
 	},
+	"var": {
+		"Name": "Variance (Sample)",
+		"Address": "fable.Math.variancePrecise"
+	},
+	"vara": {
+		"Name": "Variance (Sample)",
+		"Address": "fable.Math.variancePrecise"
+	},
+	"varp": {
+		"Name": "Variance (Population)",
+		"Address": "fable.Math.populationVariancePrecise"
+	},
+	"stdev": {
+		"Name": "Standard Deviation (Sample)",
+		"Address": "fable.Math.standardDeviationPrecise"
+	},
+	"stdeva": {
+		"Name": "Standard Deviation (Sample)",
+		"Address": "fable.Math.standardDeviationPrecise"
+	},
+	"stdevp": {
+		"Name": "Standard Deviation (Population)",
+		"Address": "fable.Math.populationStandardDeviationPrecise"
+	},
 	"round": {
 		"Name": "Round",
 		"Address": "fable.Math.roundPrecise"

package/source/services/Fable-Service-Math.js

@@ -1438,7 +1438,7 @@ class FableServiceMath extends libFableServiceBase
 	/**
 	 * Calculates the precise mean of a given value set.
 	 *
-	 * @param {Array<number>} pValueSet - The array of values to calculate the mean.
+	 * @param {Array<string|number>} pValueSet - The array of values to calculate the mean.
 	 * @returns {string} The precise mean value as a string.
 	 */
 	meanPrecise(pValueSet)
@@ -1455,8 +1455,8 @@ class FableServiceMath extends libFableServiceBase
 	/**
 	 * Calculates the average of an array of values precisely.
 	 *
-	 * @param {Array<number>} pValueSet - The array of values to calculate the average of.
-	 * @returns {number} The precise average of the values.
+	 * @param {Array<string|number>} pValueSet - The array of values to calculate the average of.
+	 * @returns {string} The precise average of the values.
 	 */
 	averagePrecise(pValueSet)
 	{
@@ -1527,6 +1527,68 @@ class FableServiceMath extends libFableServiceBase
 		return tmpModeValueSet;
 	}
 
+	/**
+	 * Calculates the variance of a given value set using precise mode calculation.
+	 *
+	 * @param {Array<string|number>} pValueSet - The array of values to calculate the variance from.
+	 * @param {boolean} [pIsPopulation=false] - Whether to calculate population variance (true) or sample variance (false).
+	 *
+	 * @return {string} - The variance of the given value set.
+	 */
+	variancePrecise(pValueSet, pIsPopulation = false)
+	{
+		let tmpValueSet = pValueSet;
+		if (!Array.isArray(tmpValueSet) && typeof tmpValueSet === 'object')
+		{
+			tmpValueSet = Object.keys(tmpValueSet).map((pKey) => tmpValueSet[pKey]);
+		}
+		const tmpMeanValue = this.meanPrecise(tmpValueSet);
+		const tmpVarianceSum = tmpValueSet.reduce((pAccumulator, pValue) =>
+		{
+			const tmpDiff = this.subtractPrecise(pValue, tmpMeanValue);
+			const tmpSquaredDiff = this.multiplyPrecise(tmpDiff, tmpDiff);
+			return this.addPrecise(pAccumulator, tmpSquaredDiff);
+		}, '0.0');
+		return this.dividePrecise(tmpVarianceSum, pIsPopulation ? tmpValueSet.length : tmpValueSet.length - 1);
+	}
+
+	/**
+	 * Calculates the variance of a given population of values using precise mode calculation.
+	 *
+	 * @param {Array<string|number>} pValueSet - The array of values to calculate the variance from.
+	 *
+	 * @return {string} - The variance of the given value set.
+	 */
+	populationVariancePrecise(pValueSet)
+	{
+		return this.variancePrecise(pValueSet, true);
+	}
+
+	/**
+	 * Calculates the standard deviation of a given value set using precise mode calculation.
+	 *
+	 * @param {Array<string|number>} pValueSet - The array of values to calculate the standard deviation from.
+	 * @param {boolean} [pIsPopulation=false] - Whether to calculate population variance (true) or sample variance (false).
+	 *
+	 * @return {string} - The standard deviation of the given value set.
+	 */
+	standardDeviationPrecise(pValueSet, pIsPopulation = false)
+	{
+		return this.sqrtPrecise(this.variancePrecise(pValueSet, pIsPopulation));
+	}
+
+	/**
+	 * Calculates the standard deviation of a given population of values using precise mode calculation.
+	 *
+	 * @param {Array<string|number>} pValueSet - The array of values to calculate the standard deviation from.
+	 *
+	 * @return {string} - The standard deviation of the given value set.
+	 */
+	populationStandardDeviationPrecise(pValueSet)
+	{
+		return this.standardDeviationPrecise(pValueSet, true);
+	}
+
 	/**
 	 * Performs an nth degree polynomial regression on the given data points.
 	 *

package/test/ExpressionParser_tests.js

@@ -347,6 +347,8 @@ suite
 									Expect(_Parser.solve("TotalCost = MEAN(ItemCosts)", { "ItemCosts": [100, 200, 50, 45, 5] })).to.equal("80");
 									Expect(_Parser.solve("TotalCost = MEDIAN(ItemCosts)", { "ItemCosts": [100, 200, 50, 45, 5] })).to.equal("50");
 									Expect(_Parser.solve("TotalCost = COUNT(ItemCosts)", { "ItemCosts": [100, 200, 50, 45, 5] })).to.equal("5");
+									Expect(Number(_Parser.solve("StDev = STDEV(Values)", { "Values": [1,2,3,4,5,6,7,8,9,10,11] }))).to.be.closeTo(3.3166, 0.0001);
+									Expect(Number(_Parser.solve("StDevP = STDEVP(Values)", { "Values": [1,2,3,4,5,6,7,8,9,10,11] }))).to.be.closeTo(3.1623, 0.0001);
 
 									_Parser.fable.AppData = {
 										Teams: [

package/test/Math_test.js

@@ -316,6 +316,31 @@ suite
 
 						let tmpChocoSizes = testManyfest.getValueAtAddress(_ChocoData, 'files[].size');
 
+						Expect(testFable.Math.variancePrecise([1, 2, 3])).to.equal('1');
+						Expect(Number(testFable.Math.populationVariancePrecise([1, 2, 3]))).to.be.closeTo(0.6667, 0.0001);
+						Expect(testFable.Math.standardDeviationPrecise([1, 2, 3])).to.equal('1');
+						Expect(Number(testFable.Math.populationStandardDeviationPrecise([1, 2, 3]))).to.be.closeTo(0.8165, 0.0001);
+						try
+						{
+							testFable.Math.variancePrecise([1]);
+							Expect.fail('Expected error for sample variance with single value');
+						}
+						catch (pError)
+						{
+							Expect(pError).to.be.an.instanceof(Error);
+							Expect(pError.message).to.equal('[big.js] Division by zero');
+						}
+						try
+						{
+							testFable.Math.standardDeviationPrecise([1]);
+							Expect.fail('Expected error for sample standard deviation with single value');
+						}
+						catch (pError)
+						{
+							Expect(pError).to.be.an.instanceof(Error);
+							Expect(pError.message).to.equal('[big.js] Division by zero');
+						}
+
 						Expect(testFable.Math.maxPrecise(tmpChocoSizes)).to.equal("31625216");
 						Expect(testFable.Math.minPrecise(tmpChocoSizes)).to.equal("620");
 						Expect(testFable.Math.sumPrecise(tmpChocoSizes)).to.equal("36431778");
@@ -324,6 +349,8 @@ suite
 						Expect(testFable.Math.medianPrecise(tmpChocoSizes)).to.equal("5993");
 						// Since the file sizes are all different, this is just the whole list.
 						Expect(testFable.Math.modePrecise(tmpChocoSizes)).to.deep.equal(["620","838","1371","3383","3503","4093","4951","5993","6843","7481","8388","31141","101114","2248166","2378677","31625216","NaN"]);
+						Expect(Number(testFable.Math.standardDeviationPrecise(tmpChocoSizes))).to.be.closeTo(7635456.5390, 0.0001);
+						Expect(Number(testFable.Math.populationStandardDeviationPrecise(tmpChocoSizes))).to.be.closeTo(7407480.8965, 0.0001);
 
 						Expect(testFable.Math.maxPrecise([100, 101, 400, "20", "dog"])).to.equal("400");
 						Expect(testFable.Math.modePrecise([100, 20, 101, 400, "20", "dog"])).to.deep.equal(["20"]);
@@ -351,6 +378,8 @@ suite
 						Expect(testFable.Math.meanPrecise([1,2,3,4,5,6,7,8,9,10,11])).to.equal('6');
 						Expect(testFable.Math.medianPrecise([1,2,3,4,5,6,7,8,9,10,11])).to.equal('6');
 						Expect(testFable.Math.modePrecise([1,2,3,4,5,6,7,8,9,10,11])).to.deep.equal(['1','2','3','4','5','6','7','8','9','10','11']);
+						Expect(Number(testFable.Math.standardDeviationPrecise([1,2,3,4,5,6,7,8,9,10,11]))).to.be.closeTo(3.3166, 0.0001);
+						Expect(Number(testFable.Math.populationStandardDeviationPrecise([1,2,3,4,5,6,7,8,9,10,11]))).to.be.closeTo(3.1623, 0.0001);
 
 						return fDone();
 					}