core-lens 0.1.dev153__tar.gz → 0.1.dev155__tar.gz

{core_lens-0.1.dev153 → core_lens-0.1.dev155}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: core-lens
-Version: 0.1.dev153
+Version: 0.1.dev155
 Summary: Query, analyse, and visualise CoreStack's microwatershed and Earth science data through a clean, composable Python API.
 Project-URL: Homepage, https://github.com/ApoorvaKashyap/core-lens
 Project-URL: Issues, https://github.com/ApoorvaKashyap/core-lens/issues

core_lens-0.1.dev155/src/core_lens/__main__.py

@@ -0,0 +1,36 @@
+from . import __version__
+
+
+def hello() -> str:
+    hello_str = """Hello from core-lens!
+
+The following primary capabilities are available:
+- AoI: Construct Area of Interest queries (e.g., `AoI(district="Godda")`)
+- Result: Lazy evaluation and computation graph materialisation
+
+Analytics (via `result.stats`):
+- anomaly(): Timeseries and cross-sectional anomaly detection
+- change(): Absolute, percentage, and trend changes over time
+- similarity(): Multi-feature similarity search across entities
+- test(): Statistical hypothesis testing
+- correlate(): Feature correlation analysis
+
+Visualisation (via `result.plot`):
+- choropleth(): Interactive Lonboard spatial mapping
+- timeseries(): Temporal data visualisation
+- scatter(): Scatter plots for variable comparison
+- distribution(): Histograms and density plots
+- correlation(): Correlation heatmaps between variables
+- heatmap(): 2D density/binned heatmaps
+- matrix(): Scatter matrix/pair plots
+"""
+    return hello_str
+
+
+def version() -> str:
+    return str(__version__)
+
+
+if __name__ == "__main__":
+    print(hello())
+    print(f"Version: {version()}")

{core_lens-0.1.dev153 → core_lens-0.1.dev155}/src/core_lens/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.1.dev153'
-__version_tuple__ = version_tuple = (0, 1, 'dev153')
+__version__ = version = '0.1.dev155'
+__version_tuple__ = version_tuple = (0, 1, 'dev155')
 
 __commit_id__ = commit_id = None

{core_lens-0.1.dev153 → core_lens-0.1.dev155}/src/core_lens/base/namespaces/stats.py

@@ -489,18 +489,24 @@ class StatsNamespace:
             )
 
         if method in (ChangeMethod.ABSOLUTE, ChangeMethod.PERCENTAGE):
+            join_keys = [key]
+            if "season" in df.columns:
+                join_keys.append("season")
+
             from_df = (
                 df.filter(pl.col(year_col) == from_period)
-                .select([key, column])
+                .select(join_keys + [column])
                 .rename({column: "value_from"})
             )
             to_df = (
                 df.filter(pl.col(year_col) == to_period)
-                .select([key, column])
+                .select(join_keys + [column])
                 .rename({column: "value_to"})
             )
-            joined = from_df.join(to_df, on=key, how="inner").with_columns(
+            joined = from_df.join(to_df, on=join_keys, how="inner").with_columns(
                 [
+                    pl.lit(from_period).alias("year_from").cast(pl.Int32),
+                    pl.lit(to_period).alias("year_to").cast(pl.Int32),
                     (pl.col("value_to") - pl.col("value_from")).alias("change"),
                     (
                         (pl.col("value_to") - pl.col("value_from"))

{core_lens-0.1.dev153 → core_lens-0.1.dev155}/tests/unit/test_main.py

@@ -8,7 +8,11 @@ def test_version() -> None:
 def test_hello() -> None:
     from core_lens.__main__ import hello
 
-    assert hello() == "Hello from core-lens!"
+    msg = hello()
+    assert msg.startswith("Hello from core-lens!")
+    assert "AoI: Construct Area of Interest queries" in msg
+    assert "Analytics (via `result.stats`):" in msg
+    assert "Visualisation (via `result.plot`):" in msg
 
 
 def test_version_type() -> None:

core_lens-0.1.dev153/src/core_lens/__main__.py

@@ -1,14 +0,0 @@
-from . import __version__
-
-
-def hello() -> str:
-    return "Hello from core-lens!"
-
-
-def version() -> str:
-    return str(__version__)
-
-
-if __name__ == "__main__":
-    print(hello())
-    print(f"Version: {version()}")