上传 2D 建筑图纸(png / jpg / pdf),自动识别墙体线段,输出每段墙体的起止坐标外墙类型、厚度(固定 JSON 格式),并在网页上叠加可视化
浏览HTML+JS+Canvas) Spring Boot :8888 Python FastAPI :9999 (OpenCV)
- *坐标:统一左上角原点(X 右增、Y 下增),全链路不翻转 Y- **第一*支持位图PDF;DWG 矢量解析为后续扩展(见技术方案)
relitu-wall/
├── cv-service/ # Python FastAPI + OpenCV 识别微服务(核心 ├── main.py # /healthdetect
├── detector/ # loader/preprocess/lines/thickness/classify/pipeline
└── requirements.txt
├── backend/ # Spring Boot 编排服务(上传、转发、托管前端)
└── src/main/
├── java/com/relitu/wall/ # controller/service/client/dto
└── resources/
├── application.yml # cv-service.url
└── static/ # 前端 index.html / app.js / style.css
└── resource/ # 测试样例(jpg / pdf / dwg```
## 运行
### 1. 启动 Python 识别服务(端9999
```bash
cd cv-service
pip install -r requirements.txt
python -m uvicorn main:app --host 127.0.0.1 --port 9999
cd backend
mvn spring-boot:run浏览器打开 http://localhost:8888,选择 resource/66b079ee831497613998fa18.jpg
PDF,点击「识别墙体」,即可看到墙体叠加(红=外墙、蓝=内墙),并可下载 JSON
| 服务 | 方法/路径 | 说明 |
|---|---|---|
| 后端 | POST /api/walls/detect |
multipart:file、可minLineLength;返回墙JSON |
| 识别 | POST /detect |
Python 直连,字段同上(min_line_length |
| 识别 | GET /health |
存活探针 |
{
"walls": [
{ "id": "wall_1", "type": "outer_wall",
"start": {"x": 100, "y": 200}, "end": {"x": 500, "y": 200}, "thickness": 10 }
],
"image_width": 800,
"image_height": 600
}type 取值:outer_wall(外墙)/ inner_wall(内墙)
CAD 矢量图走独立detector/vector.py 管线:ezdxf 解析墙图层几碎段合并 双线配对求中心线与厚内外墙分类。坐标更精确,是 CAD 线稿类图纸的推荐路线
- DXF:开箱即用,无需任何外部依赖- DWG(闭源二进制):需转换器把 DWG DXF。本项目内置 LibreDWG
(
cv-service/vendor/libredwg/dwg2dxf.exe,GPL)。find_converter()自动探测顺序 环境变量WALL_DWG_CONVERTERPATH 中的dwg2dxf/ODAFileConverter内置vendor/缺转换器DWG 请求返回明确提示,位PDF/DXF 不受影响
vendor/为空,从 LibreDWG 官方发布页下win64 包解压到cv-service/vendor/libredwg/即可
| 文件 | 关键参数 | 作用 |
|---|---|---|
preprocess.py |
DARK_THRESHOLD |
墙线取暗阈值;图纸偏淡可调 |
preprocess.py |
LINE_DRAWING_MAX_COLORED_FRAC |
黑白线稿 vs 彩色图判别阈 |
preprocess.py |
LINE_LEN_DIVISOR / LINE_LEN_MIN |
线稿方向形态学最小线 |
preprocess.py |
MIN_WALL_THICKNESS |
彩色厚墙图实心墙最小厚 |
lines.py |
MIN_LINE_LENGTH / HOUGH_THRESHOLD |
线段最小长度与检测灵敏度 |
lines.py |
PERP_TOL / GAP_TOL |
同墙线段的合并容 |
classify.py |
BORDER_TOL |
外墙判定的贴边距 |
vector.py |
WALL_LAYER_KEYWORDS |
墙图层名关键字(可加项目专用图层 |
vector.py |
MAX_WALL_THICKNESS |
DWG/DXF 双线配对的间距上 |
完整技术方案见 doc/技术方md
- 矢量管线HATCH / SOLID 墙体填充的支持;单线墙厚度推断- 多页 PDF、识别结果人工编辑回传、参数面板、DWG 转换器容器化打包