跳到主要内容

Physical Connection API

cadflow.physical 为 Assembly Connector 和可选 Geometry Region 附加降阶载荷响应行为。它补充 Assembly Kinematics，但不充当连续体接触 Solver。

Layer 结构​

PhysicalConnectionLayer 属于一个 assembly_id，并声明 Length、Force 与 Time Unit，其中包含具有唯一 ID 的 PhysicalConnection。

每个 Connection 标识：

  • 一个 PhysicalConnectionKind；
  • 两个 Assembly ConnectorRef 端点；
  • 可选 ConnectionBehavior，包含 Stiffness、Damping、Friction、Preload、Clearance、Interference 与 Limit；
  • 可选 ConnectionRegion Geometry Reference 与 Role；
  • 可选 Insertion Direction、Auxiliary Component 与关联运动学 Constraint。

构造​

layer = cad.make_physical_connection_layer_rphysicalconnectionlayer(
    assembly, length_unit="mm", force_unit="N", time_unit="s"
)
behavior = cad.make_connection_behavior_rconnectionbehavior(
    response_mode="linear",
    normal_stiffness=20000.0,
    tangential_stiffness=8000.0,
    friction_coefficient=0.2,
)
connection = cad.make_physical_connection_rphysicalconnection(
    connection_id="joint-1",
    connection_kind="contact",
    connector_a=left_ref,
    connector_b=right_ref,
    behavior=behavior,
)
layer = cad.add_physical_connection_rphysicalconnectionlayer(layer, connection)

支持的 Kind、Role 与 Response Mode 以对应 Enum 页面为准。数值参数必须有限，并满足其非负或正值约束。Limit 字段可省略；省略意味着声明不对该项作限制承诺。

验证​

validate_physical_connection_layer_rphysicalconnectionvalidationreport(layer, assembly) 检查 Assembly 身份、唯一 ID、Connector Resolution、Region、Unit、关联 Constraint 与交叉引用。报告区分 Error 与 Warning，并可在存在 Error 时抛出异常。

验证确认声明内部一致，不证明结构充分性或法规符合性。

Response 求值​

PhysicalConnectionState 提供相对位移、旋转、速度或其他模式相关状态。evaluate_physical_connections_rphysicalconnectionresponsebatch(layer, states) 返回每个 Connection 的 Force、Moment、Limit Utilization 与 Diagnostic。

State 和 Response 遵循 Layer 声明的单位制。符号方向与 Frame 约定必须与 Connector 定义一致。

持久化​

JSON 导入导出函数保留带版本的 Layer Schema。导入后仍需针对目标 Assembly 重新验证，因为语法有效的 Layer 可能引用当前产品中不存在的 Component 或 Connector。

全部符号见 23 个 Physical API。