Sampling Distributions
Install and import#
npm install fintech-algorithmsimport { samplingDistributions } from "fintech-algorithms/foundations/sampling-estimation-and-statistical-inference/sampling-distributions";Signature#
samplingDistributions(input)Summarises the replicated estimates in input.estimates as a sampling distribution: where it centres, how wide it is, and how many replications produced it.
Parameters#
| Name | Type | Notes |
|---|---|---|
input | D00Input | One record. estimates holds one value per replication. sample and alpha are validated for the whole family before dispatch, so they must be present and valid here too.sample: non-empty list of finite numbers, at least two of them · estimates: non-empty list of finite numbers · alpha: strictly between 0 and 1 |
Returns#
D00Output
An object with samplingMean, samplingStandardDeviation (the sample standard deviation across replications, n-1 denominator) and replications.
Errors#
- When sample or estimates is missing, empty, or contains a non-finite number — both are parsed for every topic in the family, whether or not the topic uses them — throws RangeError
- When sample holds fewer than two observations — throws RangeError
- When alpha is not strictly between zero and one — throws RangeError
- When estimates holds fewer than two values — throws RangeError
Complexity: time O(n + m),
space O(n + m).
Worked example#
verified This is the worked example published in the article, replayed by the test suite on every run. The output cannot drift.
Input#
{
"sample": [2, 3, 4, 3, 4],
"estimates": [3, 3.1, 3.2, 3.3, 3.4],
"populationMean": 3.2,
"alpha": 0.05,
"mseBenchmark": 0.1,
"nullMean": 3,
"alternativeMean": 3.5,
"practicalThreshold": 0.1,
"comparisons": 5
}Call#
samplingDistributions(input)Returns#
object with 2 fields: samplingMean, samplingStandardDeviation
{
"samplingMean": 3.2,
"samplingStandardDeviation": 0.1581138830084189
}Diagrams#
How it works#
This page states the contract — how to call it correctly. The article explains the concept: why it works, and where it breaks.
References#
- Product and Process Comparisons — NIST/SEMATECH e-Handbook
- Confidence Intervals — NIST/SEMATECH e-Handbook
- Historical-example decision