ADMatInterfaceReactionZr2FeHxPCT

Implements a reaction to establish ReactionRate=k_f*u-k_b*v to compute the surface H concentration in Zr2FeHx from the temperature and partial pressure based on the PCT curves with u the concentration in the solid and v (neighbor) the concentration in the gas in mol/m^3.

Description

The composition of metal hydrides like zirconium-iron hydride (ZrFeH) is described by pressure-composition-temperature (PCT) data. In TMAP8, the PCT curve can be imposed by an interface kernel which then dictates the material composition. Wherein, the ADMatInterfaceReactionZr2FeHxPCT interface kernel imposes the surface concentration of H in ZrFeH based on the input pressure (Pa) and temperature (K). ADMatInterfaceReactionZr2FeHxPCT is related to ADMatInterfaceReaction, but incorporates the ZrFeH PCT curves. At the interface between a solid (main) and a gas (neighbor), it imposes: (1) where is the surface H concentration in mol/m, and are the backward and forward surface reaction rate in 1/s, respectively, is the composition in atomic fraction of H in ZrFeH given a gas temperature and gas pressure , and is the zirconium-iron molar density in mol/m. Note that the neighbor pressure is given as a molecular concentration (i.e., not an atomic concentration) and is converted to pressure within the interface kernel.

Figure 1 shows the experimental data from Yang et al. (2025) along with the TMAP8 fitts and simulation results.

PCT data for Zr$_{2}$FeH$_{x}$ from [!cite](yang2025potential) with fits implemented in TMAP8 and test results.

Figure 1: PCT data for ZrFeH from Yang et al. (2025) with fits implemented in TMAP8 and test results.

The pressure isotherm is captured as: (2)

with the pressure limit set to be a constant value written as (3)

The validity of this present fit is between: (4)

Test

(test/tests/Zr2Fe_hydrogen_system/Zr2FeHx_PCT.i) tests the implantation of the ZrFeH PCT curves in TMAP8 using constant testing conditions, i.e pressure and temperature. The domain contains two blocks: gas (left) and ZrFeH(right) with an interface between the two blocks. The diffusion is given by Yu et al. (2024) and the surface reaction rate is taken from Yang et al. (2025) (). Note that the diffusion is for ZrH because no diffusion data exist for ZrFeH. To model the interface, the input file employs the InterfaceDiffusion object to model the flux of hydrogen at the surface, and ADMatInterfaceReactionZr2FeHxPCT to model the steady-state condition for the hydrogen concentration at the surface defined by: (5)

The results of the high pressure test for (, ) =(598.15 K, Pa), (623.15 K, Pa), (648.15 K, Pa), and (648.15 K, Pa) are shown in Figure 1 and are a good fit.

Overall PCT Testing

(test/tests/Zr2Fe_hydrogen_system/Zr2FeHx_PCT.i) can also test the entire PCT modelling capabilities in TMAP8. The model follows the same structure as the previoius section, but has an arbitrarily high diffusion value to acheive steady-state quickly. The model also includes a linear pressure increase to cover the entire PCT curve.

The testing conditions include (, ) = (598.15 K, Pa), (623.15 K, Pa), and (648.15 K, Pa). The Figure 1 shows the PCT fit against the experimental data. Evidently, the fit exhibits moderate error, but the deviations remain within an acceptable range for modeling purposes.

Example Input File Syntax

[InterfaceKernels<<<{"href": "../../syntax/InterfaceKernels/index.html"}>>>]
  [interface_reaction_Zr2FeHx_PCT]
    type = ADMatInterfaceReactionZr2FeHxPCT<<<{"description": "Implements a reaction to establish ReactionRate=k_f*u-k_b*v to compute the surface H concentration in Zr2FeHx from the temperature and partial pressure based on the PCT curves with u the concentration in the solid and v (neighbor) the concentration in the gas in mol/m^3.", "href": "ADMatInterfaceReactionZr2FeHxPCT.html"}>>>
    variable<<<{"description": "The name of the variable that this residual object operates on"}>>> = concentration_H_enclosure_2
    neighbor_var<<<{"description": "The variable on the other side of the interface."}>>> = concentration_H_enclosure_1
    neighbor_temperature<<<{"description": "The variable on the other side of the interface for temperature (K)."}>>> = temperature
    density<<<{"description": "Density of the solid in (mol/m^3)."}>>> = ${density_Zr2Fe}
    boundary<<<{"description": "The list of boundaries (ids or names) from the mesh where this object applies"}>>> = interface_2
    forward_rate<<<{"description": "Forward reaction rate coefficient (1/s)."}>>> = 'reaction_rate_surface_Zr2FeHx'
    backward_rate<<<{"description": "Backward reaction rate coefficient (1/s)."}>>> = 'reaction_rate_surface_Zr2FeHx'
  []
[]
(test/tests/Zr2Fe_hydrogen_system/Zr2FeHx_PCT.i)

Input Parameters

  • neighbor_temperatureThe variable on the other side of the interface for temperature (K).

    C++ Type:std::vector<VariableName>

    Unit:(no unit assumed)

    Controllable:No

    Description:The variable on the other side of the interface for temperature (K).

  • neighbor_varThe variable on the other side of the interface.

    C++ Type:std::vector<VariableName>

    Unit:(no unit assumed)

    Controllable:No

    Description:The variable on the other side of the interface.

  • variableThe name of the variable that this residual object operates on

    C++ Type:NonlinearVariableName

    Unit:(no unit assumed)

    Controllable:No

    Description:The name of the variable that this residual object operates on

Required Parameters

  • backward_ratekbBackward reaction rate coefficient (1/s).

    Default:kb

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:Backward reaction rate coefficient (1/s).

  • boundaryThe list of boundaries (ids or names) from the mesh where this object applies

    C++ Type:std::vector<BoundaryName>

    Controllable:No

    Description:The list of boundaries (ids or names) from the mesh where this object applies

  • densitydensityDensity of the solid in (mol/m^3).

    Default:density

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:Density of the solid in (mol/m^3).

  • forward_ratekfForward reaction rate coefficient (1/s).

    Default:kf

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:Forward reaction rate coefficient (1/s).

Optional Parameters

  • absolute_value_vector_tagsThe tags for the vectors this residual object should fill with the absolute value of the residual contribution

    C++ Type:std::vector<TagName>

    Controllable:No

    Description:The tags for the vectors this residual object should fill with the absolute value of the residual contribution

  • extra_matrix_tagsThe extra tags for the matrices this Kernel should fill

    C++ Type:std::vector<TagName>

    Controllable:No

    Description:The extra tags for the matrices this Kernel should fill

  • extra_vector_tagsThe extra tags for the vectors this Kernel should fill

    C++ Type:std::vector<TagName>

    Controllable:No

    Description:The extra tags for the vectors this Kernel should fill

  • matrix_onlyFalseWhether this object is only doing assembly to matrices (no vectors)

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether this object is only doing assembly to matrices (no vectors)

  • matrix_tagssystemThe tag for the matrices this Kernel should fill

    Default:system

    C++ Type:MultiMooseEnum

    Options:nontime, system

    Controllable:No

    Description:The tag for the matrices this Kernel should fill

  • vector_tagsnontimeThe tag for the vectors this Kernel should fill

    Default:nontime

    C++ Type:MultiMooseEnum

    Options:nontime, time

    Controllable:No

    Description:The tag for the vectors this Kernel should fill

Contribution To Tagged Field Data Parameters

  • control_tagsAdds user-defined labels for accessing object parameters via control logic.

    C++ Type:std::vector<std::string>

    Controllable:No

    Description:Adds user-defined labels for accessing object parameters via control logic.

  • enableTrueSet the enabled status of the MooseObject.

    Default:True

    C++ Type:bool

    Controllable:Yes

    Description:Set the enabled status of the MooseObject.

  • implicitTrueDetermines whether this object is calculated using an implicit or explicit form

    Default:True

    C++ Type:bool

    Controllable:No

    Description:Determines whether this object is calculated using an implicit or explicit form

  • seed0The seed for the master random number generator

    Default:0

    C++ Type:unsigned int

    Controllable:No

    Description:The seed for the master random number generator

  • use_displaced_meshFalseWhether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

Advanced Parameters

  • diag_save_inThe name of auxiliary variables to save this Kernel's diagonal Jacobian contributions to. Everything about that variable must match everything about this variable (the type, what blocks it's on, etc.)

    C++ Type:std::vector<AuxVariableName>

    Unit:(no unit assumed)

    Controllable:No

    Description:The name of auxiliary variables to save this Kernel's diagonal Jacobian contributions to. Everything about that variable must match everything about this variable (the type, what blocks it's on, etc.)

  • diag_save_in_var_sideThis parameter must exist if diag_save_in variables are specified and must have the same length as diag_save_in. This vector specifies whether the corresponding aux_var should save-in jacobian contributions from the primary ('p') or secondary side ('s').

    C++ Type:MultiMooseEnum

    Options:m, s

    Controllable:No

    Description:This parameter must exist if diag_save_in variables are specified and must have the same length as diag_save_in. This vector specifies whether the corresponding aux_var should save-in jacobian contributions from the primary ('p') or secondary side ('s').

  • save_inThe name of auxiliary variables to save this Kernel's residual contributions to. Everything about that variable must match everything about this variable (the type, what blocks it's on, etc.)

    C++ Type:std::vector<AuxVariableName>

    Unit:(no unit assumed)

    Controllable:No

    Description:The name of auxiliary variables to save this Kernel's residual contributions to. Everything about that variable must match everything about this variable (the type, what blocks it's on, etc.)

  • save_in_var_sideThis parameter must exist if save_in variables are specified and must have the same length as save_in. This vector specifies whether the corresponding aux_var should save-in residual contributions from the primary ('p') or secondary side ('s').

    C++ Type:MultiMooseEnum

    Options:m, s

    Controllable:No

    Description:This parameter must exist if save_in variables are specified and must have the same length as save_in. This vector specifies whether the corresponding aux_var should save-in residual contributions from the primary ('p') or secondary side ('s').

Residual And Jacobian Debug Output Parameters

  • prop_getter_suffixAn optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:An optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.

  • use_interpolated_stateFalseFor the old and older state use projected material properties interpolated at the quadrature points. To set up projection use the ProjectedStatefulMaterialStorageAction.

    Default:False

    C++ Type:bool

    Controllable:No

    Description:For the old and older state use projected material properties interpolated at the quadrature points. To set up projection use the ProjectedStatefulMaterialStorageAction.

Material Property Retrieval Parameters

Input Files

References

  1. Zhiyi Yang, Yuxiao Jia, Yang Liu, Xuezhang Xiao, Tiao Ying, Xingwen Feng, Yan Shi, Changan Chen, Wenhua Luo, and Lixin Chen. A potential hydrogen isotope storage material Zr2Fe: deep exploration on phase transition behaviors and disproportionation mechanism. Energy Materials, 5(1):500011, Jan 2025. doi:10.20517/energymater.2024.83.[Export]
  2. Feifei Yu, Xia Xiang, Xiaotao Zu, and Shuanglin Hu. Hydrogen diffusion in zirconium hydrides from on-the-fly machine learning molecular dynamics. International Journal of Hydrogen Energy, 56:1057–1066, Feb 2024. doi:10.1016/j.ijhydene.2023.12.241.[Export]