mayutils 1.2.30__tar.gz → 1.2.31__tar.gz

{mayutils-1.2.30 → mayutils-1.2.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mayutils
-Version: 1.2.30
+Version: 1.2.31
 Summary: Utilities for Python from Mayuran Visakan
 Author: Mayuran Visakan
 Author-email: Mayuran Visakan <mayuran.k.v@gmail.com>

{mayutils-1.2.30 → mayutils-1.2.31}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mayutils"
-version = "1.2.30"
+version = "1.2.31"
 description = "Utilities for Python from Mayuran Visakan"
 authors = [
     { name = "Mayuran Visakan", email = "mayuran.k.v@gmail.com" }

{mayutils-1.2.30 → mayutils-1.2.31}/src/mayutils/objects/dataframes.py

@@ -27,6 +27,7 @@ from dataframe_image._pandas_accessor import (
 )
 import polars as pl
 import numpy as np
+from mayutils.objects.datetime import Interval
 from mayutils.objects.colours import Colour
 from mayutils.export import OUTPUT_FOLDER
 
@@ -428,6 +429,24 @@ class SeriesUtilsAccessor(object):
             "Not implemented for series yet: leverage existing df methods"
         )
 
+    def ground(
+        self,
+        interval: Optional[Interval] = None,
+    ) -> Series:
+        if interval is None:
+            return self.series
+
+        if self.series.index.inferred_type == "datetime":
+            grounding_value = self.series.loc[interval.as_slice].mean()
+        elif self.series.index.inferred_type == "date":
+            grounding_value = self.series.loc[interval.as_date_slice].mean()
+        else:
+            raise TypeError("Series index must be datetime or date type for grounding")
+
+        grounded_series = self.series.div(grounding_value)
+
+        return grounded_series
+
 
 class IndexUtilsAccessor(object):
     def __init__(