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

17 KiB
Raw Blame History

材料库

材料模块位于 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_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 记录如下,用户可以复制后修改参数形成项目材料库:

<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_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、渗透率或孔压边界错误 先运行一维固结和排水/不排水测试。