Skip to content

Main content

Throw Distance Calculator Source Code

Browse the implementation files for Throw Distance Calculator.
tool.ts typescript
const parseFinite = (value: unknown): number | null => {
	if (value === '' || value === null || value === undefined)
		return null;
	const parsed = Number(value);
	return Number.isFinite(parsed) ? parsed : null;
};

export const calculateThrowDistance = (
	beamDiameterInput: unknown,
	beamAngleInput: unknown
) => {
	const beamDiameter = parseFinite(beamDiameterInput);
	const beamAngle = parseFinite(beamAngleInput);
	if (
		beamDiameter === null ||
		beamDiameter < 0 ||
		beamAngle === null ||
		beamAngle <= 0 ||
		beamAngle >= 180
	)
		return '';

	const halfAngleRadians = (beamAngle * Math.PI) / 360;
	return beamDiameter / (2 * Math.tan(halfAngleRadians));
};

export const Tool: TypeTool = {
	name: 'Throw Distance Calculator',
	slug: 'lighting/throw-distance-calculator',
	tool: calculateThrowDistance,
	intro:
		'Calculate how far a light must be from a surface to produce a specified beam diameter at a known full beam angle.',
	i: [
		{
			example: '2',
			label: 'Beam diameter',
			placeholder: 'Meters (m)',
			type: 'number'
		},
		{
			example: '30',
			label: 'Full beam angle',
			placeholder: 'Degrees (°)',
			type: 'number'
		}
	],
	o: [
		{
			example: '3.7320508075688776',
			label: 'Throw distance',
			placeholder: 'Meters (m)',
			render: 'textarea',
			type: 'number'
		}
	],
	equation: 'r = d / (2 × tan(θ / 2))',
	alternative: [
		{
			title: 'Beam Angle Calculator',
			url: '/lighting/beam-angle-calculator'
		},
		{
			title: 'Candela to Lux Calculator',
			url: '/lighting/candela-to-lux-calculator'
		},
		{ title: 'Convert length', url: '/convert/length' }
	],
	cite: [
		{
			title: 'Angular diameter — Wikipedia',
			url: 'https://en.wikipedia.org/wiki/Angular_diameter'
		}
	]
};

export default Tool;

Description

Browse the implementation files for Throw Distance Calculator.

References

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

Similar or alternative tools