Unit Computation with Pint

Cognitive prosthetics for unit-aware computation. Use Pint for converting between units, performing unit arithmetic, checking dimensional compatibility, and simplifying compound units.

When to Use

• Converting between units (meters to feet, kg to pounds)

• Unit-aware arithmetic (velocity x time = distance)

• Dimensional analysis (is force = mass x acceleration?)

• Simplifying compound units to base or named units

• Parsing and analyzing quantities with units

Quick Reference

I want to...

Command

Example

Convert units

convert

convert "5 meters" --to feet

Unit math

calc

calc "10 m/s * 5 s"

Check dimensions

check

check newton --against "kg * m / s^2"

Parse quantity

parse

parse "100 km/h"

Simplify units

simplify

simplify "1 kg*m/s^2"

Commands

parse

Parse a quantity string into magnitude, units, and dimensionality.

uv run python -m runtime.harness scripts/pint_compute.py \

    parse "100 km/h"

uv run python -m runtime.harness scripts/pint_compute.py \

    parse "9.8 m/s^2"

convert

Convert a quantity to different units.

uv run python -m runtime.harness scripts/pint_compute.py \

    convert "5 meters" --to feet

uv run python -m runtime.harness scripts/pint_compute.py \

    convert "100 km/h" --to mph

uv run python -m runtime.harness scripts/pint_compute.py \

    convert "1 atmosphere" --to pascal

calc

Perform unit-aware arithmetic. Operators must be space-separated.

uv run python -m runtime.harness scripts/pint_compute.py \

    calc "5 m * 3 s"

uv run python -m runtime.harness scripts/pint_compute.py \

    calc "10 m / 2 s"

uv run python -m runtime.harness scripts/pint_compute.py \

    calc "5 meters + 300 cm"

check

Check if two units have compatible dimensions.

uv run python -m runtime.harness scripts/pint_compute.py \

    check newton --against "kg * m / s^2"

uv run python -m runtime.harness scripts/pint_compute.py \

    check joule --against "kg * m^2 / s^2"

simplify

Simplify compound units to base or compact form.

uv run python -m runtime.harness scripts/pint_compute.py \

    simplify "1 kg*m/s^2"

uv run python -m runtime.harness scripts/pint_compute.py \

    simplify "1000 m"

Common Unit Domains

Domain

Examples

Length

meter, foot, inch, mile, km, yard

Time

second, minute, hour, day, year

Mass

kg, gram, pound, ounce, ton

Velocity

m/s, km/h, mph, knot

Energy

joule, calorie, eV, kWh, BTU

Force

newton, pound_force, dyne

Temperature

kelvin, celsius, fahrenheit

Pressure

pascal, bar, atmosphere, psi

Power

watt, horsepower

Output Format

All commands return JSON with relevant fields:

{

  "result": "16.4042 foot",

  "magnitude": 16.4042,

  "units": "foot",

  "dimensionality": "[length]",

  "latex": "16.4042\\,\\mathrm{ft}"

}

Error Handling

Dimensionality errors are caught and reported:

# This will error - incompatible dimensions

uv run python -m runtime.harness scripts/pint_compute.py \

    convert "5 meters" --to kg

# Error: Cannot convert '[length]' to '[mass]'

Related Skills

• /math-mode - Full math orchestration (SymPy + Z3)

• /sympy-compute - Symbolic computation