pegasource 0.2.1__tar.gz → 0.2.2__tar.gz

{pegasource-0.2.1 → pegasource-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pegasource
-Version: 0.2.1
+Version: 0.2.2
 Summary: Offline-capable toolkit: PCAP, geo, time-series, clustering, and path estimation
 Author: Josef Berman
 License: MIT
@@ -240,13 +240,10 @@ python -m pegasource.dataset_clustering.prepare_viz_data
 
 ### Path estimation (trajectories)
 
-Evaluate reconstruction methods on observation CSVs vs a 1 Hz ground-truth path (requires **`[path_estimation]`** for full method set):
+Evaluate reconstruction methods on observation CSVs vs a 1 Hz ground-truth path (requires **`[path_estimation]`** for the full estimator stack):
 
 ```bash
 pip install -e ".[path_estimation]"
-pegasource-path-estimation --observations run_1_observations.csv --true-path run_1_true_path.csv --output-dir out/
-# or
-python -m pegasource.path_estimation --observations ... --true-path ... --output-dir out/
 ```
 
 ```python
@@ -283,12 +280,9 @@ results = estimate_paths_only(
 # results["kf"] is an EstimationResult with times_s, east_m, north_m (or {"error": "..."})
 ```
 
-Synthetic data generation and batch method comparison:
-
-```bash
-python -m pegasource.path_estimation.generate_synthetic_datasets --help
-python -m pegasource.path_estimation.run_method_evaluation --help   # writes ./method_eval/
-```
+Synthetic data (``generate_dataset`` in ``pegasource.path_estimation.generate_synthetic_datasets``)
+and batch method comparison (``main`` in ``pegasource.path_estimation.run_method_evaluation``) are
+invoked from your own Python code, not as installed console commands.
 
 ---
 

{pegasource-0.2.1 → pegasource-0.2.2}/README.md

@@ -189,13 +189,10 @@ python -m pegasource.dataset_clustering.prepare_viz_data
 
 ### Path estimation (trajectories)
 
-Evaluate reconstruction methods on observation CSVs vs a 1 Hz ground-truth path (requires **`[path_estimation]`** for full method set):
+Evaluate reconstruction methods on observation CSVs vs a 1 Hz ground-truth path (requires **`[path_estimation]`** for the full estimator stack):
 
 ```bash
 pip install -e ".[path_estimation]"
-pegasource-path-estimation --observations run_1_observations.csv --true-path run_1_true_path.csv --output-dir out/
-# or
-python -m pegasource.path_estimation --observations ... --true-path ... --output-dir out/
 ```
 
 ```python
@@ -232,12 +229,9 @@ results = estimate_paths_only(
 # results["kf"] is an EstimationResult with times_s, east_m, north_m (or {"error": "..."})
 ```
 
-Synthetic data generation and batch method comparison:
-
-```bash
-python -m pegasource.path_estimation.generate_synthetic_datasets --help
-python -m pegasource.path_estimation.run_method_evaluation --help   # writes ./method_eval/
-```
+Synthetic data (``generate_dataset`` in ``pegasource.path_estimation.generate_synthetic_datasets``)
+and batch method comparison (``main`` in ``pegasource.path_estimation.run_method_evaluation``) are
+invoked from your own Python code, not as installed console commands.
 
 ---
 

{pegasource-0.2.1 → pegasource-0.2.2}/pegasource/__init__.py

@@ -10,5 +10,5 @@ pegasource.dataset_clustering    Hardware inventory embedding + clustering (opti
 pegasource.path_estimation       GPS/cellular path reconstruction (filters, graph, NN; optional torch stack)
 """
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"
 __all__ = ["pcap", "geo", "timeseries", "dataset_clustering", "path_estimation"]

pegasource-0.2.2/pegasource/path_estimation/__init__.py

@@ -0,0 +1,45 @@
+"""Trajectory reconstruction from asynchronous observations (local ENU meters).
+
+Re-exports :func:`run_evaluation`, :func:`evaluate_path_estimation`, and
+:func:`estimate_paths_only` from :mod:`pegasource.path_estimation.evaluate`, same pattern
+as :mod:`pegasource.pcap` / :mod:`pegasource.geo`.  Requires the optional **path_estimation**
+dependencies (filterpy, torch, …); install with ``pip install -e ".[path_estimation]"``.
+
+Because Python loads this file when importing any submodule (e.g.
+``import pegasource.path_estimation.metrics``), loading the package also pulls in
+``evaluate`` and those dependencies.  Previously, lazy :func:`__getattr__` deferred that
+until you accessed ``run_evaluation``; explicit imports match the rest of pegasource at
+the cost of a heavier first import.
+
+Quick start::
+
+    from pegasource.path_estimation import run_evaluation
+    from pathlib import Path
+
+    run_evaluation(
+        Path("obs.csv"),
+        Path("true.csv"),
+        Path("out"),
+        methods=["kf", "dijkstra"],
+    )
+
+Examples
+--------
+>>> from pegasource.path_estimation.metrics import compute_all_metrics
+>>> import numpy as np
+>>> t = np.zeros((10, 2))
+>>> out = compute_all_metrics(t, t + 0.1)
+>>> assert "rmse_m" in out
+"""
+
+from .evaluate import (
+    estimate_paths_only,
+    evaluate_path_estimation,
+    run_evaluation,
+)
+
+__all__ = [
+    "estimate_paths_only",
+    "evaluate_path_estimation",
+    "run_evaluation",
+]

{pegasource-0.2.1 → pegasource-0.2.2}/pegasource/path_estimation/evaluate.py

@@ -404,7 +404,6 @@ def run_evaluation(
     See Also
     --------
     evaluate_path_estimation : supply your own ``road_graph``.
-    pegasource.path_estimation.__main__.main : CLI entry (``pegasource-path-estimation``).
     """
     obs_df = load_observations_csv(observations_csv)
     true_df = load_true_path_csv(true_path_csv)

{pegasource-0.2.1 → pegasource-0.2.2}/pegasource/path_estimation/generate_synthetic_datasets.py

@@ -1005,5 +1005,3 @@ def main() -> None:
     print(f"Output folder: {args.output_dir.resolve()}")
 
 
-if __name__ == "__main__":
-    main()

{pegasource-0.2.1 → pegasource-0.2.2}/pegasource/path_estimation/run_method_evaluation.py

@@ -252,5 +252,3 @@ def main() -> None:
     print(f"Per-run outputs: {eval_dir}/run_<i>/ (metrics.json, figures/)")
 
 
-if __name__ == "__main__":
-    main()

{pegasource-0.2.1 → pegasource-0.2.2}/pegasource.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pegasource
-Version: 0.2.1
+Version: 0.2.2
 Summary: Offline-capable toolkit: PCAP, geo, time-series, clustering, and path estimation
 Author: Josef Berman
 License: MIT
@@ -240,13 +240,10 @@ python -m pegasource.dataset_clustering.prepare_viz_data
 
 ### Path estimation (trajectories)
 
-Evaluate reconstruction methods on observation CSVs vs a 1 Hz ground-truth path (requires **`[path_estimation]`** for full method set):
+Evaluate reconstruction methods on observation CSVs vs a 1 Hz ground-truth path (requires **`[path_estimation]`** for the full estimator stack):
 
 ```bash
 pip install -e ".[path_estimation]"
-pegasource-path-estimation --observations run_1_observations.csv --true-path run_1_true_path.csv --output-dir out/
-# or
-python -m pegasource.path_estimation --observations ... --true-path ... --output-dir out/
 ```
 
 ```python
@@ -283,12 +280,9 @@ results = estimate_paths_only(
 # results["kf"] is an EstimationResult with times_s, east_m, north_m (or {"error": "..."})
 ```
 
-Synthetic data generation and batch method comparison:
-
-```bash
-python -m pegasource.path_estimation.generate_synthetic_datasets --help
-python -m pegasource.path_estimation.run_method_evaluation --help   # writes ./method_eval/
-```
+Synthetic data (``generate_dataset`` in ``pegasource.path_estimation.generate_synthetic_datasets``)
+and batch method comparison (``main`` in ``pegasource.path_estimation.run_method_evaluation``) are
+invoked from your own Python code, not as installed console commands.
 
 ---
 

{pegasource-0.2.1 → pegasource-0.2.2}/pegasource.egg-info/SOURCES.txt

@@ -38,7 +38,6 @@ pegasource/geo/israel_roads.py
 pegasource/geo/projection.py
 pegasource/geo/vectorizer.py
 pegasource/path_estimation/__init__.py
-pegasource/path_estimation/__main__.py
 pegasource/path_estimation/evaluate.py
 pegasource/path_estimation/generate_synthetic_datasets.py
 pegasource/path_estimation/geo_reference.py

{pegasource-0.2.1 → pegasource-0.2.2}/pegasource.egg-info/entry_points.txt

@@ -1,4 +1,3 @@
 [console_scripts]
 pegasource-cluster-viz = pegasource.dataset_clustering.server:run
 pegasource-download-roads = pegasource.geo.israel_roads:_cli_download
-pegasource-path-estimation = pegasource.path_estimation.__main__:main

{pegasource-0.2.1 → pegasource-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pegasource"
-version = "0.2.1"
+version = "0.2.2"
 description = "Offline-capable toolkit: PCAP, geo, time-series, clustering, and path estimation"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -69,7 +69,6 @@ dev = [
 [project.scripts]
 pegasource-download-roads = "pegasource.geo.israel_roads:_cli_download"
 pegasource-cluster-viz = "pegasource.dataset_clustering.server:run"
-pegasource-path-estimation = "pegasource.path_estimation.__main__:main"
 
 [tool.setuptools.packages.find]
 where = ["."]

pegasource-0.2.1/pegasource/path_estimation/__init__.py

@@ -1,36 +0,0 @@
-"""Trajectory reconstruction from asynchronous observations (local ENU meters).
-
-**Lazy exports** (importing these loads :mod:`pegasource.path_estimation.evaluate` and
-pulls in **filterpy**, **torch**, etc. — use ``pip install -e ".[path_estimation]"``):
-
-- `estimate_paths_only` — no ground-truth CSV; stub timeline only
-- `evaluate_path_estimation` — CSV paths + caller-supplied road graph
-- `run_evaluation` — same as ``evaluate_path_estimation`` but loads the default OSM walk graph
-
-**Always-light submodules** (safe without the extra):
-
-- :mod:`pegasource.path_estimation.metrics` — RMSE, Fréchet, DTW, …
-- :mod:`pegasource.path_estimation.io` — CSV loaders (used by evaluation pipelines)
-
-Examples
---------
->>> from pegasource.path_estimation.metrics import compute_all_metrics
->>> import numpy as np
->>> t = np.zeros((10, 2))
->>> out = compute_all_metrics(t, t + 0.1)
->>> assert "rmse_m" in out
-"""
-
-from __future__ import annotations
-
-from typing import Any
-
-__all__ = ["estimate_paths_only", "evaluate_path_estimation", "run_evaluation"]
-
-
-def __getattr__(name: str) -> Any:
-    if name in __all__:
-        from . import evaluate
-
-        return getattr(evaluate, name)
-    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

pegasource-0.2.1/pegasource/path_estimation/__main__.py

@@ -1,65 +0,0 @@
-"""CLI: ``python -m pegasource.path_estimation ...``."""
-
-from __future__ import annotations
-
-import argparse
-from pathlib import Path
-
-from .evaluate import print_summary, run_evaluation
-
-
-def main() -> None:
-    p = argparse.ArgumentParser(
-        description="Evaluate path reconstruction methods against a true_path CSV.",
-    )
-    p.add_argument(
-        "--observations",
-        type=Path,
-        required=True,
-        help="Path to *_observations.csv",
-    )
-    p.add_argument(
-        "--true-path",
-        type=Path,
-        required=True,
-        help="Path to *_true_path.csv (1 Hz ground truth).",
-    )
-    p.add_argument(
-        "--output-dir",
-        type=Path,
-        default=Path("path_estimation_runs/run1"),
-        help="Directory for metrics.json and figures/.",
-    )
-    p.add_argument(
-        "--methods",
-        type=str,
-        default="dijkstra,astar,hmm,kf,ekf,ukf,particle,lstm,transformer,gnn",
-        help="Comma-separated method names.",
-    )
-    p.add_argument("--no-plots", action="store_true", help="Skip figure generation.")
-    p.add_argument(
-        "--map-plots",
-        action="store_true",
-        help="Also write Web Mercator basemap PNGs (slower; may fetch tiles).",
-    )
-    p.add_argument("--device", type=str, default=None, help="Torch device, e.g. cuda or cpu.")
-    p.add_argument("--seed", type=int, default=0)
-    args = p.parse_args()
-
-    methods = [m.strip() for m in args.methods.split(",") if m.strip()]
-    args.output_dir.mkdir(parents=True, exist_ok=True)
-    summary = run_evaluation(
-        args.observations,
-        args.true_path,
-        args.output_dir,
-        methods=methods,
-        plot=not args.no_plots,
-        plot_map=bool(args.map_plots) and not args.no_plots,
-        device=args.device,
-        seed=args.seed,
-    )
-    print_summary(summary)
-
-
-if __name__ == "__main__":
-    main()