Add Temperature quantity

Signed-off-by: Christian Parpart <[email protected]>

Author: christianparpart

src/frequenz/sdk/timeseries/__init__.py

@@ -38,7 +38,15 @@
 from ._base_types import UNIX_EPOCH, Sample, Sample3Phase
 from ._moving_window import MovingWindow
 from ._periodic_feature_extractor import PeriodicFeatureExtractor
-from ._quantities import Current, Energy, Percentage, Power, Quantity, Voltage
+from ._quantities import (
+    Current,
+    Energy,
+    Percentage,
+    Power,
+    Quantity,
+    Temperature,
+    Voltage,
+)
 from ._resampling import ResamplerConfig
 
 __all__ = [
@@ -55,6 +63,7 @@
     "Current",
     "Energy",
     "Power",
+    "Temperature",
     "Voltage",
     "Percentage",
 ]

src/frequenz/sdk/timeseries/_quantities.py

@@ -10,7 +10,14 @@
 from typing import Any, NoReturn, Self, TypeVar, overload
 
 QuantityT = TypeVar(
-    "QuantityT", "Quantity", "Power", "Current", "Voltage", "Energy", "Percentage"
+    "QuantityT",
+    "Current",
+    "Energy",
+    "Percentage",
+    "Power",
+    "Quantity",
+    "Temperature",
+    "Voltage",
 )
 
 
@@ -301,6 +308,38 @@ def __call__(cls, *_args: Any, **_kwargs: Any) -> NoReturn:
         )
 
 
+class Temperature(
+    Quantity,
+    metaclass=_NoDefaultConstructible,
+    exponent_unit_map={
+        0: "°C",
+    },
+):
+    """A temperature quantity (in degrees Celsius)."""
+
+    @classmethod
+    def from_celsius(cls, value: float) -> Self:
+        """Initialize a new temperature quantity.
+
+        Args:
+            value: The temperature in degrees Celsius.
+
+        Returns:
+            A new temperature quantity.
+        """
+        power = cls.__new__(cls)
+        power._base_value = value
+        return power
+
+    def as_celsius(self) -> float:
+        """Return the temperature in degrees Celsius.
+
+        Returns:
+            The temperature in degrees Celsius.
+        """
+        return self._base_value
+
+
 class Power(
     Quantity,
     metaclass=_NoDefaultConstructible,