关于 fea
fea 是用于零件和装配体线性静力有限元分析的技能,面向需要初步评估应力与位移的工程工作。它使用 netgen 网格和 CalculiX 求解,并明确说明分析范围与限制。
主要功能
- 01从 STEP 或 XBF 模型建立分析
- 02配置约束、载荷、材料和网格
- 03求解应力与位移
- 04输出 JSON、图像和 VTU 结果
- 05分析接触装配体并比较设计变体
适用场景
- 01评估零件在力或压力下的响应
- 02检查装配体的受力与连接
- 03比较不同设计的应力和位移
- 04查看结果网格中的局部数值
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ earthtojake/ text-to-cad --skill fea安装后在 Claude Code 中输入/fea确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSEagents/openai.yamlreferences/linear-static.mdmaterials.mdstudy-file.md详细介绍
FEA:能否承受,以及会移动多少
本研究固定零件的部分面,对其他面施加载荷,并使用 CalculiX 在 netgen 生成的二次四面体网格上求解线弹性响应:计算力、压力、零件自重和恒定加速度作用下的应力与位移;材料为低于屈服强度的各向同性材料,夹具完全刚性,载荷不移动。装配体中,零件在接触处相互粘结。这是初步工程检查,并非认证;报告时请明确说明。此版本不支持振动、屈曲、热、流动、疲劳、冲击以及相互滑动的零件:请如实说明,不要把静态安全系数当作这些问题的答案。跌落或制动载荷可估算为恒定 g 载荷(体载荷)。
从任务入手
| 任务 | 从这里开始 | 参考 |
|---|---|---|
| 检查零件在载荷作用下的情况 | cad step solve part.step 会列出其面;编写研究文件,然后求解到一个文件夹中。 | 工作流、线性静力 |
| 检查装配体 | cad step solve assembly.step 会列出零件以及相互接触的零件对。 | 装配体 |
| 编写或编辑研究文件 | 一个 JSON 对象:先列夹具和载荷,再列材料、网格、裕度和检查项;装配体还需列出零件和连接。 | 研究文件 |
| 选择材料 | 使用模型自身的材料(求解模型或其 .xbf),或使用用户提供的 E、ν 和屈服强度。 | 材料 |
| 判断答案 | 查看 result.json 及其分析结果,并与手算估值对照。 | 分析结果、判断答案 |
| 回答摘要未涵盖的问题 | 使用 meshio 读取 result.vtu。 | 自行提出问题 |
| 比较设计变体 | 对每个变体使用相同的研究文件、映射面并保持网格尺寸一致。 | 比较变体 |
此技能用于研究零件,不用于建模。它会读取已保存的 .step 或 .xbf,或引擎通过其文档 ID 持有的模型(cad model solve <id>),并求解整个文档:若要单独研究装配体中的某个零件,请将其导出为独立文档。
设置
运行 cad 命令(如果它不在 PATH 中,则运行 ~/.local/bin/cad;Windows 上运行 cad.exe)。如果找不到该命令,请在沙箱外或授予权限后安装 text-to-cad:
curl -fsSL https://texttocad.dev/install.sh | sh
在 Windows 上,使用 PowerShell 运行:irm https://www.texttocad.dev/install.ps1 | iex。如果刚刚才添加 CAD 应用,它的服务可能仍在启动;请先重试,最长等待一分钟。cad doctor --check 会说明其他故障原因,但不会做任何更改;cad doctor 会修复它报告的问题。
研究是文档类型对应的 solve 操作:cad step solve、cad xbf solve、cad model solve。不带 --study 时,它会列出研究的设置,不写入任何内容;带上 --study 和 --out DIR 时,它会求解并将结果写入 DIR。它所需的两个工具都是 cad 命令首次遇到需要它们的研究时安装的集成,无需你另行安装;cad run 会提供一个同时调用 cad.step.solve 和读取零件的内核的脚本。
- netgen,网格划分器:
netgen集成(cad[netgen],约 11 MB)。netgen 仅为 macOS、Linux x86_64 和 Windows x86_64 提供该集成;在其他平台(包括 ARM 架构的 Linux)上,求解会拒绝运行并指出平台名称。 - CalculiX(
ccx),求解器:calculix集成(cad[calculix]:cad-ccx 包,各平台适用的 CalculiX 2.23,约 13 MB)。除非CAD_CCX指定其文件,否则绝不会运行用户自己的 CalculiX(版本 2.20 或更高)。它以无头模式、单线程方式在专用文件夹中运行,因此同一研究每次运行都会得到相同数值,且每个结果都会注明求解时使用的版本。cad run ccx ARGS会对你自己的输入文件运行同一个ccx。
单位固定为:mm、N、MPa(压力、模量和应力)、t/mm³(密度,钢材为 7.85e-9)以及 g(重力和加速度为 9.81 m/s²)。记录载荷前,请将每项载荷都换算成这些单位。
工作流
-
列出面。 研究使用引擎的引用来命名面,这些引用可由 CAD Viewer 复制;用户在其中选取的面会以
/work/bracket.step#bracket/face 17的形式传入,无需查找。cad step solve part.step不带研究时,这是设置操作,不会写入任何内容:先列出零件和相接的零件对,再逐行列出零件的每个面:引用、面积、中心、曲面类型,以及类似
plane, normal -Z, largest的提示。根据提示和中心位置,将用户的描述(“安装面”)匹配到引用;孔属于cylinder。如果文档包含多个零件,则在指定零件之前不会列出任何面:cad step solve assembly.step --occurrence post。面编号是已保存文档中的位置,因此如果零件经过编辑并重新写入,就应在重新运行研究前重新列出面。 -
编写研究(study-file.md):
{ "fixtures": [{"faces": ["bracket/face 17"], "type": "fixed"}], "loads": [{"faces": ["bracket/face 22"], "type": "force", "vector_N": [0, -500, 0]}] }fixed将面固定;roller允许面在自身平面内滑动,但不能离开平面(即无摩擦支撑或对称切面)。force表示作用于其所有面的总力;pressure的单位为 MPa,正值表示指向表面内部;gravity和acceleration使用以 g 为单位的vector_g,且不指定面,并且需要材料密度。margin是零件应满足的安全系数(默认值为 2,且至少为 1)。如果用户提供了挠度或刚度规格,checks会添加带用户限值的displacement检查;如果省略,则仅通过应力检查评估零件。首次运行时省略mesh。 -
求解到文件夹中。
cad step solve part.step --study study.json --out /tmp/bracket-load --json--out可以指定任意文件夹,包括临时文件夹;如果文件夹不存在,则会创建。用户需要保留文件时,请将其放在项目中。每项研究使用一个文件夹:求解只会替换该文件夹中属于自身的文件,不会触及其他内容;如果运行失败,之前的结果会保持不变。文件夹中包含:文件 用途 result.json答案,即 --json输出的内容。请先阅读此文件。stress.png、displacement.png以各字段着色的变形零件(蓝色较低,红色较高),变形按 deformation_scale放大,并附有标明字段、单位和范围的色条。它们可以显示载荷方向是否符合预期,以及哪些面受到约束。请向用户展示应力图。result.glb相同的着色表面,可用于任何 glTF 查看器或 cad viewerresult.vtu体积网格,其中角节点带有 displacement(mm)和von_mises(MPa)(参见你自己的问题)ccx.inp使用 --deck时生成:CalculiX 求解所用的输入文件(若有两次求解,则为较精细网格求解的输入),可在该文件夹中运行cad run ccx -i ccx如果引擎无法绘图(无显示器的 Linux 系统),则不会生成图片,并会在
solver_note中说明;其他所有内容仍会写入。结果是一次检查:包括
ok、findings(每项含有severity、code、message、location和hint)、written,以及measurements:给定的研究、材料、指定的面(named_faces)、摘要中的数值(max_von_mises_MPa和max_von_mises_at_mm、max_von_mises_gauss_MPa、yield_MPa、safety_factor、max_displacement_mm和max_displacement_at_mm、applied_force_N、reaction_force_N、deformation_scale、checks; 装配体的weakest_part和parts)、各约束的反作用力、mesh(尺寸、单元数、自由度、straightened、solver)、timings和refined(若运行中求解了两次,则包含首次求解的尺寸 和峰值)。不带--json时,同样的信息会逐行打印。- 当安全系数低于 3 时,程序会以更精细的网格(单元尺寸减半;对于大型模型,缩小幅度较小)重新划分网格并再次求解;写入的是较精细的结果 (网格)。
- 进度信息(
[fea] meshing ...)会输出到 stderr,不会写入结果;--verbose会在此处增加网格和求解的详细信息。 - 畸形的研究(包含未知键、面不属于该零件、载荷为零、载荷施加在受约束的面上,或没有约束)会在网格划分前被拒绝,并指出对应字段。若约束未能固定零件,或载荷未作用于零件,求解会拒绝处理;反作用力无法平衡施加载荷时也会拒绝处理。
- 如果某项发现属于错误,命令会以 1 退出(
"ok": false):零件发生屈服或未通过检查,但结果仍会照常写入;或者研究在求解前停止(not_connected),此时不会写入任何内容。警告不会改变退出码 0。无论哪种情况,都请阅读结果。
-
报告单位:von Mises 应力峰值及其附近的特征、安全系数及其对应的屈服强度(模型材料范围的下限)、最大位移及其位置、施加载荷与反作用力、网格尺寸,以及是否进行了更精细的重新求解;然后列出发现、模型假设,以及最可能改变答案的因素。请展示
stress.png,并说明变形已由deformation_scale放大。
你自己的问题
对于摘要未回答的问题(例如安装孔处的应力、沿边缘的下垂量、零件中应力超过某个值的部分有多少),请读取 result.vtu,而不是再次求解。
meshio 或 PyVista 可直接读取该文件(uv run --with meshio):
import meshio, numpy as np
mesh = meshio.read("/tmp/bracket-load/result.vtu")
xyz, stress = mesh.points, mesh.point_data["von_mises"] # mm, MPa
moved = np.linalg.norm(mesh.point_data["displacement"], axis=1) # mm
near = np.linalg.norm(xyz - [42, 12, 3], axis=1) < 5 # within 5 mm of a point
print(stress[near].max(), moved[xyz[:, 2] > 49].max())
其中包含四面体的角节点,包括零件内部和表面上的节点;报告的峰值也会计入边中点节点,因此可能略高于 VTU 自身的最大值。装配体的单元会记录所属零件(part,即摘要中 parts 的索引)。
装配体
由多个零件组成的文档会作为一个装配体求解:相接的零件会粘结成一个相容网格,每个零件保留自己的材料属性,其应力则依据各自的屈服强度进行评估。每个零件都必须通过粘结的相邻零件连接到一个固定零件。具体规则见 study-file.md。
设置(cad step solve assembly.step)会先打印每个零件(ref、名称、体积),再打印每对零件的关系:bonded 表示已粘结,并附上接触面积和间隙;not connected 表示未连接,但两者接近(间隙不超过 1 mm,且超出 contact_tolerance_mm);overlapping · N mm³ 表示实体有重叠体积,这种情况绝不会粘结。重叠深度不超过容差时,视为干涉(过盈配合或建模偏差):会列为 bonded,标注 interference N mm,并像间隙一样闭合。请结合设计检查列表:每个检测到的接头是否都符合实际情况?预期存在的接头是否有遗漏?默认检测容差为 0.1 mm;如果研究需要粘结间隙更大的零件,请根据打印出的间隙设置 contact_tolerance_mm。名称可能重复(两个零件都叫 bar):遇到这种情况时,请使用 ref(frame/bar.2)。
每个零件都使用其模型自身的材料属性进行求解;parts 可为零件指定用户提供的参数。若零件的模型和研究中都未指定材料属性,则会拒绝求解,并指出零件名称
(材料)。connections 仅用于覆盖自动检测结果(对不得粘结的一对设置 free);相接的零件对无需设置即可粘结。如果某一对零件在一个通过其他零件粘结的组内被设为 free,则会拒绝求解。约束和载荷可指定任意零件上的面(post/face 23),但不能指定被粘结接头完全覆盖的面(会拒绝求解并指出该面);如果某个面只被另一个零件部分覆盖,则会在未覆盖的区域施加约束或载荷。接头类型为 bonded 或 free:此版本不支持相互挤压并滑动的零件,也不支持螺栓。
当最薄弱零件的安全系数低于 3 时,会进行更精细的重新求解。摘要中的 yield_MPa 和 safety_factor 对应最薄弱零件(weakest_part、weakest_part_peak_MPa),而 max_von_mises_MPa 和 max_displacement_mm 则覆盖整个装配体:应力最高处可能位于强度更高的零件中,因此不要用前者除以后者;各零件自身的数值见 parts。每条结果都会指出对应零件(“'post' yields: ...”):请针对该零件进行修改(加厚截面、增加圆角、在 parts 中指定该零件的材料属性,或扩大接头;接头面积 area_mm2 列在结果的 connections 中),而不是笼统地修改整个装配体。
比较不同版本
设计的每个版本都是单独的文档;请对每个版本运行相同的研究并输出到各自的文件夹,然后比较 result.json。不同版本的面编号并不稳定:编辑会导致编号变化,而未经检查地复用 ref 会悄无声息地指向另一个面,不会报错。因此,请列出每个版本的面,并根据曲面类型、法线、中心点和面积匹配基准版本的面;若两个面都符合条件,请先询问。为每项研究指定基准版本的 mesh.size_mm,这样差异反映的是设计变化,而非网格差异;并在表格中注明映射关系(baseline bracket/face 17 → bracket/face 21, the mounting face),供用户核对。
结果
报告两个 von Mises 应力峰值。节点峰值(max_von_mises_MPa,安全系数使用此值)是每个单元在积分点处的应力外推到节点后,再对每个节点处的单元应力取平均;装配体中按零件分别计算。它通常是两个峰值中较高的一个。积分点峰值(max_von_mises_gauss_MPa)是单元的原始值;如果它比节点峰值高出 50% 以上,说明存在网格尚未解析的应力集中。安全系数 = 求解结果中的屈服强度 / 节点峰值。完全刚性的约束或粘结接头边缘,以及尖锐的内角,都是奇异点:每次细化网格都会使该处峰值增大,无法收敛,因此下方的结果会说明何时应改为读取该处稍远位置的应力。
发现项列表会优先列出错误:错误表示该部件不适合使用;警告则是需要权衡并采取行动或说明的判断。大多数发现项都会标明面(bracket/face 12,即原始部件的引用),前提是该点位于某个面上,并给出以 mm 为单位的坐标。只有当安全系数低于研究的 margin,且更精细的求解未能稳定峰值(峰值变化仍超过 10 %)时,才会出现 peak_at_fixture 和 peak_concentration;高于该余量时,它们不会改变结论。
| 发现项 | 严重程度 | 含义 | 处理方法 |
|---|---|---|---|
yields | 错误 | 节点峰值超过材料的屈服强度。 | 在峰值处加强部件、更换材料,或确认载荷;若旁边还有 peak_at_fixture 或 peak_concentration,应优先处理:峰值可能来自模型,而非部件本身。 |
low_margin | 警告 | 部件能够承受,但低于研究的 margin。 | 按照 yields 的方式处理,或报告当前余量;切勿降低 margin 来消除该发现项。 |
displacement_over_limit | 错误 | displacement 检查得出的最大位移(在指定面上检查,否则检查整个模型)超过了 limit_mm。 | 提高部件刚度,或与用户确认限值。 |
peak_at_fixture | 警告 | 峰值位于固定面或其边缘处,刚性夹具会使应力被夸大,且更精细的求解未能稳定峰值。 | 重新设计前,先查看离该面稍远处的应力(查看颜色,或在 VTU 中使用探针);如果该处应力仍然较高,旁边的发现项依然成立。 |
peak_concentration | 警告 | 积分点峰值远高于节点峰值:这是尖角或网格无法解析的集中载荷所致。 | 安全系数低于 3 时,运行已自动进行更精细的求解,因此再次细化整个部件并非下一步操作:应在尖角处添加圆角,或将载荷分散到更大的面上。高于 3(margin 较大)时,细化一次并进行比较(网格)。 |
mesh_not_converged | 警告 | 自动进行的更精细求解使峰值变化超过 10 %。在装配体中,此项仅适用于安全系数低于 3 的部件。 | 如果峰值持续上升,说明它位于奇异点:应添加圆角,或判断远离该处的应力。否则,在信任安全系数之前,应将 mesh.size_mm 设为更小的值。 |
large_displacement | 警告 | 部件的移动距离超过其尺寸的 1 %:小位移模型已发生明显拉伸。 | 检查与配合部件的装配情况;如果挠度不可接受,则提高部件刚度。 |
not_connected | 错误 | 某个部件或一组部件没有与固定部件相连的粘合链;求解未运行。消息会指出最近的部件及其距离。 | 使部件相互接触、固定该组中的一个面,或在间隙属于你会视为接触的情况时,增大 contact_tolerance_mm。 |
overlapping_parts | 警告 | 两个部件的实体重叠量超过容差;它们并未粘合。 | 修正几何体;如果该重叠是可接受的简化处理,则在 connections 中将这对部件标记为 free(这样即可消除此警告)。如果某个部件仅通过重叠部分固定,则会被标记为 not_connected。 |
gap_closed | 警告 | 两个稍有间隙或稍微相互嵌入的部件,在容差范围内通过移动几何体至接触而被粘合。 | 检查间隙是建模间隙而非实际间隙,或干涉是滑动配合而非会影响预紧力的过盈配合;该接头处的应力反映的是模型闭合过程,而非部件本身。 |
bonded_edge_peak | 警告 | 峰值位于粘合接头的边缘,刚性粘合会使应力被夸大;两个网格结果一致并不能证明该处应力可信。 | 查看离接头稍远处的应力;螺栓连接或焊接接头的刚度低于此模型中的接头。 |
solver_note | 警告 | 有关运行本身的情况:超过 150 000 个自由度的求解较慢、跳过或未能完成更精细的求解、未绘制图片。 | 在这会影响结论时说明该情况。 |