ADMatInterfaceReactionYHxPCT

Implements a reaction to establish ReactionRate=k_f*u-k_b*v to compute the surface H concentration in YHx 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 yttrium hydride (YHx) is described by pressure-composition-temperature (PCT) data. In TMAP8, the PCT curve can be imposed by an interface kernel that then dictates the material composition. Hence, the ADMatInterfaceReactionYHxPCT interface kernel imposes the surface concentration of H in YHx based on the input pressure (Pa) and temperature (K). ADMatInterfaceReactionYHxPCT is related to ADMatInterfaceReaction, but includes the YHx 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 YHx given a gas temperature and gas pressure , and is the yttrium atomic density in mol/m.

Figure 1 shows the data used in this interface kernel. The experimental data originates from Lundin and Blackledge (1962), and the fit is from Matthews et al. (2021).

Figure 1: PCT data for YHx from Lundin and Blackledge (1962) with fits from Matthews et al. (2021) implemented in TMAP8, and test results.

The plateau representing phase transition is captured as (Matthews et al., 2021): (2) with being the hydrogen partial pressure limit delineating the plateau in Pa and being the temperature in K. This fit is shown in Figure 2.

Figure 2: Fit phase transition region as pressure as a function of temperature.

The model currently only captures the high pressure region of the data, i.e., for pressure and temperatures above the plateau. In this region, the atomic fraction is determined as (Matthews et al., 2021): (3) where is the hydrogen partial pressure in Pa. This fit is plotted in Figure 1.

The "silence_warnings" option can be used to dictate how TMAP8 reacts when the pressure gets out of bounds. If silence_warnings = false, which is the default behavior, then TMAP8 will print a warning stating that the pressure and temperature are outside the bounds of the atomic fraction correlation. If silence_warnings = true, then TMAP8 will let the simulation continue without issuing any warnings.

Test

(test/tests/yttrium_hydrogen_system/YHx_PCT.i) tests the implantation of the YHx PCT curves in TMAP8. The domain contains two blocks: gas (left) and YHx (right) with an interface between the two blocks. The diffusion is given by (Majer et al., 2002) and the surface reaction rate is taken from (Fisher and Tanase, 1984) (). To model the interface, the input file employs the InterfaceDiffusion object to model the flux of hydrogen at the surface, and ADMatInterfaceReactionYHxPCT to model the steady-state condition for the hydrogen concentration at the surface defined by: (4) where is the yttrium atomic density.

The results of the test for (, ) = (1173.15 K, Pa), (1173.15 K, Pa), (1173.15 K, Pa), and(1473.15 K, Pa) are shown in Figure 1 and show good agreement with Eq. (3).

Example Input File Syntax

[InterfaceKernels<<<{"href": "../../syntax/InterfaceKernels/index.html"}>>>]
  [interface_reaction_YHx_PCT]
    type = ADMatInterfaceReactionYHxPCT<<<{"description": "Implements a reaction to establish ReactionRate=k_f*u-k_b*v to compute the surface H concentration in YHx 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": "ADMatInterfaceReactionYHxPCT.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_Y}
    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_YHx'
    backward_rate<<<{"description": "Backward reaction rate coefficient (1/s)."}>>> = 'reaction_rate_surface_YHx'
  []
[]
(test/tests/yttrium_hydrogen_system/YHx_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).

  • 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)

  • silence_warningsFalseWhether to silence correlation out of bound warnings

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether to silence correlation out of bound warnings

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_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. P. W. Fisher and M. Tanase. Diffusivities of hydrogen in yttrium and yttrium alloys. Journal of Nuclear Materials, 123(1):1536–1540, 1984. URL: https://www.sciencedirect.com/science/article/pii/0022311584902976, doi:https://doi.org/10.1016/0022-3115(84)90297-6.[BibTeX]
  2. C. E. Lundin and J. P. Blackledge. Pressure‐temperature‐composition relationships of the yttrium‐hydrogen system. Journal of The Electrochemical Society, 109(9):838, sep 1962. URL: https://dx.doi.org/10.1149/1.2425565, doi:10.1149/1.2425565.[BibTeX]
  3. G. Majer, J. Gottwald, D. T. Peterson, and R. G. Barnes. Model-independent measurements of hydrogen diffusivity in the yttrium dihydrides. Journal of Alloys and Compounds, 330-332:438–442, 2002. Proceedings of the International Symposium on Metal-Hydrogen Systems, Fundamentals and Applications (MH2000). URL: https://www.sciencedirect.com/science/article/pii/S0925838801014529, doi:https://doi.org/10.1016/S0925-8388(01)01452-9.[BibTeX]
  4. C. Matthews, Shivprasad A. P., and Cooper M. W. D. Metal Hydride Simulations Using SWIFT. Technical Report LA-UR-21-27538, Los Alamos National Laboratory, Los Alamos, NM (United States), 2021.[BibTeX]