DielectricBCWithEffEfield

Time integrated dielectric boundary condition (Based on Lymberopoulos and Economou (1994))

Overview

DielectricBCWithEffEfield is a type of NeumannBC for the potential on the boundary of a grounded ideal dielectric. The advection term for the ion is determined by an effective electric field.

The potential at the boundary of a grounded ideal dielectric is defined as

where

  • is the permittivity of the dielectric,

  • is the thickness of the dielectric,

  • is the voltage on the dielectric,

  • is the normal to the boundary,

  • is the elemental charge,

  • is the permittivity of free space,

  • is the electric field normal to the dielectric,

  • is the electron outflow flux, and

  • is the ion outflow flux.

commentnote:Flux Information

and are defined with the SakiyamaElectronDiffusionBC, SakiyamaSecondaryElectronWithEffEfieldBC and SakiyamaIonAdvectionWithEffEfieldBC (please refer to those BC's for more information on the fluxes).

To convert the above equation into the form of a NeumannBC, the time integral is taken such that:

Using the trapezoidal rule for the definite integral and rearranging the equation such that the electric field term is on one side results in:

where

  • The subscript is the value of the variable during the previous time step, and

  • is the current time step size.

Lastly, the electrostatic approximation is applied to the electric field normal to the dielectric, which results in a NeumannBC for the potential defined as:

Example Input File Syntax

[BCs]
  [potential_left_BC]
    type = DielectricBCWithEffEfield
    variable = potential
    electrons = em
    electron_energy = mean_en
    ions = 'ion'
    Ex = Ex
    Ey = Ey
    dielectric_constant = 1.0
    thickness = 1.0
    emission_coeffs = 'users_gamma'
    potential_units = V
    position_units = 1.0
    boundary = 3
  []
[]
(test/tests/mms/bcs/2D_DielectricBCWithEffEfield.i)

Input Parameters

  • ExThe EField in the x-direction

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

    Unit:(no unit assumed)

    Controllable:No

    Description:The EField in the x-direction

  • boundaryThe list of boundary IDs from the mesh where this object applies

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

    Controllable:No

    Description:The list of boundary IDs from the mesh where this object applies

  • dielectric_constantThe dielectric constant of the material.

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:The dielectric constant of the material.

  • electron_energyThe mean energy.

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

    Unit:(no unit assumed)

    Controllable:No

    Description:The mean energy.

  • electronsThe electron density.

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

    Unit:(no unit assumed)

    Controllable:No

    Description:The electron density.

  • ionsA list of ion densities in log form

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

    Unit:(no unit assumed)

    Controllable:No

    Description:A list of ion densities in log form

  • position_unitsUnits of position.

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Units of position.

  • potential_unitsThe potential units.

    C++ Type:std::string

    Controllable:No

    Description:The potential units.

  • thicknessThe thickness of the material.

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:The thickness of the material.

  • 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

  • EyThe EField in the y-direction

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

    Unit:(no unit assumed)

    Controllable:No

    Description:The EField in the y-direction

  • EzThe EField in the z-direction

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

    Unit:(no unit assumed)

    Controllable:No

    Description:The EField in the z-direction

  • displacementsThe displacements

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

    Unit:(no unit assumed)

    Controllable:No

    Description:The displacements

  • emission_coeffsThe secondary electron emission coefficient for each ion provided in `ions`

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

    Controllable:No

    Description:The secondary electron emission coefficient for each ion provided in `ions`

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.

  • diag_save_inThe name of auxiliary variables to save this BC'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 BC's diagonal jacobian contributions to. Everything about that variable must match everything about this variable (the type, what blocks it's on, etc.)

  • 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

  • save_inThe name of auxiliary variables to save this BC'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 BC's residual contributions to. Everything about that variable must match everything about this variable (the type, what blocks it's on, etc.)

  • 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

  • skip_execution_outside_variable_domainFalseWhether to skip execution of this boundary condition when the variable it applies to is not defined on the boundary. This can facilitate setups with moving variable domains and fixed boundaries. Note that the FEProblem boundary-restricted integrity checks will also need to be turned off if using this option

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether to skip execution of this boundary condition when the variable it applies to is not defined on the boundary. This can facilitate setups with moving variable domains and fixed boundaries. Note that the FEProblem boundary-restricted integrity checks will also need to be turned off if using this option

  • 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

  • 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. Dimitris P Lymberopoulos and Demetre J Economou. Modeling and simulation of glow discharge plasma reactors. Journal of Vacuum Science & Technology A: Vacuum, Surfaces, and Films, 12(4):1229–1236, 1994. doi:10.1116/1.579300.[BibTeX]