scooter-lacroix/pint-compute

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