Simulation Handoff API
cadflow.simulation 描述 Assembly 中的分布式 Face Contact 与 Material Assignment。CadFlow 负责验证和打包几何证据；Meshing、Load、Boundary Condition、Step、非线性求解与收敛属于下游 Solver Adapter。
Model 内容
| 集合 | 身份 | 作用 |
|---|---|---|
surfaces | surface_id | Component-local Face Region 与 Role |
contact_laws | law_id | Normal 与 Tangential 本构声明 |
contact_pairs | pair_id | 两个 Surface、Law、Search 与 Sliding 设置 |
surface_properties | property_id | Thickness 等 Region 属性 |
materials | material_id | Mechanical Material 值 |
component_materials | Component ID | Material Assignment |
Model 还记录明确的 Length、Force、Time 与 Temperature Unit。序列化数据包含派生的 Pressure、Penalty、Damping、Density 与 Thermal Expansion Unit。
Surface Reference
make_surface_region_rsurfaceregion 接受兼容 Face 或可重放 GeometryRef。geometry_ref_from_face(face, flip=False) 从公共 Face 创建稳定 Selector；flip 反转仿真证据中的预期 Surface Orientation。
Surface Resolution 会检查 Component 是否存在、解析每个 Selector，并记录稳定 Face Evidence。当前 Package 要求目标 Part 能从 Assembly 结构直接解析。
本构声明
SurfaceContactLaw 支持文档列出的 NormalContactModel、FrictionModel 以及相关 Penalty/Cohesive 参数。SurfaceContactPair 连接两个不同 Surface，并指定 Clearance 或 Interference、Search Tolerance、Opposed Normal Threshold、Sliding Formulation 与可选 Activation Step。
MechanicalMaterial 保存显式 Elastic、Density、Yield、Thermal 与 Metadata 字段。CadFlow 不会从 Material Name 推导工程常数。
验证、分析与导出
report = cad.validate_contact_simulation_model_rcontactsimulationvalidationreport(
simulation, assembly
)
report.raise_for_errors()
analysis = cad.analyze_contact_simulation_model_rcontactsimulationanalysis(
simulation, assembly
)
manifest = cad.export_contact_simulation_package_rpath(
simulation, assembly, "out/contact-package"
)
Validation 检查 Schema 与 Cross-reference。Analysis 解析 Surface，并计算原生 Face/Pair Metric，如 Area、Centroid、Bounds、Separation 与 Relative Orientation。Export 写出 Simulation JSON、Component-local BREP、选中 Face、Hash、Index 与刚体 Transform。
候选或 Metric 证据属于预处理信息，不是已求解的接触状态。Solver Adapter 必须定义中性 Law 如何映射到特定 Solver Card，并记录所有不支持字段。
全部符号见 22 个 Simulation API。