STANDARDIZE
Returns a normalised value from a distribution characterised by a mean and standard deviation.
Syntax
expression.STANDARDIZE(arg1, arg2, arg3);
expression - A variable that represents a ApiWorksheetFunction class.
Parameters
| Name | Required/Optional | Data type | Default | Description |
|---|---|---|---|---|
| arg1 | Required | ApiRange | ApiName | number |
| arg2 | Required | ApiRange | ApiName | number |
| arg3 | Required | ApiRange | ApiName | number |
Returns
number
Example
const oWorksheet = Api.GetActiveSheet();
var valueArr = [5, -2, 10];
// Place the numbers in cells
for (var i = 0; i < valueArr.length; i++) {
oWorksheet.GetRange("A" + (i + 1)).SetValue(valueArr[i]);
}
// method params
var x = oWorksheet.GetRange("A1");
var mean = oWorksheet.GetRange("A2");
var stdDev = oWorksheet.GetRange("A3");
var oFunction = Api.GetWorksheetFunction();
var ans = oFunction.STANDARDIZE(x, mean, stdDev);
oWorksheet.GetRange("C1").SetValue(ans);