工程力学与仿真 / 系统课时
用 Gmsh 生成结构实体网格
用 Gmsh 生成结构实体网格
以 120×30×10 mm 的矩形受拉试件为例,用 Gmsh 4.15.2 生成四面体网格,将左端约束面、右端载荷面及其余边界分别定义为物理组。最后导出带体单元和边界单元的 plate.msh,保存两端面节点清单。
学习目标
- 区分三维实体、二维边界面与物理组的作用。
- 使用 Gmsh Python API 控制网格尺寸并导出 MSH 4.1 文件。
- 核验约束面、载荷面和实体网格能被分别识别。
定义几何与物理组
本例沿 轴受拉:左端 mm 固定,右端 mm 施加载荷;宽度沿 轴为 30 mm,厚度沿 轴为 10 mm。初始目标网格尺寸设为 5 mm,全部几何坐标都采用毫米。
| 物理组 | 维度 / 编号 | 区域及用途 |
|---|---|---|
FIXED |
2 / 101 | 左端面,位移约束 |
LOAD |
2 / 102 | 右端面,施加载荷 |
FREE |
2 / 103 | 其余四个表面 |
SOLID |
3 / 201 | 整个体积,赋予材料 |
几何实体是一张独立的面或一个体;物理组则把这些实体关联到求解条件。SOLID 中的四面体承担三维结构计算,FIXED 和 LOAD 中的三角形只用于标记边界,不应再作为壳单元重复参与刚度组装。

使用 Python API 生成网格
准备 Python 3.10 或更新版本,运行 python -m pip install gmsh==4.15.2。将以下完整程序保存为 mesh_plate.py,再执行 python mesh_plate.py。使用面心的 坐标识别端面,而不是硬编码可能因几何修改而变化的 CAD 面标签。
import csv
import gmsh
length, width, thickness, h = 120.0, 30.0, 10.0, 5.0
gmsh.initialize()
gmsh.option.setNumber("General.Terminal", 0)
try:
gmsh.model.add("plate")
volume = gmsh.model.occ.addBox(0, 0, 0, length, width, thickness)
gmsh.model.occ.synchronize()
faces = [tag for _, tag in gmsh.model.getEntities(2)]
# 通过几何位置识别两端面,避免依赖不稳定的面编号
def end_face(x):
found = [
tag for tag in faces
if abs(gmsh.model.occ.getCenterOfMass(2, tag)[0] - x) < 1e-7
]
if len(found) != 1:
raise ValueError(f"x={x}: expected 1 face, got {len(found)}")
return found[0]
fixed, loaded = end_face(0.0), end_face(length)
free_faces = [tag for tag in faces if tag not in (fixed, loaded)]
assert len(free_faces) == 4
# 边界用二维物理组,材料域用三维物理组
for dim, entities, phys_id, name in (
(2, [fixed], 101, "FIXED"),
(2, [loaded], 102, "LOAD"),
(2, free_faces, 103, "FREE"),
(3, [volume], 201, "SOLID"),
):
gmsh.model.addPhysicalGroup(dim, entities, phys_id, name)
gmsh.model.mesh.setSize(gmsh.model.getEntities(0), h)
gmsh.option.setNumber("Mesh.MeshSizeMin", h)
gmsh.option.setNumber("Mesh.MeshSizeMax", h)
gmsh.option.setNumber("Mesh.MshFileVersion", 4.1)
gmsh.model.mesh.generate(3)
gmsh.write("plate.msh")
# 核验物理组中确实存在节点和对应维度的单元
for dim, phys_id, name in (
(2, 101, "FIXED"), (2, 102, "LOAD"),
(2, 103, "FREE"), (3, 201, "SOLID"),
):
entities = gmsh.model.getEntitiesForPhysicalGroup(dim, phys_id)
nodes, _ = gmsh.model.mesh.getNodesForPhysicalGroup(dim, phys_id)
count = sum(
sum(len(tags) for tags in gmsh.model.mesh.getElements(dim, int(entity))[1])
for entity in entities
)
assert len(nodes) > 0 and count > 0, f"{name} has no mesh"
print(f"{name}: dim={dim}, entities={len(entities)}, nodes>0, elements>0")
# 将两端面的节点编号与坐标另存,便于后续施加节点约束
for phys_id, filename in (
(101, "fixed_nodes.csv"), (102, "load_nodes.csv"),
):
node_ids, xyz = gmsh.model.mesh.getNodesForPhysicalGroup(2, phys_id)
with open(filename, "w", newline="", encoding="utf-8") as file:
writer = csv.writer(file)
writer.writerow(["node_id", "x_mm", "y_mm", "z_mm"])
for i, node_id in enumerate(node_ids):
writer.writerow([int(node_id), *map(float, xyz[3*i:3*i+3])])
print("files: plate.msh, fixed_nodes.csv, load_nodes.csv")
finally:
gmsh.finalize()预期输出(节点和单元的实际数量会随网格尺寸与 Gmsh 版本变化,因此程序只核验它们非空):
FIXED: dim=2, entities=1, nodes>0, elements>0
LOAD: dim=2, entities=1, nodes>0, elements>0
FREE: dim=2, entities=4, nodes>0, elements>0
SOLID: dim=3, entities=1, nodes>0, elements>0
files: plate.msh, fixed_nodes.csv, load_nodes.csv检查导出内容
用文本编辑器打开 plate.msh,确认 $PhysicalNames 段列出 FIXED、LOAD、FREE 和 SOLID 四个组;$Elements 段同时包含二维三角形与三维四面体。fixed_nodes.csv 的所有节点应满足 mm,load_nodes.csv 应满足 mm,允许约 mm 的浮点误差。两个 CSV 的节点编号应与同一次生成的 MSH 文件对应,网格重建后必须一起更新。
可以在 Gmsh 中打开 plate.msh 观察外表面三角形与整体外形。只有成功生成三维单元才算完成实体划分;单独生成二维表面网格并不能用于三维实体静力求解。物理组是求解器识别载荷区域的依据,不能仅凭颜色或坐标截图确认分组已经写入文件。
调整网格并处理导入问题
5 mm 是用于跑通文件链路的初始尺寸,10 mm 厚度只有约两个目标网格尺寸,不能据此认定弯曲应力已经收敛。需要计算应力或挠度时,将代码中的 h 改为 2.5 mm,再进一步减小,比较同一测点位移与远离尖角的应力;例如连续两级相对差异小于 5% 可作为初步筛选,正式验收阈值应由项目误差预算决定。
如果 SOLID 组没有体单元,应检查是否执行了 gmsh.model.mesh.generate(3);如果端面查找失败,先确认 occ.synchronize() 在实体建立之后、查询面之前执行。若求解器只接受旧版 MSH,可将 Mesh.MshFileVersion 改为 2.2 并重新运行,但必须再次检查物理组是否保留;特别不要为图省事启用 Mesh.SaveAll=1,它在部分格式下会破坏物理组的导出。最后,毫米建模与以米为基础单位的材料和载荷数据不能直接混用。