17 KiB
材料库
材料模块位于 material/,同时服务 FEM 和 SPH。
材料配置
内置材料通常放在:
material/builtin_materials.xml
求解器中引用:
<Materials>
<MaterialLibrary path="material/builtin_materials.xml" />
<Material id="7" key="water.newtonian" />
</Materials>
粒子或单元通过 material_id / material 与材料表关联。
材料文件结构
内置材料库根节点为:
<?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 |
体积模量。 |
示例:
<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 和路径测试使用,避免迭代失败污染历史状态。
示例:
<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 斜率参数。 |
水体示例:
<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 中也可通过求解器参数覆盖压力模型,例如:
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_gradientprevious_deformation_gradientvelocity_gradientrotationspinobjective_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 记录如下,用户可以复制后修改参数形成项目材料库:
<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:
<Material id="7" key="water.newtonian" />
对于调试用弱可压案例,也可以在求解器中覆盖压力模型:
pressure_eos="linear_reference"
液滴、自由面和小尺度表面张力案例需要同时校准:
speed_of_soundsurface_tensiondensity_filterparticle_regularizationartificial_viscosity
流体黏性参数:
| 参数 | 说明 |
|---|---|
dynamic_viscosity |
动力黏度,单位 Pa*s。 |
density |
密度,用于换算运动黏度。 |
bulk_modulus |
体积模量,可用于弱可压模型。 |
eos |
状态方程。 |
若液体看起来像泥浆,优先检查物理黏度、人工黏性和边界阻尼,而不是只调表面张力。
FEM 材料建议
线弹性材料适合先验证装配、约束和载荷;非线性材料建议按以下顺序逐步开启:
- 单元级单调加载。
- 卸载/反向加载。
- 多步非比例加载。
- line search 和 commit/rollback。
- 大变形或接触耦合。
推荐验证顺序:
| 材料 | 最小验证 |
|---|---|
| 线弹性 | 单轴拉伸、压缩、patch test。 |
| 超弹性 | 单轴大拉伸、简单剪切、纯旋转零应力。 |
| J2 塑性 | 单调拉伸、卸载/反向加载。 |
| Drucker-Prager | 不同围压三轴压缩。 |
| 损伤 | 单轴拉伸软化和能量耗散。 |
| 多孔材料 | Terzaghi 固结、排水/不排水压缩。 |
非牛顿流体
SPH 可扩展常见非牛顿模型:
- Bingham。
- Herschel-Bulkley。
- Carreau。
- 剪切变稀/剪切增稠。
- 屈服应力流体。
使用这些模型时,建议输出等效黏度场,便于判断局部剪切率和黏度是否合理。
GPU 材料路径
GPU 材料路径应使用紧凑描述符和历史变量缓冲:
- 材料常量进入
GPUMaterialDescriptor。 - 积分点状态进入 GPU 常驻状态缓冲。
- 显式动力学优先使用 GPU 更新。
- 隐式非线性还需要 GPU 一致切线、commit/rollback 和装配链配合。
若材料没有 gpu_update 能力,应在 GPU 求解路径中给出明确诊断或回退 CPU。
修改材料参数的检查清单
- 单位是否为 SI。
density是否与几何尺度、重力和时间步匹配。- 弹性参数是否满足物理约束,例如
0 <= poisson_ratio < 0.5。 - 超弹性体积模量是否足够大但不过度导致锁定。
- 屈服应力和硬化模量是否符合目标材料。
- EOS 声速和 Tait 参数是否和 SPH 时间步匹配。
- 非线性材料是否有路径测试和 rollback 测试。
- 输出中是否能看到关键历史变量,例如塑性应变、损伤、孔隙率或等效黏度。
常见问题
| 现象 | 可能原因 | 建议 |
|---|---|---|
| SPH 压力过大 | 声速、EOS 或参考密度不匹配 | 检查 density、sound_speed、tait_B。 |
| 液体像泥浆 | 物理黏度或人工黏性过大 | 降低 dynamic_viscosity 或求解器黏性参数。 |
| FEM 非线性不收敛 | 缺少一致切线或历史变量被污染 | 检查 consistent_tangent 和 commit/rollback。 |
| 大变形应力异常 | 应力度量或客观应力率错误 | 检查 deformation_gradient、objective_stress_rate。 |
| 塑性路径不对 | 屈服面参数或硬化参数错误 | 运行 J2/DP 单元级 benchmark。 |
| 多孔压力不合理 | Biot、渗透率或孔压边界错误 | 先运行一维固结和排水/不排水测试。 |