plestylib.data.units
====================

.. py:module:: plestylib.data.units


Classes
-------

.. autoapisummary::

   plestylib.data.units.Units


Module Contents
---------------

.. py:class:: Units(dims: Optional[Dict[str, int]] = None, factor: float = 1.0)

   Standardized unit expression parser and composer.

   The internal representation tracks:
   - ``dims``: dimension exponents, e.g. {"L": 1, "T": -1} for speed
   - ``factor``: numeric scaling factor to SI base units


   .. py:attribute:: SYMBOLS


   .. py:attribute:: BASE_SYMBOLS


   .. py:attribute:: dims


   .. py:attribute:: factor


   .. py:method:: scalar() -> Units
      :classmethod:



   .. py:method:: parse(unit_str: Optional[str]) -> Optional[Units]
      :classmethod:



   .. py:method:: standardize(unit_str: Optional[str]) -> Optional[str]
      :classmethod:



   .. py:method:: compatible(other: Units) -> bool


   .. py:method:: conversion_scale_to(target: Units) -> float


   .. py:method:: multiply(other: Units) -> Units


   .. py:method:: divide(other: Units) -> Units


   .. py:method:: power(exponent: int) -> Units


   .. py:method:: to_unit_string() -> Optional[str]


