@spec extract_float(Cldr.Unit.t()) :: float()

Extract the numeric value from a Cldr.Unit as a float.

Handles both integer and Decimal values.

@spec to_kilogram_square_meters(Cldr.Unit.t()) :: float()

Convert a moment of inertia unit to kg·m² (float).

Examples

iex> import BB.Unit
iex> BB.Robot.Units.to_kilogram_square_meters(~u(0.5 kilogram_square_meter))
0.5

@spec to_kilograms(Cldr.Unit.t()) :: float()

Convert a mass unit to kilograms (float).

Examples

iex> import BB.Unit
iex> BB.Robot.Units.to_kilograms(~u(1000 gram))
1.0

iex> import BB.Unit
iex> BB.Robot.Units.to_kilograms(~u(2.5 kilogram))
2.5

@spec to_linear_damping(Cldr.Unit.t()) :: float()

Convert a linear damping coefficient to N·s/m (float).

Examples

iex> import BB.Unit
iex> BB.Robot.Units.to_linear_damping(~u(1.5 newton_second_per_meter))
1.5

@spec to_meters(Cldr.Unit.t()) :: float()

Convert a length unit to meters (float).

Examples

iex> import BB.Unit
iex> BB.Robot.Units.to_meters(~u(100 centimeter))
1.0

iex> import BB.Unit
iex> BB.Robot.Units.to_meters(~u(1.5 meter))
1.5

@spec to_meters_or_nil(Cldr.Unit.t() | nil) :: float() | nil

Convert an optional unit value to its base SI float, or return nil.

@spec to_meters_per_second(Cldr.Unit.t()) :: float()

Convert a linear velocity unit to meters per second (float).

Examples

iex> import BB.Unit
iex> BB.Robot.Units.to_meters_per_second(~u(10 meter_per_second))
10.0

@spec to_meters_per_square_second(Cldr.Unit.t()) :: float()

Convert a linear acceleration unit to metres per second squared (float).

Examples

iex> import BB.Unit
iex> BB.Robot.Units.to_meters_per_square_second(~u(9.81 meter_per_square_second))
9.81

@spec to_newton(Cldr.Unit.t()) :: float()

Convert a force unit to newtons (float).

Examples

iex> import BB.Unit
iex> BB.Robot.Units.to_newton(~u(5 newton))
5.0

@spec to_newton_meters(Cldr.Unit.t()) :: float()

Convert a torque unit to newton-meters (float).

Examples

iex> import BB.Unit
iex> BB.Robot.Units.to_newton_meters(~u(5 newton_meter))
5.0

@spec to_newtons(Cldr.Unit.t()) :: float()

Convert a force unit to newtons (float).

Examples

iex> import BB.Unit
iex> BB.Robot.Units.to_newtons(~u(10 newton))
10.0

@spec to_radians(Cldr.Unit.t()) :: float()

Convert an angle unit to radians (float).

Examples

iex> import BB.Unit
iex> BB.Robot.Units.to_radians(~u(180 degree))
:math.pi()

iex> import BB.Unit
iex> BB.Robot.Units.to_radians(~u(0 degree))
0.0

@spec to_radians_per_second(Cldr.Unit.t()) :: float()

Convert an angular velocity unit to radians per second (float).

Examples

iex> import BB.Unit
iex> BB.Robot.Units.to_radians_per_second(~u(180 degree_per_second))
:math.pi()

@spec to_radians_per_square_second(Cldr.Unit.t()) :: float()

Convert an angular acceleration unit to radians per second squared (float).

Examples

iex> import BB.Unit
iex> BB.Robot.Units.to_radians_per_square_second(~u(360 degree_per_square_second))
:math.pi() * 2

@spec to_rotational_damping(Cldr.Unit.t()) :: float()

Convert a rotational damping coefficient to N·m·s/rad (float).

Note: The DSL uses newton_meter_second_per_degree but we convert to radians for consistency with other angular quantities.