fea について
fea は、部品やアセンブリの線形静解析を行うスキルです。応力と変位の初期評価を必要とする設計作業向けで、netgen によるメッシュ生成と CalculiX による解析を行い、適用範囲と制限を示します。
主な機能
- 01STEP または XBF モデルから解析を設定
- 02拘束、荷重、材料、メッシュの定義
- 03応力と変位の解析
- 04JSON、画像、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:耐えられるか、どれだけ変位するか
この解析では、部品の一部の面を固定し、他の面に荷重を加え、netgen の二次四面体メッシュ上で CalculiX に線形弾性応答を解かせます。降伏点未満の等方性材料を使用し、完全剛体の治具と、移動しない荷重のもとで、力、圧力、部品自体の重量、一定加速度による応力と変位を求めます。アセンブリの部品同士は、接触する箇所で結合されているものとして扱います。これは初期段階のエンジニアリングチェックであり、認証ではありません。結果を報告する際は、その旨を明記してください。振動、座屈、熱、流れ、疲労、衝撃、互いに滑り合う部品はこのバージョンでは対象外です。明確にその旨を伝え、静的安全率でこれらに答えたことにしないでください。落下や制動による荷重は、一定の g 荷重として見積もることができます(物体荷重)。
タスクから始める
| タスク | 最初に行うこと | リファレンス |
|---|---|---|
| 荷重を受ける部品をチェックする | cad step solve part.step を実行すると面が一覧表示されます。解析条件を記述し、フォルダーに解を出力します。 | ワークフロー、線形静解析 |
| アセンブリをチェックする | cad step solve assembly.step を実行すると、部品と接触しているペアが一覧表示されます。 | アセンブリ |
| 解析条件ファイルを作成または編集する | 1 つの JSON オブジェクトに、固定条件と荷重、続いて材料、メッシュ、マージン、チェックを記述します。アセンブリの場合は部品と接続も記述します。 | 解析条件ファイル |
| 材料を選ぶ | モデル独自の材料(モデルを解くか、その .xbf を使用)、またはユーザーが指定する E、ν、降伏点を使用します。 | 材料 |
| 結果を評価する | result.json とその所見を、手計算による見積もりと照らし合わせます。 | 所見、結果の評価 |
| 概要では答えられない質問に回答する | meshio で読み込める result.vtu を使用します。 | 独自の質問 |
| 設計のバリエーションを比較する | 各バリエーションに同じ解析条件を適用し、面の対応付けとメッシュサイズを統一します。 | バリエーションの比較 |
このスキルは部品を解析するものであり、部品をモデリングするものではありません。保存済みの .step または .xbf、あるいはエンジンがドキュメント ID で保持しているモデル(cad model solve <id>)を読み込み、ドキュメント全体を解析します。アセンブリ内の部品を 1 つだけ解析するには、その部品を独立したドキュメントとしてエクスポートしてください。
セットアップ
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 アプリを追加したばかりの場合、サーバーの起動がまだ完了していない可能性があります。まずは最大 1 分ほど待ってから再試行してください。それ以外の問題は cad doctor --check で確認できます。このコマンドは何も変更しません。報告された問題を修復するには cad doctor を実行します。
解析は、ドキュメントの種類に応じた solve 操作です。cad step solve、cad xbf solve、cad model solve を使います。--study を指定しない場合は解析の設定を一覧表示し、何も書き込みません。--study と --out DIR を指定すると解析を実行し、その結果を DIR に書き込みます。解析で必要になったときに cad コマンドが初回にインストールする 2 つのツールは、連携機能です。自分でインストールする必要はありません。cad run は、部品を読み込むカーネルを使って cad.step.solve の両方を呼び出すスクリプトを提供します。
- netgen(メッシャー):
netgen連携機能(cad[netgen]、約 11 MB)。netgen が公開しているのは macOS、Linux x86_64、Windows x86_64 向けのみです。それ以外の環境(Linux の ARM など)では解析を拒否し、プラットフォーム名を表示します。 - CalculiX(
ccx、ソルバー):calculix連携機能(cad[calculix]:cad-ccx パッケージ、各プラットフォーム向け CalculiX 2.23、約 13 MB)。CAD_CCXでファイルを指定しない限り、ユーザー自身の CalculiX が実行されることはありません(バージョン 2.20 以降)。ヘッドレスで、1 スレッドのみを使い、専用フォルダー内で実行されます。そのため、同じ解析からは毎回同じ数値が得られ、各結果には解析に使ったバージョンが記録されます。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解析を指定しない場合は設定が表示され、何も書き込みません。部品、接触しているペア、その後に部品の各面が 1 行ずつ表示されます。各行には参照、面積、中心、面の種類、
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には一時フォルダーを含む任意のフォルダーを指定できます。フォルダーが存在しない場合は作成されます。ユーザーがファイルを保持する必要がある場合は、プロジェクト内に指定してください。解析ごとにフォルダーを 1 つ使います。解析を実行すると、そのフォルダー内の自身のファイルだけが置き換わり、それ以外には何も変更されません。実行に失敗しても、以前の結果はそのまま残ります。フォルダーには次のものが含まれます。ファイル 用途 result.json--jsonが出力する回答です。まずこれを読みます。stress.png,displacement.png各フィールドで色分けした変形後の部品です(青が低く、赤が高い値)。変形は deformation_scaleによって誇張されており、カラーバーにはフィールド名、単位、範囲が示されます。荷重が意図した方向に作用しているか、どの面が固定されているかを確認できます。応力の画像をユーザーに見せてください。result.glb同じ色分けされた表面です。glTF ビューアーまたは cad viewerで表示できます。result.vtudisplacement(mm)とvon_mises(MPa)が角節点に設定された体積メッシュです(独自の質問)。ccx.inp--deckを指定した場合に出力されます。CalculiX が解いた入力ファイルです(2 回解いた場合は、より細かいメッシュで解いた方のファイル)。このフォルダーでcad run ccx -i ccxを実行できます。エンジンが描画できない場合(ディスプレイのない Linux など)、画像は出力されず、
solver_noteにその旨が記載されます。それ以外のファイルはすべて出力されます。結果はチェック内容で、
ok、findings(各項目にseverity、code、message、location、hintを含みます)、written、およびmeasurementsで構成されます。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が含まれます。2 回解いた場合は、最初の解析のメッシュサイズと最大値も含まれます。--jsonを指定しない場合も、同じ内容が行ごとに出力されます。- 安全率が 3 未満になると、再度より細かいメッシュで解析します(要素サイズを半分にしますが、大きなモデルでは半分より小さい割合にします)。その後、再解析が自動的に実行され、より細かいメッシュでの結果が出力されます (メッシュ)。
- 進行状況(
[fea] meshing ...)は標準エラー出力に送られ、結果には含まれません。--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 へのインデックス)が記録されています。
アセンブリ
複数の部品からなるドキュメントは、1つのアセンブリとして解きます。接触している部品は1つの適合メッシュに結合され、それぞれの材料を保持し、各部品の応力はその部品固有の降伏強度に照らして評価されます。すべての部品は、結合された隣接部品をたどって固定部に到達できなければなりません。設定の詳細はstudy-file.mdを参照してください。
セットアップ(cad step solve assembly.step)では、まず各部品(参照、名前、体積)が表示され、続いて各ペアについて、接触面積と隙間を伴うbonded、近接しているものの接触していない場合(隙間が最大1 mmで、contact_tolerance_mmを超える場合)のnot connected、ソリッドが体積を共有している場合のoverlapping · N mm³が表示されます。重なりは決して結合されません。許容値以下の重なりは干渉(圧入、またはモデリング上のずれ)とみなされ、interference N mmを付けてbondedと表示され、隙間と同様に閉じられます。表示を設計と照らし合わせ、検出された各接合部が実際に存在するか、想定している接合部が検出されていないかを確認してください。判定のデフォルト値は0.1 mmです。より大きな隙間を結合する必要がある解析では、表示された隙間をもとにcontact_tolerance_mmを設定してください。名前は重複する場合があります(たとえば、barという名前の部品が2つある場合)。必要に応じて参照(frame/bar.2)を使用してください。
各部品は、それぞれのモデルに設定された材料を使って解析されます。partsでは、ユーザーが指定した数値を部品に設定します。モデルにも解析にも材料が指定されていない部品がある場合、その部品名を示して処理を拒否します(Materials)。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を比較してください。面番号はバージョン間で安定しません。編集すると番号が変わり、参照を確認せずに再利用すると、エラーなしで別の面が指定されます。そのため、各バリアントの面を一覧にして、面の種類、法線、中心、面積を使い、ベースラインの面との対応を確認してください。候補が2つある場合は、どちらが適切か確認してください。すべての解析にベースラインと同じmesh.size_mmを指定し、差異がメッシュではなく設計によるものになるようにします。また、対応表(baseline bracket/face 17 → bracket/face 21, the mounting face)を表と一緒に提示し、ユーザーが確認できるようにしてください。
検出結果
フォン・ミーゼス応力のピークは2種類報告されます。節点ピーク(max_von_mises_MPa。安全率の計算に使用されます)は、各要素の積分点における応力を節点に外挿し、アセンブリの場合は部品ごとに、各節点でその節点を共有する要素間の平均を取った値です。通常、2つの値のうち高いほうです。積分点ピーク(max_von_mises_gauss_MPa)は、要素における生の値です。節点ピークより50%以上高い場合、メッシュで解像できていない応力集中を示します。安全率は、降伏強度を、書き出された解析結果の節点ピークで割った値です。完全剛体の拘束や結合された接合部の端、および鋭い内角は特異点です。そこでのピークは細分化のたびに大きくなり、収束しません。そのため、以下の検出結果では、そこから少し離れた位置で応力を確認するタイミングを示しています。
検出結果一覧では、まずエラーを確認してください。エラーはその部品が使用に適さないことを示し、警告は判断材料として検討し、対処するか説明するものです。ほとんどの検出結果には、該当箇所が部品上にある場合、その面(bracket/face 12、元の部品の参照名)と位置(mm)が表示されます。peak_at_fixture と peak_concentration は、安全率が解析の margin を下回り、より細かい解析でもピークが収束しなかった(10 % 未満の変化に収まらなかった)場合にのみ表示されます。margin を上回っている場合は、結果に影響しません。
| 検出結果 | 重大度 | 意味 | 対処方法 |
|---|---|---|---|
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 が大きい場合)は、1 回細分化して比較してください(メッシュ)。 |
mesh_not_converged | 警告 | 自動で行われた細かい解析で、ピークが 10 % を超えて変化しました。アセンブリでは、安全率が 3 未満の部品にのみ表示されます。 | 上昇し続けるピークは特異点にあります。フィレットを付けるか、その箇所から離れた位置の応力を評価してください。それ以外の場合は、安全率を信頼する前に mesh.size_mm をより小さく設定してください。 |
large_displacement | 警告 | 部品寸法の 1 % を超えて変位しており、小変位モデルの前提から外れています。 | 嵌合部品との適合を確認し、たわみが許容できない場合は部品の剛性を高めてください。 |
not_connected | エラー | 部品または部品群が固定部品に結合されておらず、解析は実行されませんでした。メッセージには、最も近い部品とその距離が表示されます。 | 部品同士を接触させる、部品群の面を固定する、またはその隙間を接触と見なせる場合は contact_tolerance_mm を大きくしてください。 |
overlapping_parts | 警告 | 2 つの部品のソリッドが許容差を超えて重なっています。部品同士は結合されていません。 | ジオメトリを修正してください。または、重なりを許容できる簡略化として扱う場合は、connections で該当するペアを free に設定してください(この警告は表示されなくなります)。重なりだけで保持されている部品には not_connected が表示されます。 |
gap_closed | 警告 | わずかに離れている、またはわずかに食い込んでいる 2 つの部品が許容差内にあり、ジオメトリをその距離だけ移動して結合されました。 | 隙間が実際のものではなくモデリング上のクリアランスか、干渉が、予圧が重要な圧入ではなく滑り嵌めかを確認してください。接合部の応力は部品ではなく、モデルで隙間を閉じたことによるものです。 |
bonded_edge_peak | 警告 | ピークが結合接合部の端にあり、剛体結合によって応力が過大に見積もられています。2 つのメッシュの結果が一致していても、その箇所での正しさを証明することにはなりません。 | 接合部から少し離れた位置の応力を確認してください。ボルト締結または溶接された接合部は、このモデルよりも柔軟です。 |
solver_note | 警告 | 解析実行自体に関する内容です。自由度が 150 000 を超える解析の低速実行、細かい解析のスキップまたは失敗、図の未描画などが該当します。 | 結果に関係する場合は、その旨を記載してください。 |