standard_deviation.js

import variance from "./variance.js";

/**
 * [标准差](http://en.wikipedia.org/wiki/Standard_deviation)
 * 是方差的平方根。这也被称为总体标准差。它用于衡量一组值中的变异或离散程度。
 *
 * 标准差仅适用于全总体数据：对于样本数据，使用 {@link sampleStandardDeviation} 更为合适。
 *
 * @param {Array<number>} x 输入数组
 * @returns {number} 标准差
 * @example
 * variance([2, 4, 4, 4, 5, 5, 7, 9]); // => 4
 * standardDeviation([2, 4, 4, 4, 5, 5, 7, 9]); // => 2
 */
function standardDeviation(x) {
    if (x.length === 1) {
        return 0;
    }
    const v = variance(x);
    return Math.sqrt(v);
}

export default standardDeviation;