Skip to content

MetriPlane v0.2.0 - Physical Observability, Evidence Bundles, and Command Center

Latest
Latest

Choose a tag to compare

View all tags
@Miko997 Miko997 released this 17 Jun 17:52
· 1 commit to main since this release
v0.2.0
8e35ed5

MetriPlane v0.2.0 — Physical Observability, Evidence Bundles, and Command Center

MetriPlane v0.2.0 is an open-source physical-observability release for bounded planar workcells. It converts calibrated camera/replay-derived state into named assets, traces, spatial contracts, incidents, evidence bundles, operator-review reports, and generated physical regression tests.

This release is the primary software artifact for the planned SoftwareX paper. The historical DOI-archived baseline remains MetriPlane v0.1.4.

Main additions

  • Physical-observability release identity
  • Sentinel observe-only auditing
  • Atlas Evidence Review / Cell Black Box workflow
  • Domain packs and deterministic assembly-cell replay
  • Physical event ledger
  • Cell Truth Report
  • Evidence bundle verification
  • Generated physical regression tests
  • Command Center review UI/API
  • Camera trust, local evidence Q&A, counterfactuals, and forecasting evidence
  • ROS 2 / Isaac / Omniverse adapter surfaces with bounded claims
  • Docker local replay/demo smoke evidence, bounded to build/start, health endpoint JSON, and cleanup logs
  • SoftwareX paper evidence package under evidence/paper_v2_0/
  • Reviewer kit under docs/review_kit/

Reproduce the paper demo

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

python -m metriplane.cli doctor
PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python -m pytest -q

./tools/mp.sh deterministic-replay

metriplane atlas validate-pack configs/domain_packs/assembly_cell

metriplane atlas run \
  --session-jsonl datasets/demo/atlas/assembly_cell_missing_tool.jsonl \
  --pack configs/domain_packs/assembly_cell \
  --out runs/atlas/assembly_cell_missing_tool

metriplane atlas bundle verify \
  runs/atlas/assembly_cell_missing_tool/evidence_bundles/INC-0001.zip

metriplane atlas test \
  runs/atlas/assembly_cell_missing_tool/regression_tests/INC-0001.yaml

metriplane atlas dashboard build \
  --run-dir runs/atlas/assembly_cell_missing_tool

Evidence status

The captured v0.2.0 paper evidence package records:

  • 580 passing tests
  • Deterministic replay pass
  • Atlas assembly-cell run: 6 events, 1 incident
  • Evidence bundle verification pass
  • Generated regression test pass
  • Dashboard build pass
  • Python sdist/wheel build pass
  • twine check pass
  • Docker local replay/demo smoke captured as bounded smoke evidence only

Key paper artifacts

The release includes a dedicated paper evidence package:

evidence/paper_v2_0/

Important generated artifacts include:

evidence/paper_v2_0/atlas_run/cell_truth_report.md
evidence/paper_v2_0/atlas_run/cell_truth_report.html
evidence/paper_v2_0/atlas_run/atlas_dashboard.html
evidence/paper_v2_0/atlas_run/physical_event_log.jsonl
evidence/paper_v2_0/atlas_run/reality_graph.json
evidence/paper_v2_0/atlas_run/process_trace.json
evidence/paper_v2_0/atlas_run/evidence_bundles/INC-0001.zip
evidence/paper_v2_0/atlas_run/regression_tests/INC-0001.yaml
evidence/paper_v2_0/CHECKSUMS.sha256

DOI and citation

The v0.2.0 Zenodo archive is available at:

10.5281/zenodo.20736619

Zenodo record:

https://zenodo.org/records/20736619

Recommended citation:

Parkkinen, M. (2026). MetriPlane v0.2.0: Open-Source Physical Observability for Workcell Evidence, Replay, and Regression Testing (Version 0.2.0) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.20736619

Historical baseline

The historical DOI-archived baseline remains:

MetriPlane v0.1.4 — 10.5281/zenodo.20631037

v0.1.4 provides the earlier repository-stabilized baseline for camera-first planar metric state streaming, deterministic replay, zone analytics, and benchmark evidence. v0.2.0 extends that baseline into physical observability, evidence bundles, operator review, and regression testing.

Scope and limitations

MetriPlane is observe-only.

It does not:

  • control robots or machines
  • certify safety
  • approve quality release
  • recognize people
  • claim marker-free tracking
  • claim full 3D reconstruction
  • claim production collision avoidance
  • claim factory-wide deployment validation

ROS 2, Isaac, Omniverse, Docker, Jetson, and exporter paths are bounded adapter/deployment surfaces unless separately evidenced.

Docker evidence in this release is local replay/demo smoke only. It is not benchmark, production-runtime, live-camera, reliability, or safety evidence.

SoftwareX status

This release is the primary software artifact for a planned SoftwareX submission. No accepted or peer-reviewed SoftwareX publication is claimed by this release.

Assets 2
Loading