qnty 0.0.9__py3-none-any.whl → 0.1.0__py3-none-any.whl

qnty/__init__.py

@@ -20,7 +20,8 @@ from .expressions import (
     sqrt,
     tan,
 )
-from .generated.quantities import (
+from .problems import Problem
+from .quantities.field_vars import (
     AbsorbedDose,
     Acceleration,
     ActivationEnergy,
@@ -129,7 +130,6 @@ from .generated.quantities import (
     VolumetricMassFlowRate,
     Wavenumber,
 )
-from .problem import Problem
 
 # Define public API
 __all__ = [
@@ -253,4 +253,3 @@ __all__ = [
     "VolumetricMassFlowRate",
     "Wavenumber",
 ]
-

qnty/constants/__init__.py

@@ -0,0 +1,10 @@
+"""
+Mathematical and numerical constants used throughout the qnty library.
+
+This module centralizes magic numbers and tolerances to improve maintainability
+and consistency across the codebase.
+"""
+
+from .numerical import *
+from .solvers import *
+from .tests import *

qnty/constants/numerical.py

@@ -0,0 +1,18 @@
+# Numerical tolerances for floating point comparisons
+FLOAT_EQUALITY_TOLERANCE = 1e-10
+"""Default tolerance for floating point equality comparisons."""
+
+DIVISION_BY_ZERO_THRESHOLD = 1e-15
+"""Threshold below which a value is considered effectively zero for division."""
+
+CONDITION_EVALUATION_THRESHOLD = 1e-10
+"""Threshold for evaluating conditional expressions as true/false."""
+
+DIMENSIONAL_PRECISION_TOLERANCE = 1e-10
+"""Tolerance for dimensional signature comparisons."""
+
+PREFIX_LOOKUP_TOLERANCE = 1e-10
+"""Default tolerance for SI prefix factor lookup."""
+
+PREFIX_LOOKUP_MIN_TOLERANCE = 1e-15
+"""Minimum tolerance for SI prefix factor lookup to avoid expensive searches."""

qnty/constants/solvers.py

@@ -0,0 +1,6 @@
+# Solver defaults
+SOLVER_DEFAULT_TOLERANCE = 1e-10
+"""Default numerical tolerance for equation solving convergence."""
+
+SOLVER_DEFAULT_MAX_ITERATIONS = 100
+"""Default maximum iterations for iterative solvers."""

qnty/constants/tests.py

@@ -0,0 +1,6 @@
+# Test tolerances
+TEST_PRECISION_TOLERANCE = 1e-6
+"""Tolerance used in tests for validating calculated results."""
+
+TEST_DIMENSION_TOLERANCE = 1e-10
+"""Tolerance used in tests for dimensional signature comparisons."""

qnty/dimensions/__init__.py

@@ -0,0 +1,23 @@
+"""
+Core Dimensions Module
+======================
+
+Core dimensional analysis components providing compile-time type safety.
+
+This module provides the fundamental building blocks for qnty's dimensional analysis system:
+- BaseDimension: Prime-number-encoded base dimensions
+- DimensionSignature: Ultra-fast dimensional compatibility checking
+"""
+
+from .base import BASE_DIMENSIONS, DIMENSION_SYMBOLS, PRIME_MAP, BaseDimension, DimensionConfig
+from .field_dims import *  # noqa: F403
+from .signature import DimensionSignature
+
+__all__ = (
+    "BaseDimension",
+    "DimensionSignature",
+    "DimensionConfig",
+    "BASE_DIMENSIONS",
+    "DIMENSION_SYMBOLS",
+    "PRIME_MAP"
+)

qnty/dimensions/base.py

@@ -0,0 +1,97 @@
+"""
+Base Dimensions
+===============
+
+Core base dimensions using prime number encoding for efficient dimensional analysis.
+
+This file contains the fundamental dimensional primitives for the qnty system.
+"""
+
+from dataclasses import dataclass
+from enum import IntEnum
+from types import MappingProxyType
+
+
+class BaseDimension(IntEnum):
+    """Base dimensions as prime numbers for efficient bit operations."""
+
+    DIMENSIONLESS = 1  # Must be 1 to act as identity
+    LENGTH = 2
+    MASS = 3
+    TIME = 5
+    CURRENT = 7
+    TEMPERATURE = 11
+    AMOUNT = 13
+    LUMINOSITY = 17
+
+
+@dataclass(frozen=True)
+class DimensionConfig:
+    """Immutable configuration for a base dimension."""
+    prime: BaseDimension
+    params: MappingProxyType[str, int]
+
+
+# Immutable dimension symbols for display
+DIMENSION_SYMBOLS: MappingProxyType[str, str] = MappingProxyType(
+    {
+        "length": "L",
+        "mass": "M",
+        "time": "T",
+        "current": "A",
+        "temp": "Θ",
+        "amount": "N",
+        "luminosity": "J",
+    }
+)
+
+# Immutable base dimensions configuration for generators
+BASE_DIMENSIONS: MappingProxyType[str, DimensionConfig] = MappingProxyType(
+    {
+        "LENGTH": DimensionConfig(
+            BaseDimension.LENGTH,
+            MappingProxyType({"length": 1})
+        ),
+        "MASS": DimensionConfig(
+            BaseDimension.MASS,
+            MappingProxyType({"mass": 1})
+        ),
+        "TIME": DimensionConfig(
+            BaseDimension.TIME,
+            MappingProxyType({"time": 1})
+        ),
+        "CURRENT": DimensionConfig(
+            BaseDimension.CURRENT,
+            MappingProxyType({"current": 1})
+        ),
+        "TEMPERATURE": DimensionConfig(
+            BaseDimension.TEMPERATURE,
+            MappingProxyType({"temp": 1})
+        ),
+        "AMOUNT": DimensionConfig(
+            BaseDimension.AMOUNT,
+            MappingProxyType({"amount": 1})
+        ),
+        "LUMINOSITY": DimensionConfig(
+            BaseDimension.LUMINOSITY,
+            MappingProxyType({"luminosity": 1})
+        ),
+        "DIMENSIONLESS": DimensionConfig(
+            BaseDimension.DIMENSIONLESS,
+            MappingProxyType({})
+        ),
+    }
+)
+
+# Immutable prime mapping for signature calculations
+PRIME_MAP: MappingProxyType[str, BaseDimension] = MappingProxyType(
+    {
+        "length": BaseDimension.LENGTH,
+        "mass": BaseDimension.MASS,
+        "time": BaseDimension.TIME,
+        "current": BaseDimension.CURRENT,
+        "temp": BaseDimension.TEMPERATURE,
+        "amount": BaseDimension.AMOUNT,
+        "luminosity": BaseDimension.LUMINOSITY,
+    }
+)

qnty/dimensions/field_dims.py

@@ -0,0 +1,126 @@
+"""
+Dimension System
+================
+
+Compile-time dimensional analysis using type system for ultra-fast operations.
+
+This file contains dimension constants for all engineering fields.
+"""
+
+from .signature import DimensionSignature
+
+# Dimension signature constants - computed from prime factorization
+_SIGNATURES: dict[str, int | float] = {
+    "ABSORBED_DOSE": 0.16,  # L^2 T^-2
+    "ACCELERATION": 0.08,  # L T^-2
+    "ACTIVATION_ENERGY": 0.01230769231,  # N^-1 L^2 T^-2
+    "AMOUNT_OF_SUBSTANCE": 13,  # N
+    "ANGLE_PLANE": 1,  # Dimensionless
+    "ANGLE_SOLID": 1,  # Dimensionless
+    "ANGULAR_ACCELERATION": 0.04,  # T^-2
+    "ANGULAR_MOMENTUM": 2.4,  # L^2 M T^-1
+    "AREA": 4,  # L^2
+    "AREA_PER_UNIT_VOLUME": 0.5,  # L^-1
+    "ATOMIC_WEIGHT": 0.2307692308,  # N^-1 M
+    "CONCENTRATION": 0.375,  # L^-3 M
+    "DIMENSIONLESS": 1,  # Dimensionless
+    "DYNAMIC_FLUIDITY": 3.333333333,  # L M^-1 T
+    "ELECTRIC_CAPACITANCE": 2552.083333,  # A^2 L^-2 M^-1 T^4
+    "ELECTRIC_CHARGE": 2.692307692,  # N^-1 A T
+    "ELECTRIC_CURRENT_INTENSITY": 7,  # A
+    "ELECTRIC_DIPOLE_MOMENT": 70,  # A L T
+    "ELECTRIC_FIELD_STRENGTH": 0.006857142857,  # A^-1 L M T^-3
+    "ELECTRIC_INDUCTANCE": 0.009795918367,  # A^-2 L^2 M T^-2
+    "ELECTRIC_POTENTIAL": 0.01371428571,  # A^-1 L^2 M T^-3
+    "ELECTRIC_RESISTANCE": 0.001959183673,  # A^-2 L^2 M T^-3
+    "ELECTRICAL_CONDUCTANCE": 510.4166667,  # A^2 L^-2 M^-1 T^3
+    "ELECTRICAL_PERMITTIVITY": 1276.041667,  # A^2 L^-3 M^-1 T^4
+    "ELECTRICAL_RESISTIVITY": 0.003918367347,  # A^-2 L^3 M T^-3
+    "ENERGY_FLUX": 0.024,  # M T^-3
+    "ENERGY_HEAT_WORK": 0.48,  # L^2 M T^-2
+    "ENERGY_PER_UNIT_AREA": 0.12,  # M T^-2
+    "FORCE": 0.24,  # L M T^-2
+    "FORCE_BODY": 0.03,  # L^-2 M T^-2
+    "FORCE_PER_UNIT_MASS": 0.08,  # L T^-2
+    "FREQUENCY_VOLTAGE_RATIO": 72.91666667,  # A L^-2 M^-1 T^3
+    "FUEL_CONSUMPTION": 0.25,  # L^-2
+    "HEAT_OF_COMBUSTION": 0.16,  # L^2 T^-2
+    "HEAT_OF_FUSION": 0.16,  # L^2 T^-2
+    "HEAT_OF_VAPORIZATION": 0.16,  # L^2 T^-2
+    "HEAT_TRANSFER_COEFFICIENT": 0.002181818182,  # M Θ^-1 T^-3
+    "ILLUMINANCE": 0.25,  # L^-2 L
+    "KINETIC_ENERGY_OF_TURBULENCE": 0.16,  # L^2 T^-2
+    "LENGTH": 2,  # L
+    "LINEAR_MASS_DENSITY": 1.5,  # L^-1 M
+    "LINEAR_MOMENTUM": 1.2,  # L M T^-1
+    "LUMINANCE_SELF": 0.25,  # L^-2 L
+    "LUMINOUS_FLUX": 1,  # L
+    "LUMINOUS_INTENSITY": 1,  # L
+    "MAGNETIC_FIELD": 3.5,  # A L^-1
+    "MAGNETIC_FLUX": 0.06857142857,  # A^-1 L^2 M T^-2
+    "MAGNETIC_INDUCTION_FIELD_STRENGTH": 0.01714285714,  # A^-1 M T^-2
+    "MAGNETIC_MOMENT": 28,  # A L^2
+    "MAGNETIC_PERMEABILITY": 0.009795918367,  # A^-2 L^2 M T^-2
+    "MAGNETOMOTIVE_FORCE": 7,  # A
+    "MASS": 3,  # M
+    "MASS_DENSITY": 0.375,  # L^-3 M
+    "MASS_FLOW_RATE": 0.6,  # M T^-1
+    "MASS_FLUX": 0.15,  # L^-2 M T^-1
+    "MASS_FRACTION_OF_I": 1,  # Dimensionless
+    "MASS_TRANSFER_COEFFICIENT": 0.15,  # L^-2 M T^-1
+    "MOLALITY_OF_SOLUTE_I": 4.333333333,  # N M^-1
+    "MOLAR_CONCENTRATION_BY_MASS": 13,  # N
+    "MOLAR_FLOW_RATE": 2.6,  # N T^-1
+    "MOLAR_FLUX": 0.65,  # N L^-2 T^-1
+    "MOLAR_HEAT_CAPACITY": 0.001118881119,  # N^-1 L^2 Θ^-1 T^-2
+    "MOLARITY_OF_I": 1.625,  # N L^-3
+    "MOLE_FRACTION_OF_I": 1,  # Dimensionless
+    "MOMENT_OF_INERTIA": 12,  # L^2 M
+    "MOMENTUM_FLOW_RATE": 0.24,  # L M T^-2
+    "MOMENTUM_FLUX": 0.06,  # L^-1 M T^-2
+    "NORMALITY_OF_SOLUTION": 1.625,  # N L^-3
+    "PARTICLE_DENSITY": 0.125,  # L^-3
+    "PERCENT": 1,  # Dimensionless
+    "PERMEABILITY": 4,  # L^2
+    "PHOTON_EMISSION_RATE": 0.05,  # L^-2 T^-1
+    "POWER_PER_UNIT_MASS": 0.032,  # L^2 T^-3
+    "POWER_PER_UNIT_VOLUME": 0.012,  # L^-1 M T^-3
+    "POWER_THERMAL_DUTY": 0.096,  # L^2 M T^-3
+    "PRESSURE": 0.06,  # L^-1 M T^-2
+    "RADIATION_DOSE_EQUIVALENT": 0.16,  # L^2 T^-2
+    "RADIATION_EXPOSURE": 11.66666667,  # A M^-1 T
+    "RADIOACTIVITY": 0.2,  # T^-1
+    "SECOND_MOMENT_OF_AREA": 16,  # L^4
+    "SECOND_RADIATION_CONSTANT_PLANCK": 22,  # L Θ
+    "SPECIFIC_ENTHALPY": 0.16,  # L^2 T^-2
+    "SPECIFIC_GRAVITY": 1,  # Dimensionless
+    "SPECIFIC_HEAT_CAPACITY_CONSTANT_PRESSURE": 0.04363636364,  # L^2 M Θ^-1 T^-2
+    "SPECIFIC_LENGTH": 0.6666666667,  # L M^-1
+    "SPECIFIC_SURFACE": 1.333333333,  # L^2 M^-1
+    "SPECIFIC_VOLUME": 2.666666667,  # L^3 M^-1
+    "STRESS": 0.06,  # L^-1 M T^-2
+    "SURFACE_MASS_DENSITY": 0.75,  # L^-2 M
+    "SURFACE_TENSION": 0.12,  # M T^-2
+    "TEMPERATURE": 11,  # Θ
+    "THERMAL_CONDUCTIVITY": 0.528,  # L M Θ T^-3
+    "TIME": 5,  # T
+    "TORQUE": 0.48,  # L^2 M T^-2
+    "TURBULENCE_ENERGY_DISSIPATION_RATE": 0.032,  # L^2 T^-3
+    "VELOCITY_ANGULAR": 0.2,  # T^-1
+    "VELOCITY_LINEAR": 0.4,  # L T^-1
+    "VISCOSITY_DYNAMIC": 0.3,  # L^-1 M T^-1
+    "VISCOSITY_KINEMATIC": 0.8,  # L^2 T^-1
+    "VOLUME": 8,  # L^3
+    "VOLUME_FRACTION_OF_I": 1,  # Dimensionless
+    "VOLUMETRIC_CALORIFIC_HEATING_VALUE": 0.06,  # L^-1 M T^-2
+    "VOLUMETRIC_COEFFICIENT_OF_EXPANSION": 0.03409090909,  # L^-3 M Θ^-1
+    "VOLUMETRIC_FLOW_RATE": 1.6,  # L^3 T^-1
+    "VOLUMETRIC_FLUX": 0.4,  # L T^-1
+    "VOLUMETRIC_MASS_FLOW_RATE": 0.075,  # L^-3 M T^-1
+    "WAVENUMBER": 0.5,  # L^-1
+}
+
+# Generate all dimension constants programmatically to avoid duplication
+for _name, _signature in _SIGNATURES.items():
+    globals()[_name] = DimensionSignature(_signature)
+

qnty/dimensions/field_dims.pyi

@@ -0,0 +1,128 @@
+"""
+Type stubs for field_dims module.
+
+This file provides type information for the dynamically generated dimension constants.
+"""
+
+from .signature import DimensionSignature
+
+# Dimension signature constants lookup
+_SIGNATURES: dict[str, int | float]
+
+# Lazy loading cache
+_dimension_cache: dict[str, DimensionSignature]
+
+# Module attribute access function
+def __getattr__(name: str) -> DimensionSignature: ...
+
+# All dynamically generated dimension constants
+ABSORBED_DOSE: DimensionSignature
+ACCELERATION: DimensionSignature
+ACTIVATION_ENERGY: DimensionSignature
+AMOUNT_OF_SUBSTANCE: DimensionSignature
+ANGLE_PLANE: DimensionSignature
+ANGLE_SOLID: DimensionSignature
+ANGULAR_ACCELERATION: DimensionSignature
+ANGULAR_MOMENTUM: DimensionSignature
+AREA: DimensionSignature
+AREA_PER_UNIT_VOLUME: DimensionSignature
+ATOMIC_WEIGHT: DimensionSignature
+CONCENTRATION: DimensionSignature
+DIMENSIONLESS: DimensionSignature
+DYNAMIC_FLUIDITY: DimensionSignature
+ELECTRIC_CAPACITANCE: DimensionSignature
+ELECTRIC_CHARGE: DimensionSignature
+ELECTRIC_CURRENT_INTENSITY: DimensionSignature
+ELECTRIC_DIPOLE_MOMENT: DimensionSignature
+ELECTRIC_FIELD_STRENGTH: DimensionSignature
+ELECTRIC_INDUCTANCE: DimensionSignature
+ELECTRIC_POTENTIAL: DimensionSignature
+ELECTRIC_RESISTANCE: DimensionSignature
+ELECTRICAL_CONDUCTANCE: DimensionSignature
+ELECTRICAL_PERMITTIVITY: DimensionSignature
+ELECTRICAL_RESISTIVITY: DimensionSignature
+ENERGY_FLUX: DimensionSignature
+ENERGY_HEAT_WORK: DimensionSignature
+ENERGY_PER_UNIT_AREA: DimensionSignature
+FORCE: DimensionSignature
+FORCE_BODY: DimensionSignature
+FORCE_PER_UNIT_MASS: DimensionSignature
+FREQUENCY_VOLTAGE_RATIO: DimensionSignature
+FUEL_CONSUMPTION: DimensionSignature
+HEAT_OF_COMBUSTION: DimensionSignature
+HEAT_OF_FUSION: DimensionSignature
+HEAT_OF_VAPORIZATION: DimensionSignature
+HEAT_TRANSFER_COEFFICIENT: DimensionSignature
+ILLUMINANCE: DimensionSignature
+KINETIC_ENERGY_OF_TURBULENCE: DimensionSignature
+LENGTH: DimensionSignature
+LINEAR_MASS_DENSITY: DimensionSignature
+LINEAR_MOMENTUM: DimensionSignature
+LUMINANCE_SELF: DimensionSignature
+LUMINOUS_FLUX: DimensionSignature
+LUMINOUS_INTENSITY: DimensionSignature
+MAGNETIC_FIELD: DimensionSignature
+MAGNETIC_FLUX: DimensionSignature
+MAGNETIC_INDUCTION_FIELD_STRENGTH: DimensionSignature
+MAGNETIC_MOMENT: DimensionSignature
+MAGNETIC_PERMEABILITY: DimensionSignature
+MAGNETOMOTIVE_FORCE: DimensionSignature
+MASS: DimensionSignature
+MASS_DENSITY: DimensionSignature
+MASS_FLOW_RATE: DimensionSignature
+MASS_FLUX: DimensionSignature
+MASS_FRACTION_OF_I: DimensionSignature
+MASS_TRANSFER_COEFFICIENT: DimensionSignature
+MOLALITY_OF_SOLUTE_I: DimensionSignature
+MOLAR_CONCENTRATION_BY_MASS: DimensionSignature
+MOLAR_FLOW_RATE: DimensionSignature
+MOLAR_FLUX: DimensionSignature
+MOLAR_HEAT_CAPACITY: DimensionSignature
+MOLARITY_OF_I: DimensionSignature
+MOLE_FRACTION_OF_I: DimensionSignature
+MOMENT_OF_INERTIA: DimensionSignature
+MOMENTUM_FLOW_RATE: DimensionSignature
+MOMENTUM_FLUX: DimensionSignature
+NORMALITY_OF_SOLUTION: DimensionSignature
+PARTICLE_DENSITY: DimensionSignature
+PERCENT: DimensionSignature
+PERMEABILITY: DimensionSignature
+PHOTON_EMISSION_RATE: DimensionSignature
+POWER_PER_UNIT_MASS: DimensionSignature
+POWER_PER_UNIT_VOLUME: DimensionSignature
+POWER_THERMAL_DUTY: DimensionSignature
+PRESSURE: DimensionSignature
+RADIATION_DOSE_EQUIVALENT: DimensionSignature
+RADIATION_EXPOSURE: DimensionSignature
+RADIOACTIVITY: DimensionSignature
+SECOND_MOMENT_OF_AREA: DimensionSignature
+SECOND_RADIATION_CONSTANT_PLANCK: DimensionSignature
+SPECIFIC_ENTHALPY: DimensionSignature
+SPECIFIC_GRAVITY: DimensionSignature
+SPECIFIC_HEAT_CAPACITY_CONSTANT_PRESSURE: DimensionSignature
+SPECIFIC_LENGTH: DimensionSignature
+SPECIFIC_SURFACE: DimensionSignature
+SPECIFIC_VOLUME: DimensionSignature
+STRESS: DimensionSignature
+SURFACE_MASS_DENSITY: DimensionSignature
+SURFACE_TENSION: DimensionSignature
+TEMPERATURE: DimensionSignature
+THERMAL_CONDUCTIVITY: DimensionSignature
+TIME: DimensionSignature
+TORQUE: DimensionSignature
+TURBULENCE_ENERGY_DISSIPATION_RATE: DimensionSignature
+VELOCITY_ANGULAR: DimensionSignature
+VELOCITY_LINEAR: DimensionSignature
+VISCOSITY_DYNAMIC: DimensionSignature
+VISCOSITY_KINEMATIC: DimensionSignature
+VOLUME: DimensionSignature
+VOLUME_FRACTION_OF_I: DimensionSignature
+VOLUMETRIC_CALORIFIC_HEATING_VALUE: DimensionSignature
+VOLUMETRIC_COEFFICIENT_OF_EXPANSION: DimensionSignature
+VOLUMETRIC_FLOW_RATE: DimensionSignature
+VOLUMETRIC_FLUX: DimensionSignature
+VOLUMETRIC_MASS_FLOW_RATE: DimensionSignature
+WAVENUMBER: DimensionSignature
+
+# Module exports
+__all__: list[str]

qnty/dimensions/signature.py

@@ -0,0 +1,111 @@
+"""
+Dimension Signatures
+====================
+
+Immutable dimension signatures for ultra-fast dimensional analysis using prime number encoding.
+
+This file contains the core DimensionSignature class that provides zero-cost dimensional
+compatibility checking through compile-time type system integration.
+"""
+
+from dataclasses import dataclass
+from typing import ClassVar, final
+
+from .base import BaseDimension
+
+
+@final
+@dataclass(frozen=True, slots=True)
+class DimensionSignature:
+    """Immutable dimension signature for zero-cost dimensional analysis."""
+
+    # Store as bit pattern for ultra-fast comparison
+    _signature: int | float = 1
+
+    # Instance cache for interning common dimensions
+    _INSTANCE_CACHE: ClassVar[dict[int | float, "DimensionSignature"]] = {}
+
+    # Maximum cache size to prevent memory issues
+    _MAX_CACHE_SIZE: ClassVar[int] = 100
+
+    def __new__(cls, signature: int | float = 1):
+        """Optimized constructor with instance interning and validation."""
+        # Input validation
+        if not isinstance(signature, int | float):
+            raise TypeError(f"Signature must be int or float, got {type(signature)}")
+        if signature <= 0:
+            raise ValueError(f"Signature must be positive, got {signature}")
+
+        if signature in cls._INSTANCE_CACHE:
+            return cls._INSTANCE_CACHE[signature]
+
+        instance = object.__new__(cls)
+
+        # Cache common signatures with size limit
+        if len(cls._INSTANCE_CACHE) < cls._MAX_CACHE_SIZE:
+            cls._INSTANCE_CACHE[signature] = instance
+
+        return instance
+
+    @classmethod
+    def create(cls, length: int = 0, mass: int = 0, time: int = 0, current: int = 0, temp: int = 0, amount: int = 0, luminosity: int = 0):
+        """Create dimension from exponents with efficient computation."""
+        # Fast path for dimensionless
+        if not any([length, mass, time, current, temp, amount, luminosity]):
+            return cls(1)
+
+        # Compute signature using tuple of (base, exponent) pairs for efficiency
+        signature = 1.0
+        dimensions = [
+            (BaseDimension.LENGTH, length),
+            (BaseDimension.MASS, mass),
+            (BaseDimension.TIME, time),
+            (BaseDimension.CURRENT, current),
+            (BaseDimension.TEMPERATURE, temp),
+            (BaseDimension.AMOUNT, amount),
+            (BaseDimension.LUMINOSITY, luminosity),
+        ]
+
+        for base, exponent in dimensions:
+            if exponent != 0:
+                signature *= base**exponent
+
+        return cls(signature)
+
+    def __mul__(self, other: "DimensionSignature") -> "DimensionSignature":
+        """Multiply dimensions."""
+        if not isinstance(other, DimensionSignature):
+            raise TypeError(f"Cannot multiply DimensionSignature with {type(other)}")
+        return DimensionSignature(self._signature * other._signature)
+
+    def __truediv__(self, other: "DimensionSignature") -> "DimensionSignature":
+        """Divide dimensions."""
+        if not isinstance(other, DimensionSignature):
+            raise TypeError(f"Cannot divide DimensionSignature by {type(other)}")
+        return DimensionSignature(self._signature / other._signature)
+
+    def __pow__(self, power: int | float) -> "DimensionSignature":
+        """Raise dimension to a power."""
+        if not isinstance(power, int | float):
+            raise TypeError(f"Power must be int or float, got {type(power)}")
+        if power == 1:
+            return self
+        if power == 0:
+            return DimensionSignature(1)
+        return DimensionSignature(self._signature**power)
+
+    def is_compatible(self, other: "DimensionSignature") -> bool:
+        """Check dimensional compatibility."""
+        if not isinstance(other, DimensionSignature):
+            return False
+        return self._signature == other._signature
+
+    def __eq__(self, other: object) -> bool:
+        """Check equality."""
+        if self is other:
+            return True
+        return isinstance(other, DimensionSignature) and self._signature == other._signature
+
+    def __hash__(self) -> int:
+        """Hash based on signature."""
+        return hash(self._signature)

qnty/equations/__init__.py

@@ -1,4 +1,4 @@
 from .equation import Equation
 from .system import EquationSystem
 
-__all__ = ['Equation', 'EquationSystem']
+__all__ = ["Equation", "EquationSystem"]