対応解析
eMachineSim は eMachineSim Python API から利用します。現在公開ドキュメントで説明している主なワークフローは次の通りです。
| 解析領域 | Python entry point | 代表サンプル | 状態 |
|---|---|---|---|
| 定常熱伝導解析 | eMachineSim.thermal.run_file, eMachineSim.Session.solve | Examples/thermal/bdf, Examples/thermal/realistic_motor_steady | 主な公開ワークフローです。 |
| 熱等価回路 / FEMH 連成 | eMachineSim.thermal.run_file | realistic_motor_steady | 外部冷却、housing、mount、shaft、bearing などの熱経路と heat-balance diagnostics を扱います。 |
| BDF/QVOL 熱入力 | eMachineSim.thermal.run_bdf, eMachineSim.run_file | QVOL_loss.bdf, QVOL_loss_mix.bdf | 選択された Nastran bulk cards を熱解析用に読み込みます。 |
| Surface / gap thermal coupling | eMachineSim.thermal.run_file | realistic_motor_steady | face pairing diagnostics と node-pair lumped coupling を含みます。 |
| 構造静解析 | eMachineSim.structural.run_static | Examples/structural/rotor | ロータ遠心力解析と構造診断のサンプルを含みます。 |
| Modal / NVH 解析 | eMachineSim.modal.run | Examples/structural/modal_stator | modal、force mapping、frequency response、circumferential order、簡易 acoustic indicator を含みます。 |
| Electrostatic 解析 | eMachineSim.run_file | Examples/electrostatic/ring, Examples/electrostatic/3by3 | 将来の electric / electrostatic 拡張の入口として残している小規模サンプルです。 |
推奨する使い方
JSON input control file がある場合は eMachineSim.run_file() を使います。
import eMachineSim
result = eMachineSim.run_file("input.json", r"path\to\run_directory")
条件を変更しながら連続実行する場合は eMachineSim.Session を使います。
session = eMachineSim.Session()
session.initialize(input_json, run_directory)
session.update_input({"some": "patch"})
result = session.solve()
session.finalize()
SKILLS / MCP + コーディングAIでの利用
解析条件が複雑なモータ熱解析やNVH評価では、ユーザーがすべてのJSONキーやCSV診断を覚える必要はありません。eMachineSim の SKILLS をコーディングAIに読み込ませることで、目的に合うサンプル選択、input.json 作成、解析実行、結果CSV確認までを対話的に進められます。
さらに MCP server を利用すると、AIエージェントが Examples、input JSON、thermal heat-balance CSV、surface assignment、gap coupling、interface resistance、cooling path summary などをツール経由で確認できます。これにより、「どのCSVを見るべきか」「熱収支が閉じているか」「gap面とFEMH面が重複していないか」といった確認を対話の中で進めやすくなります。
具体的なMCP serverの設定やツール一覧は公開リポジトリ側にまとめ、Docsでは利点と利用イメージを説明します。詳しくは SKILLS / MCP + コーディングAI を参照してください。
現在のスコープ
- Python API は JSON-first の設計です。内部 assembly step をすべて個別APIとして公開する方針ではありません。
- Electrostatic は現時点では小規模サンプル中心ですが、将来拡張の入口として公開しています。
- Motor NVH は相対評価を主目的とした簡易 workflow であり、校正済みの絶対音圧 solver ではありません。