Skip to content

Documentation / @interstellar-tools/equations / rad

Function: rad() ​

ts
function rad(x: number): Radians;

Defined in: helpers/radians.ts:42

Brand a numeric value as Radians.

This is a type-level helper only: it does not change the runtime value, but it prevents accidentally mixing degree-values with radian-values at compile time.

Use this when you already have a value in radians (e.g., from Math.atan2, Math.PI, or your own radian-based computations) and want to pass it to APIs that require Radians.

Parameters ​

ParameterTypeDescription
xnumberAngle value already expressed in radians.

Returns ​

Radians

The same numeric value, branded as Radians.

Example ​

ts
const theta = rad(Math.PI / 3);
// theta has type Radians