ElectrochemicalDefectMaterial

The ElectrochemicalDefectMaterial defines the susceptibility and defect densities in the solid and void phases for a defect species in the electrochemical sintering model. One instantiation of this material must be included for each defect species. Other material properties for this model are calculated by the ElectrochemicalSinteringMaterial, which also must be included.

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>

    Unit:(no unit assumed)

    Controllable:No

    Description:Name of the temperature variable with units of K

  • chemical_potentialThe name of the chemical potential variable

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

    Unit:(no unit assumed)

    Controllable:No

    Description:The name of the chemical potential variable

  • defect_chargeEffective charge of defect species

    C++ Type:int

    Unit:(no unit assumed)

    Controllable:No

    Description:Effective charge of defect species

  • electric_potentialName of the electric potential variable with units of V

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

    Unit:(no unit assumed)

    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>

    Unit:(no unit assumed)

    Controllable:No

    Description:Array of order parameters that describe solid phase

  • min_vacancy_concentration_solidName of material that determines the minimum in energy wrt defect concentration in the solid phase

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:Name of material that determines the minimum in energy wrt defect concentration in the solid phase

  • min_vacancy_concentration_voidMinimum in energy wrt defect concentration in the void phase

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Minimum in energy wrt defect concentration in the void phase

  • solid_relative_permittivitySolid phase relative permittivity (dimensionless)

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Solid phase relative permittivity (dimensionless)

  • void_energy_coefficientParabolic void energy coefficient (energy*volume) for defect species.

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:Parabolic void energy coefficient (energy*volume) for defect species.

  • void_opThe name of the void phase order parameter

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

    Unit:(no unit assumed)

    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>

    Unit:(no unit assumed)

    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>

    Unit:(no unit assumed)

    Controllable:No

    Description:The list of boundaries (ids or names) from the mesh where this object applies

  • chi_namechiName of material property to be created defect susceptibility.

    Default:chi

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:Name of material property to be created defect susceptibility.

  • 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

    Unit:(no unit assumed)

    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

    Unit:(no unit assumed)

    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

    Unit:(no unit assumed)

    Controllable:No

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

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

    C++ Type:unsigned int

    Unit:(no unit assumed)

    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

    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.

  • solid_density_namensName of material property to be created for defect number density in the solid phase.

    Default:ns

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:Name of material property to be created for defect number density in the solid phase.

  • solid_energy_coefficient1Parabolic solid energy coefficient (energy*volume) for defect species. Only used for parabolic energy.

    Default:1

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:Parabolic solid energy coefficient (energy*volume) for defect species. Only used for parabolic energy.

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

    Default:PARABOLIC

    C++ Type:MooseEnum

    Unit:(no unit assumed)

    Options:PARABOLIC, DILUTE, IDEAL

    Controllable:No

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

  • 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

    Unit:(no unit assumed)

    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.

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

    C++ Type:std::string

    Unit:(no unit assumed)

    Controllable:No

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

  • void_density_namenvName of material property to be created for defect number density in the void phase.

    Default:nv

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:Name of material property to be created for defect number density in the void phase.

  • voltage_scale1Voltage scale (default is for voltage in V)

    Default:1

    C++ Type:double

    Unit:(no unit assumed)

    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>

    Unit:(no unit assumed)

    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

    Unit:(no unit assumed)

    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

    Unit:(no unit assumed)

    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

    Unit:(no unit assumed)

    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

    Unit:(no unit assumed)

    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>

    Unit:(no unit assumed)

    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>

    Unit:(no unit assumed)

    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.