# 材料库 材料模块位于 `material/`,同时服务 FEM 和 SPH。 ## 材料配置 内置材料通常放在: ```text material/builtin_materials.xml ``` 求解器中引用: ```xml ``` 粒子或单元通过 `material_id` / `material` 与材料表关联。 ## 材料文件结构 内置材料库根节点为: ```xml ``` 常用关键词: | 关键词 | 说明 | |---|---| | `M3FrameBuiltinMaterials` | 内置材料库根节点。 | | `Material` | 一个材料记录。 | | `id` | 数值编号,供网格单元或粒子引用。 | | `key` | 可读字符串编号,例如 `water.newtonian`。 | | `kind` | 材料类别。 | | `response` | 本构响应类型。 | | `density` | 密度。 | | `young_modulus` | 杨氏模量。 | | `poisson_ratio` | 泊松比。 | | `shear_modulus` | 剪切模量。 | | `bulk_modulus` | 体积模量。 | 材料类别 `kind`: | `kind` | 说明 | |---|---| | `solid` | 固体材料。 | | `fluid` | 流体材料。 | | `porous_solid` | 多孔固体。 | | `interface` | 界面或特殊耦合材料。 | 响应类型 `response`: | `response` | 说明 | |---|---| | `linear_elastic` | 线弹性。 | | `hyper_elastic` | 超弹性。 | | `finite_plasticity` | 有限塑性。 | | `elastoplastic_damage` | 弹塑性损伤。 | | `porous_elastoplastic_damage` | 多孔弹塑性损伤。 | | `newtonian_fluid` | 牛顿流体。 | ## 常见材料类型 - 线弹性。 - J2 弹塑性。 - Drucker-Prager。 - 损伤材料。 - Neo-Hookean、Mooney-Rivlin、Yeoh、Ogden 超弹性。 - 有限塑性与乘法分解有限塑性。 - 牛顿流体和非牛顿流体。 ## 超弹性参数 `response="hyper_elastic"` 时可使用: | 参数 | 说明 | |---|---| | `hyperelastic_model` | `neo_hookean`、`mooney_rivlin`、`yeoh`、`ogden`。 | | `c10/c01/c20/c30` | Mooney-Rivlin 或 Yeoh 系数。 | | `ogden_mu1/2/3` | Ogden 模型系数。 | | `ogden_alpha1/2/3` | Ogden 指数。 | | `shear_modulus` | 剪切模量,Neo-Hookean 常用。 | | `bulk_modulus` | 体积模量。 | 示例: ```xml ``` ## 塑性与损伤参数 常用塑性参数: | 参数 | 说明 | |---|---| | `finite_plasticity_model` | `j2_multiplicative`、`j2_rate`、`drucker_prager`。 | | `objective_stress_rate` | `jaumann`、`green_naghdi`、`truesdell` 或 `none`。 | | `yield_stress` | 初始屈服应力。 | | `hardening_modulus` | 线性硬化模量。 | | `pressure_friction` | Drucker-Prager 压力摩擦参数。 | | `pressure_dilation` | Drucker-Prager 剪胀参数。 | | `cohesion` | 黏聚力。 | 损伤材料还会跟踪损伤变量、等效塑性应变等历史变量。非线性材料必须配合 commit/rollback 和路径测试使用,避免迭代失败污染历史状态。 示例: ```xml ``` ## 多孔材料参数 多孔弹塑性材料用于渗流-变形耦合。常用内部参数包括: | 参数 | 说明 | |---|---| | `biot_coefficient` | Biot 系数。 | | `initial_porosity` | 初始孔隙率。 | | `permeability0` | 初始渗透率。 | | `porosity_compressibility` | 孔隙率压缩性。 | 如果当前 XML 记录中没有显式给出这些参数,应在材料工厂或 FEM solver 配置中确认默认值是否满足案例需求。 ## 状态方程 支持: - Ideal gas。 - Tait。 - Tillotson。 - Mie-Gruneisen。 EOS 关键词: | 参数 | 说明 | |---|---| | `eos` | `ideal_gas`、`tait`、`tillotson`、`mie_gruneisen`。 | | `gamma` | 比热比或 Tait 指数。 | | `gas_constant` | 理想气体常数。 | | `reference_pressure` | 参考压力。 | | `sound_speed` | 声速。 | | `tait_B` | Tait EOS 刚度参数。 | | `tillotson_a/tillotson_b` | Tillotson 参数。 | | `tillotson_A/tillotson_B` | Tillotson 压缩参数。 | | `tillotson_alpha/tillotson_beta` | Tillotson 膨胀参数。 | | `tillotson_E0/Eiv/Ecv` | Tillotson 能量参数。 | | `gruneisen_gamma0` | Mie-Gruneisen 初始 Gruneisen 系数。 | | `hugoniot_C0` | Hugoniot 声速参数。 | | `hugoniot_S1` | Hugoniot 斜率参数。 | 水体示例: ```xml ``` SPH 中也可通过求解器参数覆盖压力模型,例如: ```xml pressure_eos="linear_reference" pressure_eos="rho_c0_squared" ``` ## MaterialCapabilities 材料应通过能力标记说明自己支持哪些功能,例如: - 小应变。 - 大变形。 - 一致切线。 - 状态变量 commit / rollback。 - GPU 更新。 - EOS。 - 孔压耦合。 求解器可用这些能力标记选择路径或给出诊断。 当前能力标记包括: | 能力 | 说明 | |---|---| | `small_strain` | 支持小应变计算。 | | `finite_strain` | 支持大变形/有限应变计算。 | | `fluid` | 支持流体响应。 | | `porous` | 支持多孔介质变量。 | | `damage` | 支持损伤历史变量。 | | `plasticity` | 支持塑性历史变量。 | | `consistent_tangent` | 提供算法一致切线。 | | `equation_of_state` | 提供状态方程。 | | `gpu_update` | 支持 GPU 材料更新路径。 | 求解器在进入高阶功能前应检查能力。例如隐式非线性求解需要切线矩阵,若材料没有 `consistent_tangent`,应给出诊断或退回近似切线。 ## 材料点输入与状态 材料模块通过通用材料点输入与状态连接 FEM/SPH: | 数据结构 | 说明 | |---|---| | `MaterialPointInput` | 当前步输入,如应变、应变率、变形梯度、速度梯度、密度、压力、孔压、温度、时间步。 | | `MaterialPointState` | 历史状态,如应力、塑性应变、塑性变形梯度、等效塑性应变、损伤、孔隙率、渗透率。 | | `MaterialPointResponse` | 本构输出,如应力、切线、压力、损伤、孔隙率、屈服标志。 | 大变形固体 SPH 和 FEM 有限变形应尽量传入: - `deformation_gradient` - `previous_deformation_gradient` - `velocity_gradient` - `rotation` - `spin` - `objective_rate` 这样材料本构才能正确区分小应变、TL/UL 大变形、客观应力率和有限塑性返回映射。 ## 状态提交与回滚 非线性材料需要严格区分: | 模式 | 说明 | |---|---| | `Trial` | 试算状态,不污染已提交历史变量。 | | `Commit` | 当前加载步收敛后提交历史变量。 | | `Rollback` | line search 或 Newton 失败时回滚到上一次提交状态。 | 强非线性 FEM、损伤、塑性和接触耦合必须使用 commit/rollback,否则一次失败迭代可能改变材料历史,导致后续残差和切线不一致。 ## 建议 - 工程案例优先显式给出单位。 - 非线性材料必须配套路径相关 benchmark。 - 修改材料参数后,应先运行单元级测试,再运行大规模算例。 ## 内置材料示例 `material/builtin_materials.xml` 当前包含常用材料示例: | id | key | kind | response | 关键参数 | |---|---|---|---|---| | `1` | `steel.linear_elastic` | `solid` | `linear_elastic` | `density=7850`,`E=210e9`,`nu=0.30` | | `2` | `aluminum.linear_elastic` | `solid` | `linear_elastic` | `density=2700`,`E=70e9`,`nu=0.33` | | `3` | `concrete.linear_elastic` | `solid` | `linear_elastic` | `density=2400`,`E=30e9`,`nu=0.20` | | `4` | `rubber.neo_hookean` | `solid` | `hyper_elastic` | `density=1100`,`shear_modulus=0.6e6`,`bulk_modulus=2.0e9` | | `5` | `steel.j2_damage` | `solid` | `elastoplastic_damage` | `E=210e9`,`nu=0.30`,`yield_stress=350e6`,`hardening_modulus=1.0e9` | | `6` | `soil.porous_elastoplastic_damage` | `porous_solid` | `porous_elastoplastic_damage` | `density=1800`,`E=50e6`,`nu=0.30` | | `7` | `water.newtonian` | `fluid` | `newtonian_fluid` | `density=1000`,`dynamic_viscosity=1.0e-3`,`eos=tait`,`gamma=7.0` | | `8` | `air.newtonian` | `fluid` | `newtonian_fluid` | `density=1.225`,`dynamic_viscosity=1.8e-5`,`eos=ideal_gas`,`gamma=1.4` | | `9` | `rubber.mooney_rivlin` | `solid` | `hyper_elastic` | `density=1120`,`c10=0.35e6`,`c01=0.08e6`,`bulk_modulus=2.0e9` | | `10` | `rubber.yeoh` | `solid` | `hyper_elastic` | `density=1120`,`c10=0.30e6`,`c20=0.02e6`,`c30=0.001e6` | | `11` | `soft_tissue.ogden` | `solid` | `hyper_elastic` | `density=1050`,`ogden_mu1=0.08e6`,`ogden_alpha1=2.5`,`ogden_mu2=0.01e6` | | `12` | `steel.finite_j2` | `solid` | `finite_plasticity` | `finite_plasticity_model=j2_multiplicative`,`yield_stress=350e6` | | `13` | `aluminum.finite_j2_rate` | `solid` | `finite_plasticity` | `finite_plasticity_model=j2_rate`,`objective_stress_rate=green_naghdi`,`yield_stress=250e6` | | `14` | `soil.finite_drucker_prager` | `solid` | `finite_plasticity` | `finite_plasticity_model=drucker_prager`,`pressure_friction=0.35`,`cohesion=0.12e6` | 完整 XML 记录如下,用户可以复制后修改参数形成项目材料库: ```xml ``` 使用建议: - SPH 水体优先从 `water.newtonian` 开始,再在 `sph_solver.xml` 中调整声速、EOS 和黏性。 - 橡胶球、接触回弹等大变形 FEM 案例优先从 `rubber.neo_hookean` 开始。 - J2、Drucker-Prager、损伤材料必须先跑材料路径 benchmark,再进入结构级案例。 ## SPH 材料建议 水体 WCSPH 常用 Tait EOS: ```xml ``` 对于调试用弱可压案例,也可以在求解器中覆盖压力模型: ```xml pressure_eos="linear_reference" ``` 液滴、自由面和小尺度表面张力案例需要同时校准: - `speed_of_sound` - `surface_tension` - `density_filter` - `particle_regularization` - `artificial_viscosity` 流体黏性参数: | 参数 | 说明 | |---|---| | `dynamic_viscosity` | 动力黏度,单位 `Pa*s`。 | | `density` | 密度,用于换算运动黏度。 | | `bulk_modulus` | 体积模量,可用于弱可压模型。 | | `eos` | 状态方程。 | 若液体看起来像泥浆,优先检查物理黏度、人工黏性和边界阻尼,而不是只调表面张力。 ## FEM 材料建议 线弹性材料适合先验证装配、约束和载荷;非线性材料建议按以下顺序逐步开启: 1. 单元级单调加载。 2. 卸载/反向加载。 3. 多步非比例加载。 4. line search 和 commit/rollback。 5. 大变形或接触耦合。 推荐验证顺序: | 材料 | 最小验证 | |---|---| | 线弹性 | 单轴拉伸、压缩、patch test。 | | 超弹性 | 单轴大拉伸、简单剪切、纯旋转零应力。 | | J2 塑性 | 单调拉伸、卸载/反向加载。 | | Drucker-Prager | 不同围压三轴压缩。 | | 损伤 | 单轴拉伸软化和能量耗散。 | | 多孔材料 | Terzaghi 固结、排水/不排水压缩。 | ## 非牛顿流体 SPH 可扩展常见非牛顿模型: - Bingham。 - Herschel-Bulkley。 - Carreau。 - 剪切变稀/剪切增稠。 - 屈服应力流体。 使用这些模型时,建议输出等效黏度场,便于判断局部剪切率和黏度是否合理。 ## GPU 材料路径 GPU 材料路径应使用紧凑描述符和历史变量缓冲: - 材料常量进入 `GPUMaterialDescriptor`。 - 积分点状态进入 GPU 常驻状态缓冲。 - 显式动力学优先使用 GPU 更新。 - 隐式非线性还需要 GPU 一致切线、commit/rollback 和装配链配合。 若材料没有 `gpu_update` 能力,应在 GPU 求解路径中给出明确诊断或回退 CPU。 ## 修改材料参数的检查清单 1. 单位是否为 SI。 2. `density` 是否与几何尺度、重力和时间步匹配。 3. 弹性参数是否满足物理约束,例如 `0 <= poisson_ratio < 0.5`。 4. 超弹性体积模量是否足够大但不过度导致锁定。 5. 屈服应力和硬化模量是否符合目标材料。 6. EOS 声速和 Tait 参数是否和 SPH 时间步匹配。 7. 非线性材料是否有路径测试和 rollback 测试。 8. 输出中是否能看到关键历史变量,例如塑性应变、损伤、孔隙率或等效黏度。 ## 常见问题 | 现象 | 可能原因 | 建议 | |---|---|---| | SPH 压力过大 | 声速、EOS 或参考密度不匹配 | 检查 `density`、`sound_speed`、`tait_B`。 | | 液体像泥浆 | 物理黏度或人工黏性过大 | 降低 `dynamic_viscosity` 或求解器黏性参数。 | | FEM 非线性不收敛 | 缺少一致切线或历史变量被污染 | 检查 `consistent_tangent` 和 commit/rollback。 | | 大变形应力异常 | 应力度量或客观应力率错误 | 检查 `deformation_gradient`、`objective_stress_rate`。 | | 塑性路径不对 | 屈服面参数或硬化参数错误 | 运行 J2/DP 单元级 benchmark。 | | 多孔压力不合理 | Biot、渗透率或孔压边界错误 | 先运行一维固结和排水/不排水测试。 |