# FaShuTool (法术网优工具)

## 简介

FaShuTool 是一款基于 QGIS 的专业无线网络规划工具插件，主要服务于 LTE/5G 网络规划工程师。插件集成小区/扇区图层制作、邻区规划、PCI 规划优化、常用图形快速绘制等核心功能，通过图形化界面帮助工程师更高效地完成网络规划与制图工作。

## 功能特性

### 1. 扇区图层制作 (Sector / Import File)
- 支持导入规划数据/工参数据模板
- 可视化小区覆盖方向和覆盖范围
- 自动创建扇区多边形和圆形覆盖图层
- 支持配置不同频点的显示颜色
- 可将配置数据写入 SQLite 数据库

### 2. 泰森多边形 (Voronoi layer)
- 支持矢量图层选择与原位绘制
- TAC 插花图层绘制

### 3. 点图层制作 (Point layer)
- 批量点图层制作，支持自动识别经纬度字段
- 支持 Excel / CSV 数据导入

### 4. 专题图层制作-区间点图层 (Thematic layer)
- 按区间对应颜色，批量绘制点图层
- 支持自动识别经纬度
- 需手动选择区间对应值

### 5. 嵌入图例 (Embed Legend)
- 在画布旁嵌入独立的图例停靠面板
- 支持实时同步图层与要素数量
- 可自定义字体、文字/背景/边框颜色
- 可切换现代（方框）与极简样式，显示图层名称、数量、百分比

### 6. 邻区规划 (Neighbor Planning)
- 支持从剪贴板批量导入规划小区 CGI 列表
- 自动计算宏站和室内小区的邻区关系
- 支持距离、方位角、频段计算
- 可设置最大邻区数量和最小距离约束
- 支持规划结果导出 Excel

### 7. PCI 规划 (PCI Planning)
- PCI 自动规划与优化
- 支持 LTE 标准 PCI 范围解析
- 考虑同频邻区干扰避免
- 支持批量小区 PCI 优化
- 实时显示优化进度与最佳适应度

### 8. 查找 (Layer Search)
- 支持快速搜索和定位 QGIS 中的矢量图层
- 可按字段进行属性查询
- 支持图层缩放和几何闪烁高亮
- 实时搜索结果显示

### 9. 图形快速绘制 (Quick Draw)
- 绘制圆形：画布拖动绘制，可配置填充/边框颜色
- 绘制矩形：画布拖动绘制，可配置填充/边框颜色
- 绘制多边形：左键添加顶点、右键结束，可配置填充/边框颜色
- 绘制线：左键添加顶点、右键结束，可配置线的颜色、宽度

## 安装方法

### 环境要求
- QGIS 3.x（推荐 QGIS 3.10+，兼容 QGIS 4.x）
- Python 3.6+
- 依赖包：pandas、openpyxl（Excel 导出）、numpy（通常随 QGIS 自带）；不再依赖 scipy

### 安装步骤
1. 克隆或下载插件源码到本地：
   git clone https://gitee.com/fashuchenmo/fa_shu_tool.git

2. 将插件目录复制到 QGIS 插件目录：
   - Linux: ~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/
   - Windows: %APPDATA%\QGIS\QGIS3\profiles\default\python\plugins\
   - macOS: ~/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins/

3. 重启 QGIS，在"插件管理器"中搜索并启用"FaShuTool"。

### 编译资源文件（可选）
如需修改翻译文件：
   - 编译翻译文件: ./scripts/compile-strings.sh
   - 更新翻译源文件: ./scripts/update-strings.sh

## 使用说明

### 启动插件
QGIS 会在菜单栏创建"法术网优工具"顶级菜单，并按功能分类建立二级子菜单；常用工具同时加入独立的"法术网优工具"工具栏。

菜单结构：
- 图层制作：扇区图层制作、泰森多边形、点图层制作、专题图层制作、嵌入图例
- 数据规划：邻区规划、PCI 规划
- 图形绘制：绘制圆形、绘制矩形、绘制多边形、绘制线
- 其他：查找、帮助

### 扇区图层制作
1. 点击"图层制作 → 扇区图层制作"
2. 导入或新建工参/频点配置模板
3. 设置各频点的显示颜色
4. 配置小区绘制参数（方向、宽度、半径）
5. 生成扇区与圆形覆盖图层；可将配置保存为模板或写入数据库

### 泰森多边形
1. 点击"图层制作 → 泰森多边形"
2. 选择矢量图层及经度、纬度、数值字段
3. 点击"生成"按钮即可，结果以临时图层加载

### 点图层制作
1. 点击"图层制作 → 点图层制作"
2. 选择 Excel / CSV 数据并自动识别经纬度字段
3. 点击生成批量点图层

### 专题图层制作
1. 点击"图层制作 → 专题图层制作"
2. 选择数据并设置区间与对应颜色
3. 批量绘制区间点图层

### 嵌入图例
1. 点击"图层制作 → 嵌入图例"
2. 图例面板嵌入画布旁，随图层选择实时同步
3. 右键图例面板可调整字体、颜色、样式及显示内容

### 邻区规划
1. 点击"数据规划 → 邻区规划"
2. 通过剪贴板导入 CGI 列表，或选择规划文件
3. 设置宏站和室内小区的搜索参数
4. 点击开始规划并查看结果，可导出规划结果

### PCI 规划
1. 点击"数据规划 → PCI 规划"
2. 选择输入数据文件或从数据库读取小区信息
3. 配置 PCI 规划参数
4. 点击运行开始优化，查看结果并导出

### 查找
1. 点击"查找"
2. 选择图层、搜索字段并输入关键词
3. 点击搜索查看结果，双击结果可缩放定位

### 图形快速绘制
以圆形为例：
1. 点击"图形绘制 → 绘制圆形"
2. 在画布上拖动鼠标绘制圆形区域
3. 右键点击结束绘制；可配置填充颜色、边框颜色等参数

矩形需拖动绘制；多边形点击左键添加顶点、右键结束；线形点击左键添加顶点、右键结束。

## 项目结构

fa_shu_tool/
├── fa_shu_tool.py                    # 主插件入口与菜单
├── fa_shu_tool_import_file.py        # 扇区图层制作（数据导入与可视化）
├── fa_shu_tool_Voronoi.py            # 泰森多边形模块
├── fa_shu_tool_point.py              # 点图层制作模块
├── fa_shu_tool_thematic_layer.py     # 专题图层制作模块
├── fa_shu_tool_legend.py             # 嵌入图例面板模块
├── fa_shu_tool_neighbor.py           # 邻区规划模块
├── fa_shu_tool_pci.py                # PCI规划模块
├── fa_shu_tool_layer_search.py       # 查找（图层搜索）模块
├── fa_shu_tool_circle_quick.py       # 圆形快速绘制模块
├── fa_shu_tool_rectangle_quick.py    # 矩形快速绘制模块
├── fa_shu_tool_polygon_quick.py      # 多边形快速绘制模块
├── fa_shu_tool_line_quick.py         # 线快速绘制模块
├── fa_shu_tool*.ui                   # Qt UI界面文件
├── icon/                             # 功能图标目录
├── icon.png                          # 插件图标
├── template/                         # 规划数据模板
├── help/                             # 帮助文档
├── metadata.txt                      # 插件元数据
└── i18n/                             # 国际化翻译文件

## 测试

插件包含完整的单元测试，覆盖对话框测试与 QGIS 环境测试。

运行测试：
cd test
python -m pytest

## 许可证

本项目遵循 MIT 许可证开源。

## 贡献

欢迎提交 Issue 或 Pull Request 来改进插件功能。

## 联系方式

- 项目地址: https://gitee.com/fashuchenmo/fa_shu_tool
- 作者: fashuchenmo