Files
MDHelper/docs/material_manual.md
T
2026-05-25 17:12:00 +08:00

486 lines
17 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 材料库
材料模块位于 `material/`,同时服务 FEM 和 SPH。
## 材料配置
内置材料通常放在:
```text
material/builtin_materials.xml
```
求解器中引用:
```xml
<Materials>
<MaterialLibrary path="material/builtin_materials.xml" />
<Material id="7" key="water.newtonian" />
</Materials>
```
粒子或单元通过 `material_id` / `material` 与材料表关联。
## 材料文件结构
内置材料库根节点为:
```xml
<?xml version="1.0" encoding="UTF-8"?>
<M3FrameBuiltinMaterials version="1.0">
<Material id="1" key="steel.linear_elastic"
kind="solid"
response="linear_elastic"
density="7850"
young_modulus="210e9"
poisson_ratio="0.30" />
</M3FrameBuiltinMaterials>
```
常用关键词:
| 关键词 | 说明 |
|---|---|
| `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
<Material id="4" key="rubber.neo_hookean"
kind="solid"
response="hyper_elastic"
hyperelastic_model="neo_hookean"
density="1100"
shear_modulus="0.6e6"
bulk_modulus="2.0e9" />
```
## 塑性与损伤参数
常用塑性参数:
| 参数 | 说明 |
|---|---|
| `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
<Material id="12" key="steel.finite_j2"
kind="solid"
response="finite_plasticity"
finite_plasticity_model="j2_multiplicative"
objective_stress_rate="jaumann"
density="7850"
young_modulus="210e9"
poisson_ratio="0.30"
yield_stress="350e6"
hardening_modulus="1.0e9" />
```
## 多孔材料参数
多孔弹塑性材料用于渗流-变形耦合。常用内部参数包括:
| 参数 | 说明 |
|---|---|
| `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
<Material id="7" key="water.newtonian"
kind="fluid"
response="newtonian_fluid"
density="1000"
bulk_modulus="2.2e9"
dynamic_viscosity="1.0e-3"
eos="tait"
gamma="7.0"
tait_B="3.14e8"
reference_pressure="0" />
```
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
<M3FrameBuiltinMaterials version="1.0">
<Material id="1" key="steel.linear_elastic"
kind="solid" response="linear_elastic"
density="7850" young_modulus="210e9" poisson_ratio="0.30" />
<Material id="2" key="aluminum.linear_elastic"
kind="solid" response="linear_elastic"
density="2700" young_modulus="70e9" poisson_ratio="0.33" />
<Material id="3" key="concrete.linear_elastic"
kind="solid" response="linear_elastic"
density="2400" young_modulus="30e9" poisson_ratio="0.20" />
<Material id="4" key="rubber.neo_hookean"
kind="solid" response="hyper_elastic"
hyperelastic_model="neo_hookean"
density="1100" shear_modulus="0.6e6" bulk_modulus="2.0e9" />
<Material id="5" key="steel.j2_damage"
kind="solid" response="elastoplastic_damage"
density="7850" young_modulus="210e9" poisson_ratio="0.30"
yield_stress="350e6" hardening_modulus="1.0e9" />
<Material id="6" key="soil.porous_elastoplastic_damage"
kind="porous_solid" response="porous_elastoplastic_damage"
density="1800" young_modulus="50e6" poisson_ratio="0.30" />
<Material id="7" key="water.newtonian"
kind="fluid" response="newtonian_fluid"
density="1000" bulk_modulus="2.2e9"
dynamic_viscosity="1.0e-3"
eos="tait" gamma="7.0" tait_B="3.14e8"
reference_pressure="0" />
<Material id="8" key="air.newtonian"
kind="fluid" response="newtonian_fluid"
density="1.225" bulk_modulus="1.42e5"
dynamic_viscosity="1.8e-5"
eos="ideal_gas" gamma="1.4" gas_constant="287.05"
reference_pressure="0" />
<Material id="9" key="rubber.mooney_rivlin"
kind="solid" response="hyper_elastic"
hyperelastic_model="mooney_rivlin"
density="1120" bulk_modulus="2.0e9"
c10="0.35e6" c01="0.08e6" />
<Material id="10" key="rubber.yeoh"
kind="solid" response="hyper_elastic"
hyperelastic_model="yeoh"
density="1120" bulk_modulus="2.0e9"
c10="0.30e6" c20="0.02e6" c30="0.001e6" />
<Material id="11" key="soft_tissue.ogden"
kind="solid" response="hyper_elastic"
hyperelastic_model="ogden"
density="1050" shear_modulus="0.08e6" bulk_modulus="1.0e9"
ogden_mu1="0.08e6" ogden_alpha1="2.5"
ogden_mu2="0.01e6" ogden_alpha2="6.0" />
<Material id="12" key="steel.finite_j2"
kind="solid" response="finite_plasticity"
finite_plasticity_model="j2_multiplicative"
objective_stress_rate="jaumann"
density="7850" young_modulus="210e9" poisson_ratio="0.30"
yield_stress="350e6" hardening_modulus="1.0e9" />
<Material id="13" key="aluminum.finite_j2_rate"
kind="solid" response="finite_plasticity"
finite_plasticity_model="j2_rate"
objective_stress_rate="green_naghdi"
density="2700" young_modulus="70e9" poisson_ratio="0.33"
yield_stress="250e6" hardening_modulus="0.5e9" />
<Material id="14" key="soil.finite_drucker_prager"
kind="solid" response="finite_plasticity"
finite_plasticity_model="drucker_prager"
objective_stress_rate="jaumann"
density="1900" young_modulus="80e6" poisson_ratio="0.30"
yield_stress="0.15e6" hardening_modulus="1.0e6"
pressure_friction="0.35" pressure_dilation="0.05"
cohesion="0.12e6" />
</M3FrameBuiltinMaterials>
```
使用建议:
- SPH 水体优先从 `water.newtonian` 开始,再在 `sph_solver.xml` 中调整声速、EOS 和黏性。
- 橡胶球、接触回弹等大变形 FEM 案例优先从 `rubber.neo_hookean` 开始。
- J2、Drucker-Prager、损伤材料必须先跑材料路径 benchmark,再进入结构级案例。
## SPH 材料建议
水体 WCSPH 常用 Tait EOS:
```xml
<Material id="7" key="water.newtonian" />
```
对于调试用弱可压案例,也可以在求解器中覆盖压力模型:
```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、渗透率或孔压边界错误 | 先运行一维固结和排水/不排水测试。 |