pint-compute

Pint による単位計算

単位を考慮した計算を支援します。Pint を使って、単位の変換、単位を考慮した算術演算、次元の互換性チェック、複合単位の簡略化を行います。

使用する場面

• 単位を変換するとき（メートルからフィート、kg からポンド）
• 単位を考慮した算術演算を行うとき（速度 × 時間 = 距離）
• 次元解析を行うとき（力 = 質量 × 加速度か？）
• 複合単位を基本単位または名称付き単位に簡略化するとき
• 単位付きの量を解析するとき

クイックリファレンス

したいこと	コマンド	例
単位を変換する	convert	convert "5 meters" --to feet
単位計算を行う	calc	calc "10 m/s * 5 s"
次元を確認する	check	check newton --against "kg * m / s^2"
量を解析する	parse	parse "100 km/h"
単位を簡略化する	simplify	simplify "1 kg*m/s^2"

コマンド

parse

量の文字列を大きさ、単位、次元に解析します。

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

量を別の単位に変換します。

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

単位を考慮した算術演算を行います。演算子はスペースで区切る必要があります。

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

2 つの単位の次元に互換性があるか確認します。

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

複合単位を基本形式または簡潔な形式に簡略化します。

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"

よく使われる単位の分野

分野	例
長さ	meter, foot, inch, mile, km, yard
時間	second, minute, hour, day, year
質量	kg, gram, pound, ounce, ton
速度	m/s, km/h, mph, knot
エネルギー	joule, calorie, eV, kWh, BTU
力	newton, pound_force, dyne
温度	kelvin, celsius, fahrenheit
圧力	pascal, bar, atmosphere, psi
電力	watt, horsepower

出力形式

すべてのコマンドは、関連するフィールドを含む JSON を返します。

{
  "result": "16.4042 foot",
  "magnitude": 16.4042,
  "units": "foot",
  "dimensionality": "[length]",
  "latex": "16.4042\\,\\mathrm{ft}"
}

エラー処理

次元のエラーを捕捉して報告します。

# 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]'

関連スキル

• /math-mode - 数学処理全般（SymPy + Z3）
• /sympy-compute - 記号計算