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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: core-lens
-Version: 0.1.dev154
+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.dev154 → 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.dev154'
-__version_tuple__ = version_tuple = (0, 1, 'dev154')
+__version__ = version = '0.1.dev155'
+__version_tuple__ = version_tuple = (0, 1, 'dev155')
 
 __commit_id__ = commit_id = None

{core_lens-0.1.dev154 → 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"))
@@ -859,12 +865,9 @@ class StatsNamespace:
         df = self._r.df()
         key = self._r.key_cols[0]
 
-        min_year: int | None = None
-        max_year: int | None = None
-
         # --- Build feature DataFrame ------------------------------------------
         # Universe of entity keys from result.data.
-        feat = df.select([key]).unique()
+        feat = df.select([key])
 
         for col_name, spec in columns.items():
             if spec is None:
@@ -884,23 +887,6 @@ class StatsNamespace:
             resolution_str, filter_dict = spec
             filter_dict = dict(filter_dict) if filter_dict else {}
 
-            if "year" in filter_dict:
-                yr = filter_dict["year"]
-                y0: int | None = None
-                y1: int | None = None
-
-                if isinstance(yr, (list, tuple)) and len(yr) >= 2:
-                    y0, y1 = int(yr[0]), int(yr[1])
-                elif isinstance(yr, int):
-                    y0, y1 = yr, yr
-
-                if y0 is not None:
-                    if min_year is None or y0 < min_year:
-                        min_year = y0
-                if y1 is not None:
-                    if max_year is None or y1 > max_year:
-                        max_year = y1
-
             entity = self._r.entity
             path: str | None
             if resolution_str == "static":
@@ -1026,26 +1012,13 @@ class StatsNamespace:
         dists[tidx] = float("inf")  # exclude target itself
         top_idx = np.argsort(dists)[:top_n]
 
-        if min_year is None and max_year is None:
-            year_col = self._year_col()
-            if year_col and year_col in df.columns:
-                yr_min = df[year_col].min()
-                yr_max = df[year_col].max()
-                if yr_min is not None and yr_max is not None:
-                    min_year = int(cast(int, yr_min))
-                    max_year = int(cast(int, yr_max))
-
-        output_dict: dict[str, Any] = {
-            key: [ids[i] for i in top_idx],
-            "similarity_score": [float(1.0 / (1.0 + dists[i])) for i in top_idx],
-            "rank": list(range(1, len(top_idx) + 1)),
-        }
-
-        if min_year is not None and max_year is not None:
-            output_dict["year_from"] = [min_year] * len(top_idx)
-            output_dict["year_to"] = [max_year] * len(top_idx)
-
-        data = pl.DataFrame(output_dict)
+        data = pl.DataFrame(
+            {
+                key: [ids[i] for i in top_idx],
+                "similarity_score": [float(1.0 / (1.0 + dists[i])) for i in top_idx],
+                "rank": list(range(1, len(top_idx) + 1)),
+            }
+        )
         metadata: dict[str, Any] = {
             "method": method.value if method is not None else None,
             "target": target,

{core_lens-0.1.dev154 → 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.dev154/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()}")