TRY NEW VERSION

STANDARDIZE

STANDARDIZE(arg1, arg2, arg3) → { number }

Returns a normalised value from a distribution characterised by a mean and standard deviation.

Parameters:

Name Type Description
arg1 number

The value to normalize.

arg2 number

The arithmetic mean of the distribution.

arg3 number

The standard deviation of the distribution, a positive number.

Returns:

Type
number

Example

Copy code
builder.CreateFile("xlsx");

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);

builder.SaveFile("xlsx", "STANDARDIZE.xlsx");
builder.CloseFile();

Resulting document