Cli Anything Cloudanalyzer

by hkuds34f519533bc1No license51K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 2 weeks ago

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.

AI-generated overview

Command-line harness for CloudAnalyzer that evaluates point cloud, trajectory and ground segmentation quality against references.

What it does
Wraps the CloudAnalyzer QA platform in a command-line interface with 27 commands in 8 groups. It evaluates point clouds (Chamfer, F1, AUC, Hausdorff), trajectories (ATE, RPE, drift), and ground segmentation, and runs config-driven quality gates. It also processes point clouds, manages baselines, inspects results, and reports metadata, with JSON output for agent use.
When to use it
Use it to check mapping, localization or perception point cloud outputs against reference data. It suits automated quality gates, batch evaluation, and baseline promotion decisions in a QA pipeline.
Requirements
Python 3.10+ and the cloudanalyzer package, installed via pip. It is instructions only and ships no scripts; it needs point cloud and trajectory input files and may write output files, plots, HTML bundles and project JSON.

cli-anything-cloudanalyzer

Agent-friendly command-line harness for CloudAnalyzer — a QA platform for mapping, localization, and perception point cloud outputs.

27 commands across 8 groups.

Installation

bash
pip install cli-anything-cloudanalyzer

Prerequisites:

  • Python 3.10+
  • CloudAnalyzer: pip install cloudanalyzer

Global Options

bash
cli-anything-cloudanalyzer [--project FILE] [--json] COMMAND [ARGS]...
OptionDescription
-p, --project TEXTPath to project JSON file
--jsonOutput results as JSON (for agent consumption)

Command Groups

1. evaluate — Point Cloud Evaluation (6 commands)

evaluate run

Evaluate a point cloud against a reference (Chamfer, F1, AUC, Hausdorff).

bash
cli-anything-cloudanalyzer evaluate run source.pcd reference.pcdcli-anything-cloudanalyzer --json evaluate run source.pcd reference.pcd

Options: --plot TEXT, --threshold FLOAT

evaluate compare

Compare two point clouds with optional registration.

bash
cli-anything-cloudanalyzer evaluate compare src.pcd tgt.pcd --register gicp

Options: --register TEXT (icp/gicp/none)

evaluate diff

Quick distance statistics between two point clouds.

bash
cli-anything-cloudanalyzer evaluate diff a.pcd b.pcd --threshold 0.1
evaluate batch

Batch evaluation of multiple point clouds against a reference.

bash
cli-anything-cloudanalyzer --json evaluate batch results/ reference.pcd --min-auc 0.95

Options: --min-auc FLOAT, --max-chamfer FLOAT

evaluate ground

Evaluate ground segmentation quality (precision, recall, F1, IoU).

bash
cli-anything-cloudanalyzer --json evaluate ground est_ground.pcd est_ng.pcd ref_ground.pcd ref_ng.pcd --min-f1 0.9

Options: --voxel-size FLOAT, --min-precision FLOAT, --min-recall FLOAT, --min-f1 FLOAT, --min-iou FLOAT

evaluate pipeline

Filter, downsample, evaluate in one command.

bash
cli-anything-cloudanalyzer evaluate pipeline input.pcd reference.pcd -o output.pcd

2. trajectory — Trajectory Evaluation (3 commands)

trajectory evaluate

Evaluate estimated vs reference trajectory (ATE, RPE, drift, lateral, longitudinal).

bash
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

trajectory batch

Batch trajectory evaluation.

bash
cli-anything-cloudanalyzer trajectory batch runs/ --reference-dir gt/ --max-drift 1.0
trajectory run-evaluate

Integrated map + trajectory evaluation.

bash
cli-anything-cloudanalyzer trajectory run-evaluate map.pcd map_ref.pcd traj.csv traj_ref.csv

Options: --min-auc FLOAT, --max-ate FLOAT


3. check — Config-Driven Quality Gate (2 commands)

check run

Run unified QA from a config file.

bash
cli-anything-cloudanalyzer --json check run cloudanalyzer.yaml

Options: --output-json TEXT

check init

Generate a starter config file.

bash
cli-anything-cloudanalyzer check init cloudanalyzer.yaml --profile integrated

Options: --profile TEXT (mapping/localization/perception/integrated), --force


4. baseline — Baseline Evolution (3 commands)

baseline decision

Decide whether to promote, keep, or reject a candidate baseline.

bash
cli-anything-cloudanalyzer --json baseline decision qa/summary.json --history-dir qa/history/

Options: --history TEXT (repeatable), --history-dir TEXT, --output-json TEXT

baseline save

Save a QA summary to the history directory.

bash
cli-anything-cloudanalyzer baseline save qa/summary.json --history-dir qa/history/ --keep 10

Options: --history-dir TEXT, --label TEXT, --keep INTEGER

baseline list

List saved baselines.

bash
cli-anything-cloudanalyzer --json baseline list --history-dir qa/history/

5. process — Point Cloud Processing (6 commands)

process downsample

Voxel grid downsampling.

bash
cli-anything-cloudanalyzer process downsample cloud.pcd -o down.pcd -v 0.05
process sample

Random point sampling.

bash
cli-anything-cloudanalyzer process sample cloud.pcd -o sampled.pcd -n 10000
process filter

Statistical outlier removal.

bash
cli-anything-cloudanalyzer process filter cloud.pcd -o filtered.pcd
process split

Split point cloud into grid tiles (writes metadata.yaml).

bash
cli-anything-cloudanalyzer process split large.pcd -o tiles/ -g 100
process merge

Merge multiple point clouds.

bash
cli-anything-cloudanalyzer process merge a.pcd b.pcd -o merged.pcd
process convert

Convert between point cloud formats.

bash
cli-anything-cloudanalyzer process convert input.las -o output.pcd

6. inspect — Visualization (3 commands)

inspect view

Open a point cloud viewer.

bash
cli-anything-cloudanalyzer inspect view cloud.pcd
inspect web

Interactive browser inspection.

bash
cli-anything-cloudanalyzer inspect web map.pcd ref.pcd --heatmap
inspect web-export

Export a static HTML inspection bundle.

bash
cli-anything-cloudanalyzer inspect web-export map.pcd ref.pcd -o bundle/

7. info — Metadata (2 commands)

info show

Show point cloud metadata.

bash
cli-anything-cloudanalyzer --json info show cloud.pcd
info version

Show CloudAnalyzer version.


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.

bash
cli-anything-cloudanalyzer --project project.json session history --last 20

Typical Agent Workflows

Workflow 1: Evaluate and gate a point cloud

bash
cli-anything-cloudanalyzer --json evaluate run output.pcd reference.pcd

Workflow 2: Config-driven QA pipeline

bash
cli-anything-cloudanalyzer check init cloudanalyzer.yaml --profile integratedcli-anything-cloudanalyzer --json check run cloudanalyzer.yaml

Workflow 3: Baseline management

bash
cli-anything-cloudanalyzer --json check run cloudanalyzer.yaml --output-json qa/summary.jsoncli-anything-cloudanalyzer baseline save qa/summary.json --history-dir qa/history/cli-anything-cloudanalyzer --json baseline decision qa/summary.json --history-dir qa/history/

Workflow 4: Ground segmentation QA

bash
cli-anything-cloudanalyzer --json evaluate ground \  est_ground.pcd est_ng.pcd ref_ground.pcd ref_ng.pcd --min-f1 0.9

Source and attribution

Source:hkuds/cli-anythinginskills/cli-anything-cloudanalyzerat commit34f5195

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal