w-statistic
Version:
A tool for statistical analysis.
175 lines (127 loc) • 6.52 kB
HTML
<html lang="en">
<head>
<meta charset="utf-8">
<title>arrNormHist.mjs - Documentation</title>
<script src="scripts/prettify/prettify.js"></script>
<script src="scripts/prettify/lang-css.js"></script>
<!--[if lt IE 9]>
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
<link type="text/css" rel="stylesheet" href="styles/prettify.css">
<link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
<script src="scripts/nav.js" defer></script>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
</head>
<body>
<input type="checkbox" id="nav-trigger" class="nav-trigger" />
<label for="nav-trigger" class="navicon-button x">
<div class="navicon"></div>
</label>
<label for="nav-trigger" class="overlay"></label>
<nav >
<h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="w-statistic.html">w-statistic</a><ul class='methods'><li data-type='method'><a href="w-statistic.html#.arrAverage">arrAverage</a></li><li data-type='method'><a href="w-statistic.html#.arrAverageWithLogNormCI">arrAverageWithLogNormCI</a></li><li data-type='method'><a href="w-statistic.html#.arrAverageWithNormCI">arrAverageWithNormCI</a></li><li data-type='method'><a href="w-statistic.html#.arrCount">arrCount</a></li><li data-type='method'><a href="w-statistic.html#.arrGammaFit">arrGammaFit</a></li><li data-type='method'><a href="w-statistic.html#.arrGammaHist">arrGammaHist</a></li><li data-type='method'><a href="w-statistic.html#.arrGammaInv">arrGammaInv</a></li><li data-type='method'><a href="w-statistic.html#.arrGeometricAverage">arrGeometricAverage</a></li><li data-type='method'><a href="w-statistic.html#.arrGeometricStd">arrGeometricStd</a></li><li data-type='method'><a href="w-statistic.html#.arrLogNormHist">arrLogNormHist</a></li><li data-type='method'><a href="w-statistic.html#.arrLogNormInv">arrLogNormInv</a></li><li data-type='method'><a href="w-statistic.html#.arrMovingAverage">arrMovingAverage</a></li><li data-type='method'><a href="w-statistic.html#.arrNormHist">arrNormHist</a></li><li data-type='method'><a href="w-statistic.html#.arrNormInv">arrNormInv</a></li><li data-type='method'><a href="w-statistic.html#.arrQuartile">arrQuartile</a></li><li data-type='method'><a href="w-statistic.html#.arrStd">arrStd</a></li><li data-type='method'><a href="w-statistic.html#.bin">bin</a></li><li data-type='method'><a href="w-statistic.html#.histGen">histGen</a></li><li data-type='method'><a href="w-statistic.html#.regLine">regLine</a></li><li data-type='method'><a href="w-statistic.html#.regMpLine">regMpLine</a></li><li data-type='method'><a href="w-statistic.html#.regPoly">regPoly</a></li><li data-type='method'><a href="w-statistic.html#.regPower">regPower</a></li><li data-type='method'><a href="w-statistic.html#.sampleRandom">sampleRandom</a></li><li data-type='method'><a href="w-statistic.html#.studentTInv">studentTInv</a></li></ul></li></ul>
</nav>
<div id="main">
<h1 class="page-title">arrNormHist.mjs</h1>
<section>
<article>
<pre class="prettyprint source linenums"><code>import size from 'lodash-es/size.js'
import map from 'lodash-es/map.js'
import isarr from 'wsemi/src/isarr.mjs'
import arrAverage from './arrAverage.mjs'
import arrStd from './arrStd.mjs'
import histGen from './histGen.mjs'
// import jt from './jStat.mjs'
/**
* 基於常態分布計算陣列數據分組直方圖、統計與趨勢線數據
*
* Unit Test: {@link https://github.com/yuda-lyu/w-statistic/blob/master/test/arrNormHist.test.js Github}
* @memberOf w-statistic
* @param {Array} arr 輸入陣列，只提取有效數字(或為字串的數字)進行計算
* @param {Object} [opt={}] 輸入設定物件，預設{}
* @param {Number} [opt.dx=null] 輸入直方圖分組(x軸)寬度數字，預設null
* @param {Integer} [opt.n=30] 輸入直方圖分組(x軸)數量整數，預設30
* @param {Integer} [opt.nCurve=100] 輸入擬合用陣列數據長度整數，預設100
* @param {Number} [opt.min=null] 輸入直方圖分組(x軸)最小值數字，若不給則使用數據最小值，預設null
* @param {Number} [opt.max=null] 輸入直方圖分組(x軸)最大值數字，若不給則使用數據最大值，預設null
* @returns {Number} 回傳反函數值
* @example
*
* async function test() {
* }
* test()
* .catch((err) => {
* console.log(err)
* })
*
*/
async function arrNormHist(arr, opt = {}) {
//check arr
if (!isarr(arr)) {
return Promise.reject('arr is not an array')
}
if (size(arr) === 0) {
return Promise.reject('arr is not an effective array')
}
//histGen
let avg = null
let std = null
let r = await histGen(arr, (params) => {
// console.log('params', params)
//avg, 得使用callback內arr為有效數據
avg = arrAverage(params.arr)
//std, 得使用callback內arr為有效數據
std = arrStd(params.arr)
//ry
let ry = (std * Math.sqrt(2 * Math.PI))
//curveY
let curveY = map(params.curveX, (x) => {
let y = 0
if (ry !== 0) {
y = 1 / ry * Math.exp(-((x - avg) ** 2) / (2 * std ** 2))
}
return y
})
return curveY
}, opt)
//merge pdfs
let bins = map(r.bins, (v, k) => {
v.pdf = r.pdfs[k]
return v
})
//merge curveX, curveY
let curves = map(r.curveX, (v, k) => {
return {
x: v,
pdf: r.curveY[k],
}
})
//res
let res = {
avg,
std,
arr: r.arr,
min: r.min,
max: r.max,
barWidth: r.barWidth,
ratioForCountToPdf: r.ratioForCountToPdf,
bins,
curves,
}
return res
}
export default arrNormHist
</code></pre>
</article>
</section>
</div>
<br class="clear">
<footer>
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.2</a> on Tue Jul 29 2025 14:21:18 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
</footer>
<script>prettyPrint();</script>
<script src="scripts/polyfill.js"></script>
<script src="scripts/linenumber.js"></script>
</body>
</html>