cad_sim
Destructive
Run, inspect, and delete FEA or kinematics simulations. Mesh CAD entities, register setups, execute synchronously or asynchronously, and retrieve results to analyze physical behavior.
Instructions
Mesh, setup, run, inspect or delete a simulation.
聚合仿真操作。按 ``action`` 派发：mesh / setup / run / result / list / delete。
- ``mesh``: generate a hexa8 hex mesh of an entity's bounding box (pure
Python, always available).
- ``setup``: register a simulation (``kind`` = fea or kinematics).
- ``run``: execute synchronously, or schedule an async batch job with
``async_run``. FEA (CalculiX) and kinematics (PyBullet) backends are
optional — absent engines report ``requires_sim``.
- ``result`` / ``list`` / ``delete``: inspect or remove simulations.
When not to use: ``cad_sim`` analyzes physical behavior. For geometric
*validity* checks use ``cad_validate`` (geometry/interference); for
meshing previews that are pure geometry use ``cad_object`` (read).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sim | Yes | Simulation action to perform, discriminated by `action`: mesh, setup, run, result, list or delete. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bbox | No | Meshed bounding box | |
| kind | No | Simulation kind | |
| name | No | Simulation name | |
| state | No | Simulation state | |
| action | Yes | Simulation action executed | |
| result | No | Simulation result payload | |
| sim_id | No | Simulation identifier | |
| status | Yes | Operation status | |
| message | No | Status description | |
| results | No | Simulation summaries | |
| node_count | No | Mesh node count | |
| element_type | No | Element type | |
| element_count | No | Mesh element count |