简介面向要在 Abaqus 6.14 中通过 Python 扩展 CAE 功能的工程师这套插件集合覆盖了节点显示、视口最值查看、颜色拾取、模型合并等常用操作。所有插件遵循统一结构每个插件由以 DB.py 结尾的业务逻辑文件和以 _plugin.py 结尾的 GUI 注册文件组成公共函数抽离在 myPluginFunctions.py 中并提供注释说明执行流程适合作为编写自定义插件的参考模板。压缩包共 26 个文件包含 12 个 py 源码、12 个 pyc 编译文件、许可证和 README 说明打包后仅 33KB轻量易读。至今已有 725 人学习下载无论是想直接复用这些工具还是学习 Abaqus 插件框架与 Python 脚本组织方式都能从中获得完整可运行的示例和清晰的目录结构。1. 从“重复点二十次鼠标”说起Abaqus 6.14 里的插件与 Python 分工用过 Abaqus 6.14 的人多半有过这种经历一个模型要建五六十种材料每种都进 Edit Material 填弹性模量、泊松比和密度或者从别处导入的 orphan 网格里藏着几个没连上单元的悬空节点只能靠眼睛在视口里慢慢找。Abaqus/CAE 从 6.x 开始就把每次界面操作翻译成一条 Python 命令写进 .rpy 回放文件插件机制做的就是把这串命令再包一层给它一个对话框、一个菜单项、一组参数。换句话说Abaqus 6.14 的插件就是一段有入口、有参数、有返回值的 Python 程序只是它同时活在 GUI 进程和内核进程两个世界里。下面按实际做插件的顺序讲先拆三层文件结构再用 RSG 生成第一个能跑的插件接着手工补参数和排错最后给几个能直接改来用的落地场景。2. 插件是“三层皮”Abaqus/CAE 里内核脚本、注册文件与 GUI 对话框怎么连起来2.1 内核插件、GUI 插件与宏先分清三种形态在 6.14 里凡是能在 Plug-ins 菜单下出现的功能底层都离不开几种文件的组合很多人一开始就把它们混为一谈。宏Macro最简单在 CAE 里把操作录一遍保存成 .py 脚本下次 File Run Script 重放。宏适合一次性复现参数全部写死改动一个小数点就要重新录一遍几乎不具备复用性。内核插件Kernel Plug-in是一段纯 Python 模块里面是普通函数操作 mdb、session、odb 这些对象它没有界面放进 abaqus_plugins 目录后可以在 CAE 命令行里 import 调用也可以被 GUI 插件加载。GUI 插件GUI Plug-in才是菜单里那个“插件”本体注册文件把按钮挂到菜单上对话框模块收集参数内核模块负责真正干活。三种形态没有高低之分选哪个取决于使用频次和使用的人。给不写脚本的同事用的必须做 GUI 插件只服务于自己批量改模型的内核插件加命令行调用反而更快宏基本只在录临时操作时用。下面这张表我贴在工位旁边写插件前先对一遍形态文件组成有没有对话框适合场景宏.rpy 或另存脚本无一次性回放、给同事演示操作步骤内核插件任意 .py 模块无批量建材料、改网格、后处理统计GUI 插件xxx_plugin.py xxxDB.py 内核模块有给不写脚本的人用的反复性任务最常见的错是想把一个纯函数脚本变成菜单项就把它直接丢进 abaqus_plugins结果菜单没出现——因为纯 .py 只是内核插件菜单项必须由带注册逻辑的 GUI 插件挂上去。2.2 启动扫描顺序与 registerGuiMenuButton插件菜单是怎么出现的6.14 的 CAE 启动时会按固定顺序扫描若干位置的 abaqus_plugins 目录包括启动时的当前工作目录、用户主目录以及 Abaqus 安装目录下的 site 目录。我习惯把插件放在 site 下的 abaqus_plugins 里这样无论从哪里启动 CAE 都能加载放在当前工作目录则依赖启动位置别人双击工程文件起 CAE 时经常找不到插件。扫描的核心动作是逐个 import 目录里以 _plugin.py 结尾的模块import 的副作用是把按钮注册进插件工具集# plateGen_plugin.py —— 注册文件 from abaqusGui import * from plateGenDB import PlateGenDB toolset getAFXApp().getAFXMainWindow().getPluginToolset() toolset.registerGuiMenuButton( buttonTextPlate Generator, objectPlateGenDB(toolset), messageIdAFXMode.ID_ACTIVATE, iconNone, kernelInitStringimport plateGenKernel )这段代码是 GUI 插件唯一必须写对的东西。buttonText 是菜单上显示的名字object 是对话框对象的实例点击菜单时 CAE 用它弹出对话框messageId 固定用 AFXMode.ID_ACTIVATE含义是“点击后激活这个应用级对话框”icon 传 None 则用默认图标想自定义可以指一个 PNG 路径但我建议初期先不传少一类图标加载报错kernelInitString 是最关键的一行——它是一个 import 语句的字符串第一次打开插件时被发送到内核进程执行等于把干活的模块提前加载进内核命名空间。注册文件 import 阶段如果抛异常菜单会静默消失这就是“按钮点了没反应”最常见的根源。2.3 参数通道kernelInitString、getCommand 与 tgt/sel6.14 的 CAE 是双进程结构GUI 进程负责对话框和视图内核进程里才有 mdb、session。两个进程之间传的是 Python 语句字符串这决定了插件设计的第一条原则GUI 模块里不要直接去拿内核对象只能通过命令字符串让内核执行。对话框拿到用户输入的值靠的是 AFX 控件上的 tgt 和 sel 两个参数。tgt 是目标对象sel 是目标对象上的属性槽位控件值一变系统就把新值写进对应属性。点 OK 时RSG 生成的代码把属性收集起来拼成一次内核调用语句。另一条路径是 getCommand给控件直接附加一句 Python 代码值变化时这行代码立即在内核里执行。我一般只在小插件里用 getCommand复杂场景统一走 RSG 的关键字映射因为映射生成的代码更容易排错也更容易在 .rpy 回放文件里看到当时的参数值。提示手工写对话框时tgt 必须传对象不是传值。把 tgt 写成普通变量是最常见的低级错误症状是点 OK 后内核拿到的一直是默认值。3. 用 RSG 生成第一个插件Python 内核函数与表单字段映射3.1 先写内核函数从 CSV 批量建材料任何插件都先从内核函数开始写因为内核函数可以脱离界面独立测试直接在 abaqus cae noGUI 下跑。以最常见的需求为例从一张 CSV 里批量建材料字段是 name、E、nu、rho。这个函数在 CAE 命令行里也能直接调用所以先保证它本身是对的# materialLibKernel.py import csv from abaqus import mdb def create_materials_from_csv(model_name, csv_path): 从 CSV 批量创建材料返回本次创建的材料名列表。 model mdb.models[model_name] created [] with open(csv_path, r) as f: reader csv.DictReader(f) for row in reader: name row[name].strip() if name in model.materials: print skip existing material:, name continue mat model.Material(namename) mat.Elastic(table((float(row[E]), float(row[nu])),)) mat.Density(table((float(row[rho]),),)) created.append(name) return created这段代码有三个值得注意的地方。第一mdb.models 是仓库对象Material(name...) 创建后立即出现在模型树的 Materials 分组下不需要额外提交。第二Elastic 和 Density 的 table 参数都是元组的元组Elastic 每行是 (E, nu)Density 每行是 (rho,)内层那个逗号不能省——写成 ((rho,),) 才是“一行一个值”漏掉逗号 Python 会把元组展平API 直接报参数数量错误。第三所有数值都用 float() 显式转换CSV 里 Excel 导出的数字经常是字符串或科学计数法直接塞进 table 会得到类型错误或者更糟——数值被静默拼接成错误数据。写完后先用一个三行的小 CSV 在 CAE 命令行里验证一次确认路径和表头都对再做 GUI。这个过程很快但它能过滤掉一半以上的后续问题。3.2 RSG 面板里的字段映射文本、浮点、文件选择怎么对应参数6.14 内置的 Really Simple GUI 可以把上面这个函数变成带对话框的插件全程不用手写 GUI 代码。菜单路径是 Plug-ins Abaqus Really Simple GUI。打开 RSG 后分两步。第一步在 Kernel 页Kernel Script File 选 materialLibKernel.pyModule Name 填 materialLibKernelFunction Name 选 create_materials_from_csv。第二步在 Dialog 页按函数参数顺序加字段先加 model_name 用 Text 类型再加 csv_path 用 File 类型并把文件过滤器设为 *.csv。字段从上到下的顺序就是传给内核函数的位置参数顺序顺序比字段名更关键加反了参数就串位。RSG 字段类型对话框控件传给内核的类型典型用法Integer整型输入框int单元阶次、切割层数、重复次数Float浮点输入框float尺寸、密度、温度、热流密度Text单行文本框str模型名、材料名前缀、注释Boolean复选框bool是否覆盖同名材料、是否写日志File文件选择框str路径CSV、INP、材料库文件Menu下拉菜单str选项文本单元类型、分析类型、单位制字段加完后RSG 会让你指定保存目录。把它指到 site/abaqus_plugins 下的新文件夹例如 materialLib/RSG 会生成 materialLib_plugin.py 和 materialLibDB.py 两个文件。重启 CAEPlug-ins 菜单下就出现菜单项。注意 6.14 的 RSG 生成的是 Python 2 语法生成的代码不要拿去 Python 3 解释器里跑否则光 print 语法就要改一遍。3.3 生成之后改哪几个文件_plugin.py 与 DB 的分工RSG 生成的 materialLib_plugin.py 和上一章的注册示例几乎一样换了个名字而已日常基本不动。materialLibDB.py 里有两个类一个继承 AFXGuiApplication负责保存字段值和关键字映射另一个继承 AFXDataDialog负责摆放控件。日常改动集中在两处给字段加默认值以及在 OK 之前加校验。校验可以写在对话框类里对必填字段判空、对浮点字段判范围但业务校验不要只在 GUI 里做内核函数里同样要判一次——因为这个函数很可能被同事从命令行直接调用。# materialLibDB.pyRSG 生成后手工改的部分 class MaterialLibDB(AFXGuiApplication): def __init__(self, owner): AFXGuiApplication.__init__(self, owner, MaterialLib) self.model_name Model-1 self.csv_path # 关键字映射在这里由 RSG 维护不要手动删 class MaterialLibDBForm(AFXDataDialog): def __init__(self, owner): AFXDataDialog.__init__(self, owner, Batch Materials, OKTrue, CANCELTrue) # 控件布局由 RSG 生成要改默认值就改 owner 上的属性这里只贴骨架控件布局请直接读 RSG 生成的文件那是最可靠的参照。你需要记住的只有一件事对话框对象的属性就是最终提交给内核的参数改默认值、改提示文本都在这个文件里完成注册文件不要动。4. 手写插件必调的参数与 Python 2.7 的四个坑4.1 一个手工插件的最小文件树与注册代码RSG 能覆盖八成简单表单但遇到多行表格、联动下拉、动态增删行时还是要手写。手工 GUI 插件的最小文件树如下三个文件各司其职多一个都不要site/abaqus_plugins/ └── weldParam/ ├── weldParam_plugin.py # 注册菜单按钮 ├── weldParamDB.py # 对话框与字段 └── weldKernel.py # 内核函数注册文件只做一件事import DB 类并注册菜单按钮代码就是 2.2 节那段。内核文件里只有函数不 import 任何 GUI 模块这样才能在 noGUI 和命令行里复用。DB 文件里 import abaqusGui 和 kernelAccess但不要在 DB 模块顶层执行 mdb 操作——那会在 GUI 进程里运行绝大多数情况会报模块不存在。下面是一个手工对话框的骨架# weldParamDB.py —— 手工版骨架 from abaqusConstants import * from abaqusGui import * from kernelAccess import mdb, session class WeldParamDB(AFXGuiApplication): def __init__(self, owner): AFXGuiApplication.__init__(self, owner, WeldParam) self.radius 5.0 # 热源半径 self.speed 2.0 # 焊接速度 self.power 1000.0 # 热源功率 def getFirstDialog(self): return WeldParamForm(self) class WeldParamForm(AFXDataDialog): def __init__(self, owner): AFXDataDialog.__init__(self, owner, Welding Parameters, OKTrue, CANCELTrue) # 控件签名以 RSG 生成版为准这里只示意 tgt/sel 的绑定关系 self.radiusField AFXFloatField(self, 10, Radius mm:, owner.radius, tgtowner, sel0)注意 tgtowner, sel0 的含义用户输入的值会写回 owner 的第 0 个属性也就是 radius。字段多起来之后sel 必须按属性声明顺序递增手工维护很容易对错这也是我建议先让 RSG 生成、再在生成的骨架上改的原因。控件构造方法的具体参数顺序同样以 RSG 生成版本为准别盲目照抄网上旧博客里的写法。4.2 类型、单位与数组GUI 传参最容易翻车的四个地方把最容易踩的坑列成一张表按出现频率排序症状真正原因处理方式点 OK 无反应或参数全是初值tgt/sel 没绑对值没写回 owner对照 RSG 生成代码检查 sel 索引字符串型数字进了 tableCSV 或文本框没转 float内核里统一 float() 再构造 table模型名带空格或点报错用属性访问 mdb.models.Model-1一律用 mdb.models[Model-1] 字典索引除法结果不对Python 2.7 里/是整除内核文件头部加 fromfutureimport division单位问题不在表里因为它不出报错只出错误结果。6.14 的 CAE 没有单位系统填 100 到底代表毫米还是米完全由使用者约定。插件里我一般把单位制写成模块级常量例如 LENGTH_UNITmm、FORCE_UNITN在内核函数入口统一换算成分析所用单位制避免不同模型的旧数据混进来。数组参数是另一个高频雷区GUI 里拿到的坐标常常是 list而 Abaqus 很多 API 严格要求 tuple例如坐标点、方向向量。我的习惯是在内核函数的边界统一转换point (float(x), float(y), float(z))绝不把 GUI 给的原样 list 直接传进 API。4.3 按钮灰色、报错和“中断不了”启动日志与任务终止插件最常见的失败不是代码崩溃而是按钮点了没反应或者菜单里根本没有。6.14 在 Windows 上默认把 Python 异常吞掉只往启动控制台打几行所以排查第一步永远是从系统终端启动 abaqus cae而不是双击桌面图标这样 traceback 会直接打在终端里。第二个办法是给内核函数包一层 try/except 写日志文件现场反馈问题的时候日志比对话记录可靠得多import traceback def safe_create_materials(model_name, csv_path, log_path): try: return create_materials_from_csv(model_name, csv_path) except Exception: with open(log_path, a) as f: f.write(traceback.format_exc()) raise把 log_path 指到本地固定位置插件挂在同事机器上时这条日志就是唯一的现场证据。与插件经常同时出现的还有两个环境级问题。第一个是 libpng error6.14 在较新的 Linux 发行版上经常报 libpng 版本不兼容这是系统 libpng 与 CAE 自带 GUI 库的矛盾发生在插件加载之前排查时先确认干净环境能否启动 CAE别一上来查插件代码。第二个是“中断不了”插件里启动的分析在 CAE 里点 Interrupt 没反应是 6.14 的作业监控线程偶尔收不到中断信号不等于插件死了另开终端执行 abaqus terminate jobjobname还不行就按 PID 结束 standard/explicit 进程。重型计算不要放在 GUI 点击后同步执行写成 noGUI 脚本CAE 只负责提交和监控。5. 三类 Abaqus 实用插件孤立节点、cohesive/voronoi 与焊接热源5.1 网格健康检查找出没连到单元上的节点孤立节点是导入网格的老大难问题求解器会警告极端情况下影响接触定义。CAE 的查询工具面对几十万节点等于没有一个内核函数就能解决。思路是先建立节点 label 到单元的索引再反查没有出现在任何单元里的节点# meshCheckKernel.py from abaqus import mdb def find_orphan_nodes(model_name, part_name): 返回没有被任何单元引用的节点列表 [(label, (x, y, z)), ...]。 part mdb.models[model_name].parts[part_name] connected set() for elem in part.elements: for node in elem.getNodes(): connected.add(node.label) return [(n.label, tuple(n.coordinates)) for n in part.nodes if n.label not in connected] def report_orphan_nodes(model_name, part_name, report_file): orphan find_orphan_nodes(model_name, part_name) with open(report_file, w) as f: f.write(label,x,y,z\n) for label, (x, y, z) in orphan: f.write(%d,%g,%g,%g\n % (label, x, y, z)) return len(orphan)connected 集合统计所有被单元引用的节点 label第二步遍历 part.nodes 做集合判断整体是 O(n) 复杂度百万节点的网格也能秒级完成。注意两个边界条件一是 part 必须先有网格原生 part 在 seed 和 generateMesh 之前 nodes 是空的函数会把所有节点都当成孤立二是只被 MPC 或参考点引用、没被单元引用的节点这里同样判为孤立需要人工确认。网上常见的 getElemFaces 判空写法对六面体和四面体有效但遇到 truss、beam 这类没有面的单元会误报按 element 索引节点更通用。5.2 cohesive/voronoi 建模生成器为什么这类需求天然适合插件cohesive 和 voronoi 是 6.14 时代搜索量很高的两个建模词原因是 CAE 没有一键生成多晶 Voronoi 或自动插 cohesive 层的功能而这两件事恰恰是断裂和晶界模拟的标准前处理。社区方案几乎都是 Python 写生成内核在二维区域撒种子做 Delaunay/Voronoi 划分再把每个胞转成 part 或网格。6.14 自带的 Python 2.7 里 numpy 可以 import随机撒点、矩阵运算都能做但默认没有 scipy别一上来就 from scipy.spatial import Voronoi那会在用户机器上直接 ImportError。我一般把 Voronoi 胞边界求交写在内核里GUI 只暴露种子数、区域尺寸、晶界厚度这几个参数# voronoiKernel.py —— 判断 scipy 是否可用的标准写法 def _scipy_available(): try: import scipy return True except ImportError: return False def build_voronoi_part(model_name, part_name, seed_count, size_x, size_y): if not _scipy_available(): raise RuntimeError(6.14 默认没有 scipy请改用内置 numpy 算法或替换生成内核) # 实际的 Delaunay/Voronoi 划分在这里实现 passcohesive 层插入比 Voronoi 更依赖网格拓扑要在单元边界上找对应面、偏移生成 0 厚度或有限厚度单元、重编号防止单元畸变每一步都可能因为单元类型不同而失败。这种插件的内核必须按单元类型分支六面体和四面体各写一套别试图通杀GUI 里加一个 elementType 下拉菜单把选择权交给用户比自动判断可靠。5.3 焊接仿真插件把 DFLUX 参数变成表单并生成子程序焊接仿真的移动热源需要 DFLUX 用户子程序描述热流密度随时间和位置的变化参数无非热源半径、功率、焊接速度、起始坐标。这类插件最实用的形态不是建模而是把参数表变成对话框点 OK 生成一个完整的 .for 文件再拼出提交命令。子程序本体就是一段带占位符的模板字符串# weldKernel.py —— 由表单参数生成 DFLUX 子程序文件 DFLUX_TEMPLATE SUBROUTINE DFLUX(FLUX,SOL,KSTEP,KINC,TIME,NOEL,NPT,COORDS, 1 JLTYP,TEMP,PRESS,SNAME) INCLUDE ABA_PARAM.INC DIMENSION COORDS(3),TIME(2),FLUX(2) REAL RADIUS, POWER, SPEED RADIUS {radius} POWER {power} SPEED {speed} ... 移动热源热流表达式 ... RETURN END def write_dflux_subroutine(radius, power, speed, out_file): with open(out_file, w) as f: f.write(DFLUX_TEMPLATE.format( radiusradius, powerpower, speedspeed)) return out_file表单字段子程序变量典型单位RadiusRADIUSmmPowerPOWERWSpeedSPEEDmm/sStart coordsX0/Y0/Z0mm模板字符串里的 Fortran 语句要当成一等代码对待INCLUDE 路径、续行符、变量类型声明都不能省因为生成的 .for 不经过 Abaqus 内核校验格式问题要到编译阶段才暴露。6.14 编译用户子程序依赖本机 Fortran 编译器Windows 上一般是 Intel Visual Fortran机器上没有编译器时提交后 .dat 或 .msg 会报无法编译这是环境问题不是插件问题。生成后通常在系统终端里执行abaqus jobweld userweld.for cpus8 interactive能用多核就跑多核。GPU 加速在 6.14 里可以写成 abaqus jobxxx cpus8 gpus1 的形式前提是显卡在 Abaqus 官方支持列表里带 user subroutine 的任务我默认不开 GPU先把 cpus 用好避免两个加速路径互相干扰。6. 验证与分发让 Abaqus 6.14 插件在同事机器上也能跑GUI 只能证明按钮能弹出来证明不了函数算得对。我习惯给每个插件配一个回归脚本用 abaqus cae noGUI 跑把已知答案写进断言abaqus cae noGUImeshCheck_regress.py# meshCheck_regress.py —— 不启动界面的回归测试 from meshCheckKernel import find_orphan_nodes count len(find_orphan_nodes(Model-1, Part-1)) # 已知网格里有 3 个孤立节点 assert count 3, unexpected orphan count: %d % count print meshCheck regression PASS回归脚本放在插件目录外避免 CAE 扫描 abaqus_plugins 时把它当插件加载。每次改内核就重跑一次如果只改了 GUI不动内核逻辑则用 .rpy 回放验证对话框流程。CAE 会把插件操作完整记录成脚本复现报错时把 .rpy 末尾的调用序列贴出来比截图精确。内核回归保证算法对.rpy 回放保证对话框到内核的接线没断两条腿走路。分发时把整个 site/abaqus_plugins/插件名 目录拷给对方放在同样路径下即可。只要插件只依赖 mdb、session 这些标准对象没有绑定本机绝对路径拷贝过去就能用。要注意 6.14 插件是 Python 2 语法从 2020 版开始 Abaqus 内核切到 Python 3同一份代码直接搬过去大概率在 print、dict.keys() 这些地方报错迁移前先做一遍语法扫描再逐项改 print 语句、xrange 和除法。最后留一个让现场排错省力的习惯每个功能入口打印一行带版本的日志例如 [MaterialLib v1.2] start import csv...用户反馈问题时日志第一行就能确认他跑的是不是最新版。版本号只维护在内核模块顶部的一个常量里GUI 不重复保存。本文还有配套的精品资源点击获取