ADInterfaceSorption / InterfaceSorption

Computes a sorption law at interface between solid and gas in isothermal conditions.

Description

The surface concentrations in the solid are related to the partial pressure (and corresponding gas concentration assuming ideal gas behavior) of the neighboring gas by the interface sorption law: where is the ideal gas constant in J/mol/K, is the temperature in K, is the solubility, and is the exponent of the sorption law. is described as an Arrhenius equation: where is the pre-exponential constant, and is the activation energy in J/mol. The units of and depend on the units of and , as well as the value of .

The value of determines the sorption law. For example:

  • corresponds to Henry's law

  • corresponds to Sievert's law.

A penalty is applied to enforce the sorption law at the interface. Note that solubilities in the literature may only be compatible with concentrations expressed in certain units, and those units may differ from those used elsewhere in the simulation, e.g., versus . The model accepts concentration unit conversion factors ("unit_scale" and "unit_scale_neighbor") to accommodate data from different sources. For example, unit conversion factors of can be supplied to accommodate sets of solubilities for concentrations in . Note that for multi-atomic molecules, it is important to specify if the moles correspond to the moles of gas molecules, or the moles of atoms. The model assumes that the units associated with the partial pressures are equal and that all constants are compatible with absolute temperature.

To balance the mass flux across the gap, a second interfacial condition is given as:

(1) where and are the diffusivities in the solid and the gas, respectively, and and are the normals at the interface. Two methods are available to enforce flux conditions at the interface. By default, InterfaceSorption applies the flux at the primary side of the interface to the residual on the neighbor side of the interface. Using a kernel such as MatDiffusion on the neighbor block adds the flux at the neighbor side of the interface to the residual, forming the full flux balance condition shown in the equation above.

warningwarning:Enforcing flux conditions using the default, non-penalty method

When using the default, non-penalty method to enforce flux conditions at the interface, a kernel such as MatDiffusion must be applied to the neighbor block to form the correct residual.

Optionally, a penalty can be applied within InterfaceSorption to directly enforce the full flux condition at the interface. The penalty method adds the correct residual to the neighbor side of the interface without requiring a second kernel, but it may over-constrain the problem under certain conditions.

Note that the unit conversion factors ("unit_scale" and "unit_scale_neighbor") do not apply to the flux equation to ensure mass conservation.

Input File Usage Example

[InterfaceKernels<<<{"href": "../../syntax/InterfaceKernels/index.html"}>>>]
  [interface]
    type = InterfaceSorption<<<{"description": "Computes a sorption law at interface between solid and gas in isothermal conditions.", "href": "InterfaceSorption.html"}>>>
    K0<<<{"description": "The pre-exponential factor for the Arrhenius law for the solubility $K$ for the relationship $C_i = KP_i^n$"}>>> = ${solubility}
    Ea<<<{"description": "The activation energy for the Arrhenius law for the solubility $K$ for the relationship $C_i = KP_i^n$"}>>> = 0
    n_sorption<<<{"description": "The exponent $n$ for the relationship $C_i = KP_i^n$"}>>> = ${n_sorption}
    diffusivity<<<{"description": "The diffusion coefficient"}>>> = diffusivity
    unit_scale<<<{"description": "Unit conversion factor used to scale the concentration"}>>> = ${unit_scale}
    unit_scale_neighbor<<<{"description": "Unit conversion factor used to scale the neighbor (gas) concentration"}>>> = ${unit_scale_neighbor}
    temperature<<<{"description": "The coupled temperature variable"}>>> = temperature
    variable<<<{"description": "The name of the variable that this residual object operates on"}>>> = u2
    neighbor_var<<<{"description": "The variable on the other side of the interface."}>>> = u1
    sorption_penalty<<<{"description": "Penalty associated with the concentration imbalance"}>>> = 1e1
    boundary<<<{"description": "The list of boundaries (ids or names) from the mesh where this object applies"}>>> = interface2
  []
[]
(test/tests/interfacekernels/InterfaceSorption/interface_sorption.i)

Input Parameters

  • K0The pre-exponential factor for the Arrhenius law for the solubility $K$ for the relationship $C_i = KP_i^n$

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:The pre-exponential factor for the Arrhenius law for the solubility $K$ for the relationship $C_i = KP_i^n$

  • n_sorptionThe exponent $n$ for the relationship $C_i = KP_i^n$

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:The exponent $n$ for the relationship $C_i = KP_i^n$

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

  • temperatureThe coupled temperature variable

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

    Unit:(no unit assumed)

    Controllable:No

    Description:The coupled temperature variable

  • 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

  • Ea0The activation energy for the Arrhenius law for the solubility $K$ for the relationship $C_i = KP_i^n$

    Default:0

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:The activation energy for the Arrhenius law for the solubility $K$ for the relationship $C_i = KP_i^n$

  • 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

  • diffusivitydiffusivityThe diffusion coefficient

    Default:diffusivity

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:The diffusion coefficient

  • flux_penalty1Penalty associated with the flux balance

    Default:1

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Penalty associated with the flux balance

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

  • sorption_penalty1Penalty associated with the concentration imbalance

    Default:1

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Penalty associated with the concentration imbalance

  • unit_scale1Unit conversion factor used to scale the concentration

    Default:1

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Unit conversion factor used to scale the concentration

  • unit_scale_neighbor1Unit conversion factor used to scale the neighbor (gas) concentration

    Default:1

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Unit conversion factor used to scale the neighbor (gas) concentration

  • use_flux_penaltyFalseWhether to use the penalty formulation to enforce the flux balance

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether to use the penalty formulation to enforce the flux balance

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