# 🗺️ CoordConverter — 坐标转换套件 (Mercator Suite)

<p align="center">
  <b>地理信息行业专用 · TXT / Excel / SHP 互转 · 多坐标系转换</b>
  <br>
  <code>Mercator Suite</code> <code>Python 3</code> <code>pyproj</code> <code>geopandas</code>
</p>

---

## 📌 一句话

TXT、Excel(CSV)、SHP 三种格式的坐标数据**任意互转**，同时支持 **WGS84 / CGCS2000 / Xian80 / Beijing54 / Web Mercator** 坐标系转换。

## 🚀 快速使用（作为 Mercator 套件）

```bash
agc run /tmp/coord-output \
  --suite-id <suite_id> \
  --input input_file=/data/外业数据.txt \
  --input output_file=/tmp/coord-output/成果表.xlsx \
  --input from_crs=EPSG:4326 \
  --input to_crs=EPSG:4490
```

## 📦 依赖

已预装 `gis-base:latest`，额外需要：
- `pandas`、`openpyxl`（Excel 读写）

## 🏗️ 项目结构

```
coord-converter-suite/
├── workflow.yaml         ← Mercator 套件定义
├── run_suite.py          ← 套件入口（读取 PARAM_* 环境变量）
├── requirements.txt
├── README.md
├── core/
│   ├── coord_transform.py   ← 坐标系转换引擎（pyproj）
│   └── data_model.py        ← 统一数据模型
├── file_io/
│   ├── txt_handler.py       ← TXT/CSV 读写（自动检测分隔符）
│   ├── excel_handler.py     ← Excel/CSV 读写
│   └── shp_handler.py       ← SHP 读写（geopandas）
├── converter/
│   └── workflow.py          ← 转换编排器
├── cli/
│   └── cli_runner.py        ← 独立 CLI（可本地调试）
└── examples/
    ├── sample_points.txt
    └── sample_points.csv
```