z_score.js

/**
 * [Z分数（标准分数）](http://en.wikipedia.org/wiki/Standard_score)计算函数。
 *
 * 标准分数表示观测值与均值的偏离程度，以标准差为单位计量。正值表示高于均值，
 * 负值表示低于均值。其计算方式为：原始分数减去总体均值，再除以总体标准差，
 * 结果为无量纲量。
 *
 * 注意：Z分数的计算需要已知总体参数（μ和σ）；若仅有样本数据，
 * 使用样本均值和样本标准差计算将得到学生t统计量。
 *
 * @param {number} x 观测值
 * @param {number} mean 总体均值
 * @param {number} standardDeviation 总体标准差
 * @returns {number} Z分数
 * @example
 * zScore(78, 80, 5); // => -0.4
 */
function zScore(x, mean, standardDeviation) {
    return (x - mean) / standardDeviation;
}

export default zScore;