feat: 添加海上风电场集电线路设计优化工具

README.md

@@ -0,0 +1,110 @@
+# 海上风电场集电线路设计优化工具
+
+## 项目简介
+
+这是一个用于海上风电场集电线路拓扑设计和优化的Python工具。它专注于解决大规模海上风电场的集电系统规划问题，通过算法比较不同设计方案的经济性和技术指标。
+
+本项目特别针对**海上风电**场景进行了优化，考虑了海缆的高昂成本、大功率风机（6-10MW）以及严格的电缆载流量约束。
+
+## 核心功能
+
+### 1. 多种布局生成与导入
+- **自动生成**：支持生成规则的矩阵式（Grid）风机布局，模拟海上风电场常见排布。
+- **Excel导入**：支持从 `coordinates.xlsx` 导入自定义的风机和升压站坐标。
+  - 格式要求：包含 `Type` (Turbine/Substation), `ID`, `X`, `Y`, `Power` 列。
+
+### 2. 智能拓扑优化算法
+- **最小生成树 (MST)**：
+  - 计算全局最短路径长度。
+  - *注意*：在大规模风电场中，纯MST往往会导致根部电缆严重过载，仅作为理论最短路径参考。
+- **扇区聚类 (Angular K-means)**：
+  - **无交叉设计**：基于角度（扇区）进行聚类，从几何上杜绝不同回路间的电缆交叉。
+  - **容量约束**：自动计算所需的最小回路数（Clusters），确保每条集电线路的总功率不超过海缆极限。
+
+### 3. 精细化电气计算与选型
+- **动态电缆选型**：
+  - 基于实际潮流计算（Power Flow），为每一段线路选择最经济且满足载流量的电缆。
+  - 规格库：覆盖 35mm² 至 400mm² 海缆。
+  - 参数：电压等级 **66kV**，功率因数 0.95。
+- **成本与损耗评估**：
+  - 考虑海缆材料及敷设成本（约为陆缆的5倍）。
+  - 计算全场集电线路的 $I^2R$ 损耗。
+
+### 4. 工程级可视化与输出
+- **可视化图表**：
+  - 生成直观的拓扑连接图。
+  - **颜色编码**：使用不同颜色和粗细区分不同截面的电缆（如绿色细线为35mm²，红色粗线为400mm²）。
+  - 自动保存为高清 PNG 图片。
+- **CAD (DXF) 导出**：
+  - 使用 `ezdxf` 生成 `.dxf` 文件。
+  - 分层管理：风机、升压站、各规格电缆分层显示，可直接导入 AutoCAD 进行后续工程设计。
+
+## 安装说明
+
+### 环境要求
+- Python >= 3.10
+- 推荐使用 [uv](https://github.com/astral-sh/uv) 进行依赖管理。
+
+### 安装依赖
+
+```bash
+# 使用 uv (推荐)
+uv add numpy pandas matplotlib scipy scikit-learn networkx ezdxf openpyxl
+
+# 或使用 pip
+pip install numpy pandas matplotlib scipy scikit-learn networkx ezdxf openpyxl
+```
+
+## 使用方法
+
+### 1. 运行主程序
+
+```bash
+# 使用 uv
+uv run main.py
+
+# 或直接运行
+python main.py
+```
+
+### 2. 数据输入模式
+
+程序会自动检测当前目录下是否存在 `coordinates.xlsx`：
+
+- **存在**：优先读取 Excel 文件中的坐标数据进行计算。
+- **不存在**：自动生成 30 台风机的规则布局（Grid Layout）进行演示。
+
+### 3. 结果输出
+
+程序运行结束后会：
+1.  在终端打印详细的成本、损耗及电缆统计数据。
+2.  弹窗显示拓扑对比图，并保存为 `wind_farm_design_imported.png` (或 `offshore_...png`)。
+3.  生成 CAD 图纸文件 `wind_farm_design.dxf`。
+
+## 关键参数说明
+
+可以在 `main.py` 中调整以下核心常量以适配不同项目：
+
+```python
+VOLTAGE_LEVEL = 66000  # 集电系统电压 (V)
+POWER_FACTOR = 0.95    # 功率因数
+cost_multiplier = 5.0  # 海缆相对于陆缆的成本倍数
+```
+
+## 输出示例
+
+```text
+系统设计参数: 总功率 2000.0 MW, 单回路最大容量 50.4 MW
+计算建议回路数(簇数): 48 (最小需求 40)
+
+[Sector Clustering] 电缆统计:
+  70mm²: 48 条
+  185mm²: 37 条
+  400mm²: 40 条
+
+成功导出DXF文件: wind_farm_design.dxf
+```
+
+## 许可证
+
+本项目仅供学习和研究使用。