Metadata-Version: 2.4
Name: pb-matrix-calculator
Version: 0.0.1
Summary: PB 标定矩阵计算器：矩阵/四元数/欧拉角/齐次矩阵转换、组合计算与 PySide6 GUI。
License-Expression: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: numpy>=1.20
Requires-Dist: PyYAML>=6.0
Requires-Dist: PySide6
Requires-Dist: pb-calibration>=0.1.9
Requires-Dist: transform-base>=0.0.3
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"

# pb-matrix-calculator

Version: 0.0.1

PB 标定矩阵计算器，提供 Agent 友好的结构化 CLI 和 PySide6 GUI。支持旋转矩阵、四元数、欧拉角、齐次矩阵之间的转换，支持 A/B 矩阵组合计算，并可输出 YAML、JSON、ROS、OpenCV、CloudCompare、PB transforms 等格式。

## Install

```bash
pip install pb-matrix-calculator
```

开发环境中可从当前版本目录安装：

```bash
pip install -e .
```

## CLI

列出可用输入协议和输出格式：

```bash
pb-matrix-calculator list-formats
```

四元数和平移转换为全部标准格式：

```bash
pb-matrix-calculator convert \
  --type quaternion \
  --quaternion 0,0,0,1 \
  --translation 1,2,3 \
  --result all
```

输出 YAML bundle：

```bash
pb-matrix-calculator convert \
  --type quaternion \
  --quaternion 0,0,0,1 \
  --translation 1,2,3 \
  --result yaml_bundle
```

组合计算 A/B 矩阵：

```bash
pb-matrix-calculator compute \
  --a-type quaternion --a-quaternion 0,0,0,1 --a-translation 1,2,3 \
  --b-type quaternion --b-quaternion 0,0,0,1 --b-translation 4,5,6 \
  --result all
```

## GUI

```bash
pb-matrix-calculator-gui
```

默认配置、格式模板和图标随包分发，位于 `pb_matrix_calculator/cfg` 与 `pb_matrix_calculator/icon`。运行期生成的 `output/`、日志和 PB 临时 YAML 目录相对启动命令所在目录创建，不写入包安装目录。

## Python Import

```python
from pb_matrix_calculator.cli import load_app_config, render_output
from pb_matrix_calculator.lib.matrix_processor import MatrixProcessor
```

## Dependencies

- Python >= 3.10
- numpy
- PyYAML
- PySide6
- pb-calibration >= 0.1.9
- transform-base >= 0.0.3

## Packaging Notes

本版本从 `C_project/C08_pb矩阵计算器` 迁入 `D_pypi/D12.pb_matrix_calculator/V0.0.1`。原 C08 目录保留不动，作为历史和应用源码参考。包名使用 `pb-matrix-calculator`，导入名使用 `pb_matrix_calculator`。

## License

MIT

