Sorption Isotherm Gap Interface

Computes sorption isotherm interfacial conditions.

Overview

The SorptionIsothermGapInterface class is used to enforce sorption as described by a concentration-pressure proportionality across a continuous interface. Users can select between two interface configurations using the interface_configuration parameter: (1) solid-solid and (2) solid-gas.

Solid-Solid Interface Configuration

The solid-solid interface configuration is designed to model sorption between two solid surfaces, which are separated by a gas-filled gap. It enforces the constraint: (1) where is the partial pressure of a species in the gap that would result from concentration () and temperature () conditions at interface side . Partial pressures can be calculated using SorptionPartialPressure. Constraining equal partial pressures at the two solid surfaces implicitly assumes that species transport instantaneously across the gas-filled gap.

Solid-Gas Interface Configuration

The solid-gas interface configuration is designed to model sorption between a solid surface and a meshed, gas-filled gap.

commentnote:Boundary and interface kernel orientation conventions

By convention, the solid surface is assumed to be the primary side of the interface, and the gas is assumed to be the neighbor side of the interface. Mesh boundaries must be defined accordingly.

The following constraint, which is derived from the ideal gas law, is applied to solve for the concentration in the gas (): (2) Note that this interface configuration requires users must supply an additional solid surface temperature ().The partial pressure can be calculated using SorptionPartialPressure as above.

Mass Flux Balance

Both of the above interface configurations balance the mass flux across the gap using the following constraint: (3) where and are the mass flux and outward unit normal associated with interface side , respectively. This condition implicitly assumes that the surface areas of the two sides of the interface are equal.

is further defined as the Fickian diffusion flux according to (4) where and are the diffusion coefficient and concentration associated with species , respectively.

Two methods are available to enforce flux conditions at the interface. By default, SorptionIsothermGapInterface 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.

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

When using the default, non-penalty method to enforcing 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 SorptionIsothermGapInterface 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.

Example Input Syntax

Example input syntax using the solid-solid interface configuration is shown below.

[InterfaceKernels<<<{"href": "../../syntax/InterfaceKernels/index.html"}>>>]
  [interface]
    type = SorptionIsothermGapInterface<<<{"description": "Computes sorption isotherm interfacial conditions.", "href": "SorptionIsothermGapInterface.html"}>>>
    variable<<<{"description": "The name of the variable that this residual object operates on"}>>> = u
    neighbor_var<<<{"description": "The variable on the other side of the interface."}>>> = u
    interface_configuration<<<{"description": "The interface configuration solid_solid solid_gas"}>>> = solid_solid
    partial_pressure_name<<<{"description": "The name of the partial pressure if multiple partial pressure are defined on the same block"}>>> = partial_pressure
    sorption_penalty<<<{"description": "Penalty associated with the concentration imbalance"}>>> = 1e10
    boundary<<<{"description": "The list of boundaries (ids or names) from the mesh where this object applies"}>>> = Block1_Block2
  []
[]
(test/tests/sorption_interface/test.i)

Here, the partial pressures on the two sides of the interface are calculated using SorptionPartialPressure as shown below.

[Materials<<<{"href": "../../syntax/Materials/index.html"}>>>]
  [partial_pressure_1]
    type = SorptionPartialPressure<<<{"description": "Computes the sorption partial pressure of a solute in a material.", "href": "../materials/SorptionPartialPressure.html"}>>>
    A<<<{"description": "Temperature-independent coefficient of the intercept term in the concentration-pressure proportionality"}>>> = 19.3
    B<<<{"description": "Temperature-dependent coefficient of the intercept term in the concentration-pressure proportionality"}>>> = -47300
    D<<<{"description": "Temperature-independent coefficient of the order in the concentration-pressure proportionality"}>>> = 1.51
    E<<<{"description": "Temperature-dependent coefficient of the order in the concentration-pressure proportionality"}>>> = 4340
    d1<<<{"description": "Temperature-independent coefficient of the transition concentration"}>>> = 3.4
    d2<<<{"description": "Temperature-dependent coefficient of the transition concentration"}>>> = 6.15e-4
    unit_scale<<<{"description": "Unit conversion factor used to scale the concentration"}>>> = 1
    density<<<{"description": "Mass density of the material"}>>> = density
    concentration<<<{"description": "The coupled concentration variable"}>>> = u
    temperature<<<{"description": "The coupled temperature variable"}>>> = temperature
    block<<<{"description": "The list of blocks (ids or names) that this object will be applied"}>>> = 1
    outputs<<<{"description": "Vector of output names where you would like to restrict the output of variables(s) associated with this object"}>>> = 'all'
    output_properties<<<{"description": "List of material properties, from this material, to output (outputs must also be defined to an output type)"}>>> = partial_pressure
  []
[]
(test/tests/sorption_interface/test.i)
[Materials<<<{"href": "../../syntax/Materials/index.html"}>>>]
  [partial_pressure_2]
    type = SorptionPartialPressure<<<{"description": "Computes the sorption partial pressure of a solute in a material.", "href": "../materials/SorptionPartialPressure.html"}>>>
    A<<<{"description": "Temperature-independent coefficient of the intercept term in the concentration-pressure proportionality"}>>> = 24
    B<<<{"description": "Temperature-dependent coefficient of the intercept term in the concentration-pressure proportionality"}>>> = -35700
    D<<<{"description": "Temperature-independent coefficient of the order in the concentration-pressure proportionality"}>>> = -1.56
    E<<<{"description": "Temperature-dependent coefficient of the order in the concentration-pressure proportionality"}>>> = 6120
    d1<<<{"description": "Temperature-independent coefficient of the transition concentration"}>>> = 2.04
    d2<<<{"description": "Temperature-dependent coefficient of the transition concentration"}>>> = 1.79e-3
    unit_scale<<<{"description": "Unit conversion factor used to scale the concentration"}>>> = 1
    density<<<{"description": "Mass density of the material"}>>> = density
    concentration<<<{"description": "The coupled concentration variable"}>>> = u
    temperature<<<{"description": "The coupled temperature variable"}>>> = temperature
    block<<<{"description": "The list of blocks (ids or names) that this object will be applied"}>>> = 2
    outputs<<<{"description": "Vector of output names where you would like to restrict the output of variables(s) associated with this object"}>>> = 'all'
    output_properties<<<{"description": "List of material properties, from this material, to output (outputs must also be defined to an output type)"}>>> = partial_pressure
  []
[]
(test/tests/sorption_interface/test.i)

Input Parameters

  • interface_configurationsolid_solidThe interface configuration solid_solid solid_gas

    Default:solid_solid

    C++ Type:MooseEnum

    Options:solid_solid, solid_gas

    Controllable:No

    Description:The interface configuration solid_solid solid_gas

  • 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

  • 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

  • partial_pressure_namepartial_pressureThe name of the partial pressure if multiple partial pressure are defined on the same block

    Default:partial_pressure

    C++ Type:std::string

    Controllable:No

    Description:The name of the partial pressure if multiple partial pressure are defined on the same block

  • 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

  • temperatureThe coupled temperature variable

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

    Unit:(no unit assumed)

    Controllable:No

    Description:The coupled temperature variable

  • 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

References

No citations exist within this document.