Skip to content

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

Python

fix(cloudanalyzer): address harness review (backend guard, docs, README, e2e skips)

Ryohei Sasakia75b174c08b4
diff --git a/README.md b/README.md
index 1a54e30c1..21916eb92 100644
--- a/README.md
+++ b/README.md
@@ -918,6 +918,13 @@ Each application received complete, production-ready CLI interfaces — not demo
<td align="center">✅ 40</td>
</tr>
<tr>
+<td align="center"><strong>☁️ <a href="cloudanalyzer/agent-harness/">CloudAnalyzer</a></strong></td>
+<td>Point cloud / trajectory QA</td>
+<td><code>cli-anything-cloudanalyzer</code></td>
+<td>CloudAnalyzer (Python API)</td>
+<td align="center">✅ 14</td>
+</tr>
+<tr>
<td align="center" colspan="4"><strong>Total</strong></td>
<td align="center"><strong>✅ 2,045</strong></td>
</tr>
@@ -960,8 +967,9 @@ ollama 98 passed ✅ (87 unit + 11 e2e)
sketch 19 passed ✅ (19 jest, Node.js)
renderdoc 59 passed ✅ (45 unit + 14 e2e)
cloudcompare 88 passed ✅ (49 unit + 39 e2e)
+cloudanalyzer 14 passed ✅ (7 unit + 7 e2e)
──────────────────────────────────────────────────────────────────────────────
-TOTAL 2,005 passed ✅ 100% pass rate
+TOTAL 2,019 passed ✅ 100% pass rate
```
---
@@ -1036,7 +1044,8 @@ cli-anything/
├── 🔬 renderdoc/agent-harness/ # RenderDoc CLI (59 tests)
├── 🎬 videocaptioner/agent-harness/ # VideoCaptioner CLI (26 tests)
├── ☁️ cloudcompare/agent-harness/ # CloudCompare CLI (88 tests)
-└── 🔍 exa/agent-harness/ # Exa CLI (40 tests)
+├── 🔍 exa/agent-harness/ # Exa CLI (40 tests)
+└── ⛅ cloudanalyzer/agent-harness/ # CloudAnalyzer CLI (14 tests)
```
Each `agent-harness/` contains an installable Python package under `cli_anything.<software>/` with Click CLI, core modules, utils (including `repl_skin.py` and backend wrapper), and comprehensive tests.
diff --git a/cloudanalyzer/agent-harness/CLOUDANALYZER.md b/cloudanalyzer/agent-harness/CLOUDANALYZER.md
index 87c85f5b3..7cd10a19f 100644
--- a/cloudanalyzer/agent-harness/CLOUDANALYZER.md
+++ b/cloudanalyzer/agent-harness/CLOUDANALYZER.md
@@ -17,24 +17,30 @@ Since CloudAnalyzer is a Python package, the backend (`ca_backend.py`) imports
CloudAnalyzer functions directly — no subprocess invocation needed. This makes
the harness faster and more reliable than subprocess-based approaches.
+Call paths go through `ca_backend`: handlers in `cloudanalyzer_cli.py` do not
+import `ca.*` directly.
+
## Command Mapping
| Harness Group | CloudAnalyzer Command(s) |
|---|---|
-| evaluate run | ca evaluate |
-| evaluate compare | ca compare |
-| evaluate diff | ca diff |
-| evaluate ground | ca ground-evaluate |
-| trajectory evaluate | ca traj-evaluate |
-| trajectory batch | ca traj-batch |
-| check run | ca check |
-| check init | ca init-check |
-| baseline decision | ca baseline-decision |
-| baseline save | ca baseline-save |
-| baseline list | ca baseline-list |
-| process downsample | ca downsample |
-| process split | ca split |
-| info show | ca info |
+| evaluate run | ca.evaluate.evaluate |
+| evaluate compare | ca.compare.run_compare |
+| evaluate diff | ca.diff.run_diff |
+| evaluate batch | ca.batch.batch_evaluate |
+| evaluate ground | ca.ground_evaluate.evaluate_ground_segmentation |
+| evaluate pipeline | ca.pipeline.run_pipeline |
+| trajectory evaluate | ca.trajectory.evaluate_trajectory |
+| trajectory batch | ca.batch.trajectory_batch_evaluate |
+| trajectory run-evaluate | ca.run_evaluate.evaluate_run |
+| check run | ca.core.run_check_suite |
+| check init | ca.core.render_check_scaffold |
+| baseline decision | ca.core.summarize_baseline_evolution |
+| baseline save / list | ca.baseline_history.* |
+| process * | ca.downsample / split / sample / filter / merge / convert |
+| inspect view | ca.view.view |
+| inspect web / web-export | ca.web.serve / export_static_bundle |
+| info show | ca.info.get_info |
## State Model
diff --git a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/README.md b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/README.md
index 42107ae6b..998af98b7 100644
--- a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/README.md
+++ b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/README.md
@@ -35,7 +35,7 @@ CloudAnalyzer is already CLI-first, but this harness adds:
- **REPL mode** for interactive exploration
- **Project/session management** with operation history and undo
- **SKILL.md** for agent auto-discovery via CLI-Anything ecosystem
-- **Unified Click interface** grouping 32 commands into logical groups
+- **Unified Click interface** grouping 27 commands into logical groups
## Commands
@@ -50,7 +50,7 @@ See [SKILL.md](cli_anything/cloudanalyzer/skills/SKILL.md) for the full command
| process | 6 | Downsample, split, filter, merge, convert |
| inspect | 3 | Visualization and browser inspection |
| info | 2 | Metadata and version |
-| session | 3 | Project and session management |
+| session | 2 | Project and session management |
## Requirements
diff --git a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/cloudanalyzer_cli.py b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/cloudanalyzer_cli.py
index 13aade69f..698b17ae0 100644
--- a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/cloudanalyzer_cli.py
+++ b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/cloudanalyzer_cli.py
@@ -191,8 +191,9 @@ def evaluate_ground(
def evaluate_batch(ctx: click.Context, directory: str, reference: str, min_auc: Optional[float], max_chamfer: Optional[float]) -> None:
"""Batch evaluation of multiple point clouds."""
try:
- from ca.batch import batch_evaluate
- result = batch_evaluate(directory, reference, min_auc=min_auc, max_chamfer=max_chamfer)
+ result = ca_backend.batch_evaluate(
+ directory, reference, min_auc=min_auc, max_chamfer=max_chamfer,
+ )
_out(ctx, result)
except Exception as e:
_error(str(e), ctx.obj.get("json", False))
@@ -204,13 +205,19 @@ def evaluate_batch(ctx: click.Context, directory: str, reference: str, min_auc:
@click.argument("reference")
@click.option("-o", "--output", required=True)
@click.option("-v", "--voxel-size", type=float, default=0.05)
[email protected]("--filter/--no-filter", "apply_filter", default=False)
@click.pass_context
-def evaluate_pipeline(ctx: click.Context, input_path: str, reference: str, output: str, voxel_size: float, apply_filter: bool) -> None:
+def evaluate_pipeline(
+ ctx: click.Context,
+ input_path: str,
+ reference: str,
+ output: str,
+ voxel_size: float,
+) -> None:
"""Filter, downsample, evaluate in one command."""
try:
- from ca.pipeline import run_pipeline
- result = run_pipeline(input_path, reference, output, voxel_size=voxel_size, apply_filter=apply_filter)
+ result = ca_backend.run_pipeline(
+ input_path, reference, output, voxel_size=voxel_size,
+ )
_out(ctx, result)
except Exception as e:
_error(str(e), ctx.obj.get("json", False))
@@ -236,14 +243,34 @@ def trajectory(ctx: click.Context) -> None:
@click.option("--max-longitudinal", type=float, default=None)
@click.option("--align-origin", is_flag=True)
@click.option("--align-rigid", is_flag=True)
[email protected]("--report", default=None, help="Write trajectory report")
@click.pass_context
def trajectory_evaluate(
- ctx: click.Context, estimated: str, reference: str, **kwargs,
+ ctx: click.Context,
+ estimated: str,
+ reference: str,
+ max_ate: Optional[float],
+ max_rpe: Optional[float],
+ max_drift: Optional[float],
+ min_coverage: Optional[float],
+ max_lateral: Optional[float],
+ max_longitudinal: Optional[float],
+ align_origin: bool,
+ align_rigid: bool,
) -> None:
"""Evaluate estimated vs reference trajectory."""
try:
- result = ca_backend.evaluate_trajectory(estimated, reference, **kwargs)
+ result = ca_backend.evaluate_trajectory(
+ estimated,
+ reference,
+ max_ate=max_ate,
+ max_rpe=max_rpe,
+ max_drift=max_drift,
+ min_coverage=min_coverage,
+ max_lateral=max_lateral,
+ max_longitudinal=max_longitudinal,
+ align_origin=align_origin,
+ align_rigid=align_rigid,
+ )
_out(ctx, result)
gate = result.get("quality_gate")
if gate and not gate["passed"]:
@@ -261,11 +288,25 @@ def trajectory_evaluate(
@click.option("--max-drift", type=float, default=None)
@click.option("--min-coverage", type=float, default=None)
@click.pass_context
-def trajectory_batch(ctx: click.Context, directory: str, reference_dir: str, **kwargs) -> None:
+def trajectory_batch(
+ ctx: click.Context,
+ directory: str,
+ reference_dir: str,
+ max_ate: Optional[float],
+ max_rpe: Optional[float],
+ max_drift: Optional[float],
+ min_coverage: Optional[float],
+) -> None:
"""Batch trajectory evaluation."""
try:
- from ca.batch import trajectory_batch_evaluate
- result = trajectory_batch_evaluate(directory, reference_dir, **kwargs)
+ result = ca_backend.trajectory_batch_evaluate(
+ directory,
+ reference_dir,
+ max_ate=max_ate,
+ max_rpe=max_rpe,
+ max_drift=max_drift,
+ min_coverage=min_coverage,
+ )
_out(ctx, result)
except Exception as e:
_error(str(e), ctx.obj.get("json", False))
@@ -279,13 +320,26 @@ def trajectory_batch(ctx: click.Context, directory: str, reference_dir: str, **k
@click.argument("trajectory_reference")
@click.option("--min-auc", type=float, default=None)
@click.option("--max-ate", type=float, default=None)
[email protected]("--report", default=None)
@click.pass_context
-def trajectory_run_evaluate(ctx: click.Context, map_path: str, map_reference: str, trajectory_path: str, trajectory_reference: str, **kwargs) -> None:
+def trajectory_run_evaluate(
+ ctx: click.Context,
+ map_path: str,
+ map_reference: str,
+ trajectory_path: str,
+ trajectory_reference: str,
+ min_auc: Optional[float],
+ max_ate: Optional[float],
+) -> None:
"""Integrated map + trajectory evaluation."""
try:
- from ca.run_evaluate import run_evaluate
- result = run_evaluate(map_path, map_reference, trajectory_path, trajectory_reference, **kwargs)
+ result = ca_backend.evaluate_run(
+ map_path,
+ map_reference,
+ trajectory_path,
+ trajectory_reference,
+ min_auc=min_auc,
+ max_ate=max_ate,
+ )
_out(ctx, result)
except Exception as e:
_error(str(e), ctx.obj.get("json", False))
@@ -459,8 +513,7 @@ def process_split(ctx: click.Context, input_path: str, output_dir: str, grid_siz
def process_sample(ctx: click.Context, input_path: str, output: str, num_points: int) -> None:
"""Random point sampling."""
try:
- from ca.sample import random_sample
- result = random_sample(input_path, output, num_points)
+ result = ca_backend.random_sample(input_path, output, num_points)
_out(ctx, result)
except Exception as e:
_error(str(e), ctx.obj.get("json", False))
@@ -476,8 +529,9 @@ def process_sample(ctx: click.Context, input_path: str, output: str, num_points:
def process_filter(ctx: click.Context, input_path: str, output: str, nb_neighbors: int, std_ratio: float) -> None:
"""Statistical outlier removal."""
try:
- from ca.filter import filter_outliers
- result = filter_outliers(input_path, output, nb_neighbors=nb_neighbors, std_ratio=std_ratio)
+ result = ca_backend.filter_outliers(
+ input_path, output, nb_neighbors=nb_neighbors, std_ratio=std_ratio,
+ )
_out(ctx, result)
except Exception as e:
_error(str(e), ctx.obj.get("json", False))
@@ -491,8 +545,7 @@ def process_filter(ctx: click.Context, input_path: str, output: str, nb_neighbor
def process_merge(ctx: click.Context, inputs: tuple[str, ...], output: str) -> None:
"""Merge multiple point clouds."""
try:
- from ca.merge import merge
- result = merge(list(inputs), output)
+ result = ca_backend.merge(list(inputs), output)
_out(ctx, result)
except Exception as e:
_error(str(e), ctx.obj.get("json", False))
@@ -506,8 +559,7 @@ def process_merge(ctx: click.Context, inputs: tuple[str, ...], output: str) -> N
def process_convert(ctx: click.Context, input_path: str, output: str) -> None:
"""Convert between point cloud formats."""
try:
- from ca.convert import convert
- result = convert(input_path, output)
+ result = ca_backend.convert(input_path, output)
_out(ctx, result)
except Exception as e:
_error(str(e), ctx.obj.get("json", False))
@@ -528,8 +580,7 @@ def inspect(ctx: click.Context) -> None:
def inspect_view(ctx: click.Context, path: str) -> None:
"""Open a point cloud viewer."""
try:
- from ca.view import view
- view(path)
+ ca_backend.view_point_cloud(path)
except Exception as e:
_error(str(e), ctx.obj.get("json", False))
ctx.exit(1)
@@ -545,8 +596,13 @@ def inspect_view(ctx: click.Context, path: str) -> None:
def inspect_web(ctx: click.Context, source: str, reference: Optional[str], heatmap: bool, trajectory: Optional[str], port: int) -> None:
"""Interactive browser inspection."""
try:
- from ca.web import launch_web
- launch_web(source, reference=reference, heatmap=heatmap, trajectory=trajectory, port=port)
+ ca_backend.web_serve(
+ source,
+ reference,
+ port=port,
+ heatmap=heatmap,
+ trajectory=trajectory,
+ )
except Exception as e:
_error(str(e), ctx.obj.get("json", False))
ctx.exit(1)
@@ -560,8 +616,7 @@ def inspect_web(ctx: click.Context, source: str, reference: Optional[str], heatm
def inspect_web_export(ctx: click.Context, source: str, reference: Optional[str], output: str) -> None:
"""Export a static HTML inspection bundle."""
try:
- from ca.web import export_web
- result = export_web(source, reference=reference, output_dir=output)
+ result = ca_backend.web_export_bundle(source, reference, output)
_out(ctx, result)
except Exception as e:
_error(str(e), ctx.obj.get("json", False))
diff --git a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/skills/SKILL.md b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/skills/SKILL.md
index 0f9091c4a..048518439 100644
--- a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/skills/SKILL.md
+++ b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/skills/SKILL.md
@@ -1,6 +1,6 @@
---
name: "cli-anything-cloudanalyzer"
-description: "Command-line interface for CloudAnalyzer — Agent-friendly harness for CloudAnalyzer, a QA platform for mapping, localization, and perception outputs. Supports 32 commands across 8 groups: point cloud evaluation, trajectory evaluation, ground segmentation QA, config-driven quality gates, baseline evolution, processing, visualization, and interactive REPL."
+description: "Command-line interface for CloudAnalyzer — Agent-friendly harness for CloudAnalyzer, a QA platform for mapping, localization, and perception outputs. Supports 27 commands across 8 groups: point cloud evaluation, trajectory evaluation, ground segmentation QA, config-driven quality gates, baseline evolution, processing, visualization, and interactive REPL."
---
# cli-anything-cloudanalyzer
@@ -51,7 +51,7 @@ Compare two point clouds with optional registration.
cli-anything-cloudanalyzer evaluate compare src.pcd tgt.pcd --register gicp
```
-Options: `--register TEXT` (icp/gicp/none), `--report TEXT`
+Options: `--register TEXT` (icp/gicp/none)
#### evaluate diff
Quick distance statistics between two point clouds.
@@ -87,7 +87,7 @@ cli-anything-cloudanalyzer evaluate pipeline input.pcd reference.pcd -o output.p
---
-### 2. trajectory — Trajectory Evaluation (4 commands)
+### 2. trajectory — Trajectory Evaluation (3 commands)
#### trajectory evaluate
Evaluate estimated vs reference trajectory (ATE, RPE, drift, lateral, longitudinal).
@@ -96,7 +96,7 @@ Evaluate estimated vs reference trajectory (ATE, RPE, drift, lateral, longitudin
cli-anything-cloudanalyzer --json trajectory evaluate est.csv gt.csv --max-ate 0.5 --max-lateral 0.3
```
-Options: `--max-ate FLOAT`, `--max-rpe FLOAT`, `--max-drift FLOAT`, `--min-coverage FLOAT`, `--max-lateral FLOAT`, `--max-longitudinal FLOAT`, `--align-origin`, `--align-rigid`, `--report TEXT`
+Options: `--max-ate FLOAT`, `--max-rpe FLOAT`, `--max-drift FLOAT`, `--min-coverage FLOAT`, `--max-lateral FLOAT`, `--max-longitudinal FLOAT`, `--align-origin`, `--align-rigid`
#### trajectory batch
Batch trajectory evaluation.
@@ -112,12 +112,7 @@ Integrated map + trajectory evaluation.
cli-anything-cloudanalyzer trajectory run-evaluate map.pcd map_ref.pcd traj.csv traj_ref.csv
```
-#### trajectory run-batch
-Combined batch QA for map + trajectory.
-
-```bash
-cli-anything-cloudanalyzer trajectory run-batch maps/ --map-reference-dir refs/ --trajectory-dir trajs/ --trajectory-reference-dir traj_refs/
-```
+Options: `--min-auc FLOAT`, `--max-ate FLOAT`
---
@@ -257,9 +252,21 @@ Show CloudAnalyzer version.
---
-### 8. session — Session Management (3 commands)
+### 8. session — Session Management (2 commands)
+
+#### session new
+Create a new harness project JSON file.
+
+```bash
+cli-anything-cloudanalyzer session new -o project.json -n my-run
+```
+
+#### session history
+Show recent operations for the project given with `-p` / `--project`.
-#### session new / session history / session save
+```bash
+cli-anything-cloudanalyzer --project project.json session history --last 20
+```
---
diff --git a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/tests/test_full_e2e.py b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/tests/test_full_e2e.py
index 3efd6a4a9..86b4c9f0b 100644
--- a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/tests/test_full_e2e.py
+++ b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/tests/test_full_e2e.py
@@ -7,6 +7,13 @@ import pytest
from click.testing import CliRunner
from cli_anything.cloudanalyzer.cloudanalyzer_cli import cli
+from cli_anything.cloudanalyzer.utils import ca_backend
+
+
+requires_cloudanalyzer = pytest.mark.skipif (
+ not ca_backend.is_available(),
+ reason="CloudAnalyzer (import ca) is not installed",
+)
@pytest.fixture
@@ -39,6 +46,7 @@ class TestSessionCommands:
assert result.exit_code != 0
+@requires_cloudanalyzer
class TestCheckCommands:
def test_init_creates_config(self, runner, tmp_path):
dest = str(tmp_path / "cloudanalyzer.yaml")
@@ -53,6 +61,7 @@ class TestCheckCommands:
assert result.exit_code != 0
+@requires_cloudanalyzer
class TestBaselineCommands:
def test_save_and_list(self, runner, tmp_path):
summary = tmp_path / "summary.json"
diff --git a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/utils/ca_backend.py b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/utils/ca_backend.py
index 5649f8ad4..96e2a4bca 100644
--- a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/utils/ca_backend.py
+++ b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/utils/ca_backend.py
@@ -10,6 +10,11 @@ import json
from pathlib import Path
from typing import Any
+MISSING_CLOUDANALYZER_MSG = (
+ "CloudAnalyzer is not installed or not importable. "
+ "Install with: pip install cloudanalyzer"
+)
+
def is_available() -> bool:
"""Check if CloudAnalyzer is importable."""
@@ -20,6 +25,11 @@ def is_available() -> bool:
return False
+def _ensure_ca() -> None:
+ if not is_available():
+ raise RuntimeError(MISSING_CLOUDANALYZER_MSG)
+
+
def get_version() -> str:
"""Return the installed CloudAnalyzer version."""
try:
@@ -31,24 +41,28 @@ def get_version() -> str:
def evaluate(source: str, reference: str, **kwargs: Any) -> dict:
"""Run point cloud evaluation."""
+ _ensure_ca()
from ca.evaluate import evaluate as _evaluate
return _evaluate(source, reference, **kwargs)
def compare(source: str, target: str, method: str = "gicp", **kwargs: Any) -> dict:
"""Run point cloud comparison with optional registration."""
+ _ensure_ca()
from ca.compare import run_compare
return run_compare(source, target, method=method, **kwargs)
def diff(source: str, target: str, threshold: float | None = None) -> dict:
"""Run quick distance diff."""
+ _ensure_ca()
from ca.diff import run_diff
return run_diff(source, target, threshold=threshold)
def evaluate_trajectory(estimated: str, reference: str, **kwargs: Any) -> dict:
"""Evaluate a trajectory against reference."""
+ _ensure_ca()
from ca.trajectory import evaluate_trajectory as _eval_traj
return _eval_traj(estimated, reference, **kwargs)
@@ -58,6 +72,7 @@ def evaluate_ground(
ref_ground: str, ref_nonground: str, **kwargs: Any,
) -> dict:
"""Evaluate ground segmentation quality."""
+ _ensure_ca()
from ca.ground_evaluate import evaluate_ground_segmentation
return evaluate_ground_segmentation(
est_ground, est_nonground, ref_ground, ref_nonground, **kwargs,
@@ -66,6 +81,7 @@ def evaluate_ground(
def run_check_suite(config_path: str) -> dict:
"""Run config-driven QA checks."""
+ _ensure_ca()
from ca.core import load_check_suite, run_check_suite as _run
suite = load_check_suite(config_path)
return _run(suite)
@@ -73,6 +89,7 @@ def run_check_suite(config_path: str) -> dict:
def render_check_scaffold(profile: str = "integrated") -> str:
"""Generate a starter config YAML."""
+ _ensure_ca()
from ca.core import render_check_scaffold as _render
result = _render(profile=profile)
return result.yaml_text
@@ -80,6 +97,7 @@ def render_check_scaffold(profile: str = "integrated") -> str:
def baseline_decision(candidate_path: str, history_paths: list[str]) -> dict:
"""Decide promote / keep / reject for a baseline."""
+ _ensure_ca()
from ca.core import summarize_baseline_evolution
candidate = json.loads(Path(candidate_path).read_text(encoding="utf-8"))
history = [
@@ -90,41 +108,175 @@ def baseline_decision(candidate_path: str, history_paths: list[str]) -> dict:
def baseline_save(summary_path: str, history_dir: str, **kwargs: Any) -> str:
"""Save a QA summary to the history directory."""
+ _ensure_ca()
from ca.baseline_history import save_baseline
return save_baseline(summary_path, history_dir, **kwargs)
def baseline_list(history_dir: str) -> list[dict]:
"""List saved baselines."""
+ _ensure_ca()
from ca.baseline_history import list_baselines
return list_baselines(history_dir)
def baseline_discover(history_dir: str) -> list[str]:
"""Discover history JSON paths."""
+ _ensure_ca()
from ca.baseline_history import discover_history
return discover_history(history_dir)
def baseline_rotate(history_dir: str, keep: int = 10) -> list[str]:
"""Rotate old baselines."""
+ _ensure_ca()
from ca.baseline_history import rotate_history
return rotate_history(history_dir, keep=keep)
def downsample(input_path: str, output_path: str, voxel_size: float) -> dict:
"""Voxel grid downsampling."""
+ _ensure_ca()
from ca.downsample import downsample as _ds
return _ds(input_path, voxel_size, output_path)
def split(input_path: str, output_dir: str, grid_size: float, axis: str = "xy") -> dict:
"""Split a point cloud into grid tiles."""
+ _ensure_ca()
from ca.split import split as _split
return _split(input_path, output_dir, grid_size, axis=axis)
def info(path: str) -> dict:
"""Get point cloud metadata."""
+ _ensure_ca()
from ca.info import get_info
return get_info(path)
+
+
+def batch_evaluate(directory: str, reference: str, **kwargs: Any) -> dict:
+ """Evaluate every point cloud in a directory against one reference."""
+ _ensure_ca()
+ from ca.batch import batch_evaluate as _be
+ return _be(directory, reference, **kwargs)
+
+
+def run_pipeline(
+ input_path: str, reference: str, output: str, **kwargs: Any,
+) -> dict:
+ """Filter, downsample, evaluate in one pipeline."""
+ _ensure_ca()
+ from ca.pipeline import run_pipeline as _rp
+ return _rp(input_path, reference, output, **kwargs)
+
+
+def trajectory_batch_evaluate(
+ directory: str, reference_dir: str, **kwargs: Any,
+) -> dict:
+ """Batch trajectory evaluation."""
+ _ensure_ca()
+ from ca.batch import trajectory_batch_evaluate as _tbe
+ return _tbe(directory, reference_dir, **kwargs)
+
+
+def evaluate_run(
+ map_path: str,
+ map_reference_path: str,
+ trajectory_path: str,
+ trajectory_reference_path: str,
+ **kwargs: Any,
+) -> dict:
+ """Evaluate one map and one trajectory together."""
+ _ensure_ca()
+ from ca.run_evaluate import evaluate_run as _er
+ return _er(
+ map_path,
+ map_reference_path,
+ trajectory_path,
+ trajectory_reference_path,
+ **kwargs,
+ )
+
+
+def random_sample(input_path: str, output_path: str, num_points: int) -> dict:
+ """Random point sampling."""
+ _ensure_ca()
+ from ca.sample import random_sample as _rs
+ return _rs(input_path, output_path, num_points)
+
+
+def filter_outliers(
+ input_path: str, output_path: str, **kwargs: Any,
+) -> dict:
+ """Statistical outlier removal."""
+ _ensure_ca()
+ from ca.filter import filter_outliers as _fo
+ return _fo(input_path, output_path, **kwargs)
+
+
+def merge(paths: list[str], output: str) -> dict:
+ """Merge point clouds."""
+ _ensure_ca()
+ from ca.merge import merge as _m
+ return _m(paths, output)
+
+
+def convert(input_path: str, output_path: str) -> dict:
+ """Convert between point cloud formats."""
+ _ensure_ca()
+ from ca.convert import convert as _c
+ return _c(input_path, output_path)
+
+
+def view_point_cloud(path: str) -> None:
+ """Open the interactive point cloud viewer (single file)."""
+ _ensure_ca()
+ from ca.view import view as _view
+ _view([path])
+
+
+def web_serve(
+ source: str,
+ reference: str | None,
+ *,
+ port: int = 8080,
+ heatmap: bool = False,
+ trajectory: str | None = None,
+ trajectory_reference: str | None = None,
+ open_browser: bool = True,
+) -> None:
+ """Start the CloudAnalyzer web viewer."""
+ _ensure_ca()
+ from ca.web import serve
+ paths: list[str] = [source] if not reference else [source, reference]
+ serve(
+ paths,
+ port=port,
+ open_browser=open_browser,
+ heatmap=heatmap,
+ trajectory_path=trajectory,
+ trajectory_reference_path=trajectory_reference,
+ )
+
+
+def web_export_bundle(
+ source: str,
+ reference: str | None,
+ output_dir: str,
+ *,
+ heatmap: bool = False,
+ trajectory: str | None = None,
+ trajectory_reference: str | None = None,
+) -> dict:
+ """Write a static HTML viewer bundle."""
+ _ensure_ca()
+ from ca.web import export_static_bundle
+ paths: list[str] = [source] if not reference else [source, reference]
+ return export_static_bundle(
+ paths,
+ output_dir=output_dir,
+ heatmap=heatmap,
+ trajectory_path=trajectory,
+ trajectory_reference_path=trajectory_reference,
+ )