用 Python 自动生成铁塔计算书与图纸——从参数输入到报告输出的全流程实践

作者：Eddy
日期：2026-09-03
项目：铁塔结构计算工具（tower-tool）

一、为什么做这个工具

在输电线路工程中，铁塔结构计算是一项高频且重复的工作。传统流程是：工程师根据设计参数（抗风级别、塔高、塔型、导线型号等），手动查规范表格、套公式、写计算书、画图纸。整个过程耗时且容易出错——一个参数改了，后面所有计算和文档都要跟着改。

这个工具的目标很简单：输入参数，一键输出计算书（Word）+ 图纸（PNG）。把重复劳动交给程序，让工程师专注于方案决策。

二、技术路线

2.1 整体架构

用户输入参数（命令行）
        │
        ▼
   main.py（入口/参数解析）
        │
        ├──► tower_calc.py（计算模块）
        │       ├── 风荷载计算（GB 50009）
        │       ├── 导线荷载计算
        │       ├── 内力汇总（弯矩/剪力/轴力）
        │       ├── 主材选材与验算
        │       └── 基础验算与稳定性校核
        │
        ├──► tower_draw.py（绘图模块）
        │       ├── 立面图（塔身轮廓 + 节段标注）
        │       ├── 截面图（塔身横截面示意）
        │       └── 内力图（弯矩/剪力/轴力分布）
        │
        └──► report_gen.py（报告生成）
                └── python-docx 生成 Word 计算书

2.2 技术选型

为什么不用有限元？ 铁塔初设阶段的计算，规范给的就是简化公式（等效静风荷载法）。上有限元是施工图阶段的事，初设阶段用规范公式更快、更可审计，也更容易让审查人员理解。

2.3 核心计算逻辑

计算遵循以下规范链：

1. GB 50009-2012《建筑结构荷载规范》——风压基本值、风压高度变化系数
2. GB 50545-2010《110kV~750kV架空输电线路施工及验收规范》——导线风荷载
3. DL/T 5154-2012《架空输电线路杆塔结构设计技术规定》——杆塔内力与构件验算

关键公式（以风荷载为例）：

基本风压:  w₀ = 0.5 × ρ × v₀²
设计风速:  v₀ = f(抗风级别)  # 8级→20.7 m/s, 10级→28.4 m/s, 12级→36.9 m/s
高度系数:  μz = (z/10)^α    # α取决于地形类别 A/B/C/D
塔身风荷:  w = βz × μs × μz × w₀ × A  # βz风振系数, μs体型系数, A迎风面积

程序里每个公式都写了注释标注出处，方便审查时溯源。

三、实战经验

3.1 参数设计——用枚举约束输入

一开始我把抗风级别做成自由输入的整数，结果测试时传了个 15 进去，程序算出了 52 m/s 的风速——蒲福风级表只到 17 级，15 级对应 46.1 m/s，但工程上没有这么设计铁塔的。

教训：工程参数必须用枚举或范围约束。 后来改成 argparse 的 choices 参数：

parser.add_argument('--wind-level', type=int, choices=[6,7,8,9,10,11,12], default=8)
parser.add_argument('--material', choices=['Q235','Q345','Q390','Q420'], default='Q345')

这样用户传错参数时，argparse 直接报错，不会进入计算流程产生荒谬结果。

3.2 绘图——matplotlib 的工程图技巧

工程图纸和科研绘图风格不同，有几个细节：

1. 去掉顶部和右侧边框：工程图只保留左和下坐标轴
2. 标注用引出线：不能直接把文字贴在图形上，要用 annotate + arrowprops 画引出线
3. 等比例显示：铁塔立面图 X 和 Y 轴比例不能失真，必须 ax.set_aspect('equal')
4. 尺寸标注：在塔身两侧标注节段高度，用双箭头线 + 文字

ax.set_aspect('equal')
ax.spines['top'].set_visible(False)
ax.spines['right'].set_visible(False)

3.3 Word 报告——python-docx 的排版要点

生成工程计算书，排版有几个关键点：

• 表格要加边框：python-docx 默认表格没有边框，需要手动设置 XML 属性
• 公式用等宽字体：计算公式段落用 Consolas 字体，避免中文混排时符号错位
• 验算结论用颜色标记：通过用绿色，不通过用红色，一眼可见

from docx.shared import RGBColor
if result.passed:
    run.font.color.rgb = RGBColor(0x00, 0x80, 0x00)  # 绿色
else:
    run.font.color.rgb = RGBColor(0xFF, 0x00, 0x00)  # 红色

3.4 交互模式——让非技术用户也能用

命令行参数对工程师来说够用，但有些人不熟悉终端。所以加了一个 -i 交互模式，逐步提问引导输入：

if args.interactive:
    wind_level = int(input("请输入抗风级别(6-12): "))
    height = float(input("请输入塔高(m): "))
    ...

四、存在问题与优化空间

4.1 当前局限

4.2 优化方向

1. 多工况组合：按规范要求实现风+冰、风+断线、安装工况等组合，取最不利包络
2. 敏感性分析模块：给定参数范围，自动扫描输出"塔高-主材规格"对照表，辅助方案比选
3. Web 化界面：用 Flask/Streamlit 包一层，浏览器里填表单、看结果，降低使用门槛
4. 与 BIM 对接：输出 IFC 格式，直接导入 Revit/ Bentley OBM 做施工图深化
5. 计算书模板化：用 python-docx 的模板功能，让用户自定义计算书格式和单位标识

4.3 代码质量改进

• 单元测试：目前没有 pytest 测试用例，计算逻辑的正确性靠手动验证。应该对每个公式写断言测试，用规范例题验证
• 类型标注：Python 3.9+ 支持类型标注，加上 mypy 静态检查能提前发现参数类型错误
• 日志替代 print：当前用 print 输出进度，应该改用 logging，支持不同级别和文件输出

五、技术心得

5.1 "公式透明"比"计算精确"更重要

工程计算软件最大的风险不是算得不准，而是算对了但你不知道它怎么算的。审查人员要看的是每一步公式的出处和中间过程。所以这个工具的设计原则是：

每一行计算代码旁边都有规范条文注释，计算书里完整列出中间过程。

宁可输出冗长，也不能省略中间步骤。工程师的信任来自于可审计，而不是"软件算的应该没问题"。

5.2 参数化设计的核心是"约束"

做参数化工具，最容易犯的错是"什么参数都让用户填"。实际上：

• 能从规范查表得到的，不要让用户填（比如风压高度变化系数，只需要地形类别和高度）
• 能从其他参数推导的，不要让用户填（比如导线单位长度重量，从导线型号就能查到）
• 有合理默认值的，给默认值（比如安全等级，大多数线路用二级）

用户填的参数越少，出错概率越低。

5.3 Python 做工程计算的优势与边界

优势：

• 公式表达直观，读代码就像读公式
• 生态丰富（numpy/scipy/matplotlib/python-docx），从计算到出报告一条龙
• 迭代快，改一个公式重新跑就行

边界：

• 性能敏感场景（大型有限元、千万级网格）不适合，那是 C++/Fortran 的领域
• 需要严格类型安全的高可靠性场景，Python 的动态类型是隐患
• 但对于初设阶段的规范公式计算，Python 是完全够用的

六、总结

这个工具用约 800 行 Python 代码，实现了从参数输入到计算书+图纸输出的全流程自动化。核心价值不在于计算精度（规范公式的精度是固定的），而在于：

1. 消除重复劳动——改一个参数，3 秒出全套文档
2. 保证计算一致性——同一套公式，不会因为手算漏项而出错
3. 可审计——每步计算有出处，计算书可直接用于设计审查

下一步计划加入多工况组合和敏感性分析，让它从"初设辅助工具"进化为"方案比选工具"。

本文为原创技术分享，代码开源于 GitCode。