BestUnits

Библиотека для работы с физическими величинами и единицами измерений на Python.
Позволяет выполнять операции с размерностями, учитывать погрешности, работать с составными единицами и анализировать формулы.

⚠️ Важно: это ранняя версия (MVP). Разработка продолжается, интерфейсы могут измениться, а часть функционала пока только в планах.

---

Возможности (текущее состояние)

• Представление физических величин как объектов Quantity (значение + единицы + погрешность).
• Операции с размерностями через класс UnitBase (сложение, деление, умножение, степени).
• Базовые, составные и специальные единицы (СИ, производные, калории, эВ, парсек и др.).
• Простая обработка погрешностей (максимальное отклонение, среднеквадратическое отклонение).
• Поддержка символьного анализа размерностей (dimension_analysis.py с использованием SymPy). (потом уберу)
• Набор тестов для проверки корректности размерностей и префиксов.
• Используется Decimal для точных расчётов.

---

Примеры использования

from bestunits.quantity import Quantity
from bestunits.units_lib import kg, m, s

# Масса и ускорение
mass = Quantity(2, kg, error=0.1)
acc = Quantity(9.81, m / s**2)

# Сила
force = mass * acc
print(force)  # 19.62 ± 0.981 кг·м^1·с^-2

# Степени
area = Quantity(5, m) ** 2
print(area)  # 25 м^2

В планах (TODO)

• Методы .to(unit) и .normalize() для перевода в разные единицы.
• Поддержка составных единиц (например, Ньютон, Джоуль).
• Добавление физических констант (например, G, c, h).
• Парсер строковых значений (parse("9.81 м/с²" или "9.81 м/с^2") → Quantity).
• Автоматический выбор удобных единиц (.best_unit()).
• Вывод формул и величин в формате LaTeX.
• Поддержка пользовательских единиц.

Текущее состояние

• ⚠ MVP — это рабочая, но экспериментальная версия.
• Делаю другие проекты, так что всё пока что лишь на русском и документации пока нет.