Skip to content

Main content

Binomial Distribution Sampler Source Code

Browse the implementation files for Binomial Distribution Sampler.
tool.ts typescript
import { parseFiniteNumber } from '../../parse/number/tool';
import { parseInteger } from '../../parse/integer/tool';
import { createSeededRandom } from '../../random/seeded-number/tool';

export const sampleBinomial = (
	trialsInput: unknown,
	probabilityInput: unknown,
	countInput: unknown,
	seedInput: unknown
): string => {
	const trials = parseInteger(trialsInput);
	const probability = parseFiniteNumber(probabilityInput);
	const count = parseInteger(countInput);
	if (
		trials === null ||
		trials < 0 ||
		trials > 1_000_000 ||
		probability === null ||
		probability < 0 ||
		probability > 1 ||
		count === null ||
		count < 1 ||
		count > 10_000 ||
		trials * count > 10_000_000 ||
		typeof seedInput !== 'string' ||
		!seedInput.trim()
	)
		return '';
	const random = createSeededRandom(seedInput);
	const samples = Array.from({ length: count }, () => {
		if (probability === 0) return 0;
		if (probability === 1) return trials;
		let successes = 0;
		for (let trial = 0; trial < trials; trial += 1)
			if (random() < probability) successes += 1;
		return successes;
	});
	return JSON.stringify(
		{ count, probability, samples, seed: seedInput, trials },
		null,
		2
	);
};

export const Tool: TypeTool = {
	name: 'Binomial Distribution Sampler',
	slug: 'probability/binomial-sampler',
	intro: 'Generate reproducible binomial random samples.',
	tool: sampleBinomial,
	i: [
		{
			example: '10',
			label: 'Trials',
			placeholder: 'Trials per sample',
			type: 'number'
		},
		{
			example: '0.5',
			label: 'Success Probability',
			placeholder: 'Probability from 0 to 1',
			type: 'number'
		},
		{
			example: '20',
			label: 'Sample Count',
			placeholder: 'Number of samples',
			type: 'number'
		},
		{
			example: 'tool.io',
			label: 'Seed',
			placeholder: 'Reproducible seed',
			type: 'text'
		}
	],
	o: [
		{
			example: '{ "samples": [4, 6] }',
			label: 'Samples',
			placeholder: 'Samples will appear here...',
			render: 'textarea',
			type: 'text'
		}
	],
	rerunnable: true,
	cite: [
		{
			title: 'Binomial distribution - Wikipedia',
			url: 'https://en.wikipedia.org/wiki/Binomial_distribution'
		}
	]
};
export default Tool;

Description

Browse the implementation files for Binomial Distribution Sampler.

References

  1. Tool.io on GitHub
  2. Tool.io TypeScript tools library

Similar or alternative tools