ElectrochemicalSinteringMaterial

Defines switching functions and thermodynamic parameters for the electrochemical grand potential sintering model. In this model, an arbitrary number of charged defect species can exist. The ElectrochemicalSinteringMaterial defines switching functions for void and solid phases as well as switching functions for solid and grain boundary regions. It also defines the grand potential densities, and the phase field free energy terms , , and . For each defect species, an ElectrochemicalDefectMaterial object must also be included to calculate the susceptibility and densities in each phase.

There are two energy models that can be used for the solid phase: parabolic () and dilute (). The void phase uses a parabolic free energy. There is also a contribution to the grand potential from the electric potential of the form .

The equilibrium solid-phase vacancy concentrations for defect species are determined in separate materials and need to be supplied to this one. This is done to maximize the flexibility of the sintering model to include effects such as GB vacancy segregation and stoichiometry effects.

Input Parameters

  • TemperatureName of the temperature variable with units of K

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

    Controllable:No

    Description:Name of the temperature variable with units of K

  • chemical_potentialsThe name of the chemical potential variables for defects

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

    Controllable:No

    Description:The name of the chemical potential variables for defects

  • defect_chargesVector of charges of defect species. Place in same order as chemical_potentials!

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

    Controllable:No

    Description:Vector of charges of defect species. Place in same order as chemical_potentials!

  • electric_potentialName of the electric potential variable with units of V

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

    Controllable:No

    Description:Name of the electric potential variable with units of V

  • etasArray of order parameters that describe solid phase

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

    Controllable:No

    Description:Array of order parameters that describe solid phase

  • min_vacancy_concentrations_solidVector of names of materials that determine the minimum in energy wrt defect concentrations in the solid phase. Place in same order as chemical_potentials!

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

    Controllable:No

    Description:Vector of names of materials that determine the minimum in energy wrt defect concentrations in the solid phase. Place in same order as chemical_potentials!

  • min_vacancy_concentrations_voidVector of minima in energy wrt defect concentrations in the void phase. Place in same order as chemical_potentials!

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

    Controllable:No

    Description:Vector of minima in energy wrt defect concentrations in the void phase. Place in same order as chemical_potentials!

  • solid_relative_permittivitySolid phase relative permittivity (dimensionless)

    C++ Type:double

    Controllable:No

    Description:Solid phase relative permittivity (dimensionless)

  • void_energy_coefficientsVector of parabolic void energy coefficients (energy*volume) for each defect species. Place in same order as chemical_potentials!

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

    Controllable:No

    Description:Vector of parabolic void energy coefficients (energy*volume) for each defect species. Place in same order as chemical_potentials!

  • void_opThe name of the void phase order parameter

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

    Controllable:No

    Description:The name of the void phase order parameter

Required Parameters

  • blockThe list of blocks (ids or names) that this object will be applied

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

    Controllable:No

    Description:The list of blocks (ids or names) that this object will be applied

  • 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

  • computeTrueWhen false, MOOSE will not call compute methods on this material. The user must call computeProperties() after retrieving the MaterialBase via MaterialBasePropertyInterface::getMaterialBase(). Non-computed MaterialBases are not sorted for dependencies.

    Default:True

    C++ Type:bool

    Controllable:No

    Description:When false, MOOSE will not call compute methods on this material. The user must call computeProperties() after retrieving the MaterialBase via MaterialBasePropertyInterface::getMaterialBase(). Non-computed MaterialBases are not sorted for dependencies.

  • constant_onNONEWhen ELEMENT, MOOSE will only call computeQpProperties() for the 0th quadrature point, and then copy that value to the other qps.When SUBDOMAIN, MOOSE will only call computeQpProperties() for the 0th quadrature point, and then copy that value to the other qps. Evaluations on element qps will be skipped

    Default:NONE

    C++ Type:MooseEnum

    Options:NONE, ELEMENT, SUBDOMAIN

    Controllable:No

    Description:When ELEMENT, MOOSE will only call computeQpProperties() for the 0th quadrature point, and then copy that value to the other qps.When SUBDOMAIN, MOOSE will only call computeQpProperties() for the 0th quadrature point, and then copy that value to the other qps. Evaluations on element qps will be skipped

  • declare_suffixAn optional suffix parameter that can be appended to any declared properties. The suffix will be prepended with a '_' character.

    C++ Type:MaterialPropertyName

    Controllable:No

    Description:An optional suffix parameter that can be appended to any declared properties. The suffix will be prepended with a '_' character.

  • grainboundary_energy9.86Grain boundary energy in units of problem (energy/area)

    Default:9.86

    C++ Type:double

    Controllable:No

    Description:Grain boundary energy in units of problem (energy/area)

  • int_width1Interface width in units of problem (length)

    Default:1

    C++ Type:double

    Controllable:No

    Description:Interface width in units of problem (length)

  • op_numArray of order parameters that describe solid phase (num_name)

    C++ Type:unsigned int

    Controllable:No

    Description:Array of order parameters that describe solid phase (num_name)

  • 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

    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.

  • solid_energy_coefficientsVector of parabolic solid energy coefficients (energy*volume) for each defect species. Only used for parabolic energy. Place in same order as chemical_potentials!

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

    Controllable:No

    Description:Vector of parabolic solid energy coefficients (energy*volume) for each defect species. Only used for parabolic energy. Place in same order as chemical_potentials!

  • solid_energy_modelPARABOLICType of energy function to use for the solid phase.

    Default:PARABOLIC

    C++ Type:MooseEnum

    Options:PARABOLIC, DILUTE, IDEAL

    Controllable:No

    Description:Type of energy function to use for the solid phase.

  • surface_energy19.7Surface energy in units of problem (energy/area)

    Default:19.7

    C++ Type:double

    Controllable:No

    Description:Surface energy in units of problem (energy/area)

  • surface_switch_value0.3Value between 0 and 1 that determines when the interface begins to switch from surface to GB. Small values give less error while large values converge better.

    Default:0.3

    C++ Type:double

    Controllable:No

    Description:Value between 0 and 1 that determines when the interface begins to switch from surface to GB. Small values give less error while large values converge better.

  • var_name_baseArray of order parameters that describe solid phase (base_name)

    C++ Type:std::string

    Controllable:No

    Description:Array of order parameters that describe solid phase (base_name)

  • voltage_scale1Voltage scale (default is for voltage in V)

    Default:1

    C++ Type:double

    Controllable:No

    Description:Voltage scale (default is for voltage in V)

Optional 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

  • output_propertiesList of material properties, from this material, to output (outputs must also be defined to an output type)

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

    Controllable:No

    Description:List of material properties, from this material, to output (outputs must also be defined to an output type)

  • outputsnone Vector of output names where you would like to restrict the output of variables(s) associated with this object

    Default:none

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

    Controllable:No

    Description:Vector of output names where you would like to restrict the output of variables(s) associated with this object

Outputs Parameters

References

No citations exist within this document.