SurfaceContactLaw
类型: 类
领域: 仿真交接
推荐导入: from cadflow import SurfaceContactLaw
签名
class SurfaceContactLaw(law_id: 'str', normal_model: 'NormalContactModel | str' = <NormalContactModel.HARD: 'hard'>, allow_separation: 'bool' = True, normal_penalty_stiffness: 'float | None' = None, pressure_overclosure: 'tuple[tuple[float, float], ...]' = (), friction_model: 'FrictionModel | str' = <FrictionModel.FRICTIONLESS: 'frictionless'>, friction_coefficient: 'float' = 0.0, tangential_penalty_stiffness: 'float | None' = None, normal_damping_per_area: 'float' = 0.0, cohesive_tensile_strength: 'float | None' = None, cohesive_shear_strength: 'float | None' = None, metadata: 'dict[str, Any]' = <factory>) -> None
功能说明
SurfaceContactLaw 是 CadFlow 仿真交接领域的公共类。
原始 API 说明
Distributed traction/separation law; penalty units are force/length^3.
其他公共导入路径
from cadflow.simulation import SurfaceContactLaw
参数
| 名称 | 类型 | 必需 | 默认值 | 源码说明 |
|---|---|---|---|---|
law_id | 'str' | 是 | - | 源码 Docstring 未单独说明。 |
normal_model | 'NormalContactModel | str' | 否 | <NormalContactModel.HARD: 'hard'> | 源码 Docstring 未单独说明。 |
allow_separation | 'bool' | 否 | True | 源码 Docstring 未单独说明。 |
normal_penalty_stiffness | 'float | None' | 否 | None | 源码 Docstring 未单独说明。 |
pressure_overclosure | 'tuple[tuple[float, float], ...]' | 否 | () | 源码 Docstring 未单独说明。 |
friction_model | 'FrictionModel | str' | 否 | <FrictionModel.FRICTIONLESS: 'frictionless'> | 源码 Docstring 未单独说明。 |
friction_coefficient | 'float' | 否 | 0.0 | 源码 Docstring 未单独说明。 |
tangential_penalty_stiffness | 'float | None' | 否 | None | 源码 Docstring 未单独说明。 |
normal_damping_per_area | 'float' | 否 | 0.0 | 源码 Docstring 未单独说明。 |
cohesive_tensile_strength | 'float | None' | 否 | None | 源码 Docstring 未单独说明。 |
cohesive_shear_strength | 'float | None' | 否 | None | 源码 Docstring 未单独说明。 |
metadata | 'dict[str, Any]' | 否 | <factory> | 源码 Docstring 未单独说明。 |
返回值
类型: None
源码 Docstring 未声明更多返回语义。
异常
源码 Docstring 未声明更窄的异常契约。类型、数值、所有权、路径或后端状态无效时，仍可能抛出相应公共异常。
数据字段
| 名称 | 类型 | 默认值 |
|---|---|---|
law_id | 'str' | required |
normal_model | 'NormalContactModel | str' | <NormalContactModel.HARD: 'hard'> |
allow_separation | 'bool' | True |
normal_penalty_stiffness | 'float | None' | None |
pressure_overclosure | 'tuple[tuple[float, float], ...]' | () |
friction_model | 'FrictionModel | str' | <FrictionModel.FRICTIONLESS: 'frictionless'> |
friction_coefficient | 'float' | 0.0 |
tangential_penalty_stiffness | 'float | None' | None |
normal_damping_per_area | 'float' | 0.0 |
cohesive_tensile_strength | 'float | None' | None |
cohesive_shear_strength | 'float | None' | None |
metadata | 'dict[str, Any]' | factory |
公共成员
| 成员 | 类型 | 签名 | 说明 |
|---|---|---|---|
from_dict | class method | (cls, value: 'Mapping[str, Any]') -> "'SurfaceContactLaw'" | 见成员签名。 |
to_dict | method | (self) -> 'dict[str, Any]' | 见成员签名。 |
行为与约束
- 实例是不可变 dataclass 值；更新式工作流会返回替代值。
导入检查
from cadflow import SurfaceContactLaw