KKSMultiACBulkBase child class for the free energy term \( \sum_j \frac{\partial h_j}{\partial \eta_i} F_j + w_i \frac{dg}{d\eta_i} \) in the the Allen-Cahn bulk residual. More...

#include <KKSMultiACBulkF.h>

Inheritance diagram for KKSMultiACBulkF:

[legend]

Public Member Functions
	KKSMultiACBulkF (const InputParameters &parameters)

virtual void	initialSetup ()

Static Public Member Functions
static InputParameters	validParams ()

Protected Types
enum	PFFunctionType

Protected Member Functions
virtual Real	computeDFDOP (PFFunctionType type)

virtual Real	computeQpOffDiagJacobian (unsigned int jvar)

virtual Real	precomputeQpResidual ()

virtual Real	precomputeQpJacobian ()

virtual Real	computeDFDOP (PFFunctionType type)=0

Protected Attributes
Real	_wi
	double well height parameter More...

const MaterialProperty< Real > &	_prop_dgi
	Derivative of the double well function \( \frac d{d\eta} g(\eta) \). More...

const MaterialProperty< Real > &	_prop_d2gi
	Second derivative of the double well function \( \frac {d^2}{d\eta^2} g(\eta) \). More...

unsigned int	_nvar
	Number of coupled variables. More...

VariableName	_etai_name
	name of order parameter that derivatives are taken wrt (needed to retrieve the derivative material properties) More...

unsigned int	_etai_var
	index of order parameter that derivatives are taken wrt More...

std::vector< MaterialPropertyName >	_Fj_names
	Names of free energy functions for each phase \( F_j \). More...

unsigned int	_num_j

std::vector< const MaterialProperty< Real > * >	_prop_Fj
	Values of the free energy functions for each phase \( F_j \). More...

std::vector< std::vector< const MaterialProperty< Real > * > >	_prop_dFjdarg
	Derivatives of the free energy functions (needed for off-diagonal Jacobians) More...

std::vector< MaterialPropertyName >	_hj_names
	switching function names More...

std::vector< const MaterialProperty< Real > * >	_prop_hj
	Values of the switching functions for each phase \( h_j \). More...

std::vector< const MaterialProperty< Real > * >	_prop_dhjdetai
	Derivatives of the switching functions wrt the order parameter for this kernel. More...

std::vector< const MaterialProperty< Real > * >	_prop_d2hjdetai2
	Second derivatives of the switching functions wrt the order parameter for this kernel. More...

std::vector< std::vector< const MaterialProperty< Real > * > >	_prop_d2hjdetaidarg
	Second derivatives of the switching functions (needed for off-diagonal Jacobians) More...

const MaterialProperty< Real > &	_L
	Mobility. More...

const MaterialProperty< Real > &	_dLdop
	Mobility derivative w.r.t. order parameter. More...

std::vector< const MaterialProperty< Real > * >	_dLdarg
	Mobility derivative w.r.t coupled variables. More...

Detailed Description

KKSMultiACBulkBase child class for the free energy term \( \sum_j \frac{\partial h_j}{\partial \eta_i} F_j + w_i \frac{dg}{d\eta_i} \) in the the Allen-Cahn bulk residual.

The non-linear variable for this Kernel is the order parameter \( eta_i \).

Definition at line 27 of file KKSMultiACBulkF.h.

Member Enumeration Documentation

◆ PFFunctionType

enum ACBulk::PFFunctionType

protectedinherited

Definition at line 37 of file ACBulk.h.

   {
     Jacobian,
     Residual
   };

Constructor & Destructor Documentation

◆ KKSMultiACBulkF()

KKSMultiACBulkF::KKSMultiACBulkF ( const InputParameters & parameters )

Definition at line 27 of file KKSMultiACBulkF.C.

   : KKSMultiACBulkBase(parameters),
     _wi(getParam<Real>("wi")),
     _prop_dgi(getMaterialPropertyDerivative<Real>("gi_name", _etai_name)),
     _prop_d2gi(getMaterialPropertyDerivative<Real>("gi_name", _etai_name, _etai_name))
 {
 }

Member Function Documentation

◆ computeDFDOP() [1/2]

Real KKSMultiACBulkF::computeDFDOP ( PFFunctionType type )

protectedvirtual

Definition at line 36 of file KKSMultiACBulkF.C.

 {
   Real sum = 0.0;
  
   switch (type)
   {
     case Residual:
       for (unsigned int n = 0; n < _num_j; ++n)
         sum += (*_prop_dhjdetai[n])[_qp] * (*_prop_Fj[n])[_qp];
  
       return sum + _wi * _prop_dgi[_qp];
  
     case Jacobian:
       // For when this kernel is used in the Lagrange multiplier equation
       // In that case the Lagrange multiplier is the nonlinear variable
       if (_etai_var != _var.number())
         return 0.0;
  
       // For when eta_i is the nonlinear variable
       for (unsigned int n = 0; n < _num_j; ++n)
         sum += (*_prop_d2hjdetai2[n])[_qp] * (*_prop_Fj[n])[_qp];
  
       return _phi[_j][_qp] * (sum + _wi * _prop_d2gi[_qp]);
   }
  
   mooseError("Invalid type passed in");
 }

◆ computeDFDOP() [2/2]

virtual Real ACBulk< Real >::computeDFDOP ( PFFunctionType type )

protectedpure virtualinherited

◆ computeQpOffDiagJacobian()

Real KKSMultiACBulkF::computeQpOffDiagJacobian ( unsigned int jvar )

protectedvirtual

Reimplemented from ACBulk< Real >.

Definition at line 65 of file KKSMultiACBulkF.C.

 {
   // get the coupled variable jvar is referring to
   const unsigned int cvar = mapJvarToCvar(jvar);
  
   // first get dependence of mobility _L on other variables using parent class
   // member function
   Real res = ACBulk<Real>::computeQpOffDiagJacobian(jvar);
  
   // Then add dependence of KKSMultiACBulkF on other variables
   Real sum = 0.0;
   for (unsigned int n = 0; n < _num_j; ++n)
     sum += (*_prop_d2hjdetaidarg[n][cvar])[_qp] * (*_prop_Fj[n])[_qp] +
            (*_prop_dhjdetai[n])[_qp] * (*_prop_dFjdarg[n][cvar])[_qp];
  
   // Handle the case when this kernel is used in the Lagrange multiplier equation
   // In this case the second derivative of the barrier function contributes
   // to the off-diagonal Jacobian
   if (jvar == _etai_var)
     sum += _wi * _prop_d2gi[_qp];
  
   res += _L[_qp] * sum * _phi[_j][_qp] * _test[_i][_qp];
  
   return res;
 }

◆ initialSetup()

void KKSMultiACBulkBase::initialSetup ( )

virtualinherited

Reimplemented from ACBulk< Real >.

Definition at line 76 of file KKSMultiACBulkBase.C.

 {
   ACBulk<Real>::initialSetup();
  
   for (unsigned int n = 0; n < _num_j; ++n)
   {
     validateNonlinearCoupling<Real>(_Fj_names[n]);
     validateNonlinearCoupling<Real>(_hj_names[n]);
   }
 }

◆ precomputeQpJacobian()

Real ACBulk< Real >::precomputeQpJacobian ( )

protectedvirtualinherited

Definition at line 103 of file ACBulk.h.

 {
   // Get free energy derivative and Jacobian
   Real dFdop = computeDFDOP(Residual);
  
   Real JdFdop = computeDFDOP(Jacobian);
  
   // Set Jacobian value using product rule
   return _L[_qp] * JdFdop + _dLdop[_qp] * _phi[_j][_qp] * dFdop;
 }

◆ precomputeQpResidual()

Real ACBulk< Real >::precomputeQpResidual ( )

protectedvirtualinherited

Definition at line 92 of file ACBulk.h.

 {
   // Get free energy derivative from function
   Real dFdop = computeDFDOP(Residual);
  
   // Set residual
   return _L[_qp] * dFdop;
 }

◆ validParams()

InputParameters ACBulk< Real >::validParams ( )

staticinherited

Definition at line 74 of file ACBulk.h.

 {
   InputParameters params = ::validParams<KernelValue>();
   params.addClassDescription("Allen-Cahn base Kernel");
   params.addParam<MaterialPropertyName>("mob_name", "L", "The mobility used with the kernel");
   params.addCoupledVar("args", "Vector of arguments of the mobility");
   return params;
 }

Member Data Documentation

◆ _dLdarg

std::vector<const MaterialProperty<Real > *> ACBulk< Real >::_dLdarg

protectedinherited

Mobility derivative w.r.t coupled variables.

Definition at line 52 of file ACBulk.h.

◆ _dLdop

const MaterialProperty<Real >& ACBulk< Real >::_dLdop

protectedinherited

Mobility derivative w.r.t. order parameter.

Definition at line 49 of file ACBulk.h.

◆ _etai_name

VariableName KKSMultiACBulkBase::_etai_name

protectedinherited

name of order parameter that derivatives are taken wrt (needed to retrieve the derivative material properties)

Definition at line 39 of file KKSMultiACBulkBase.h.

Referenced by KKSMultiACBulkBase::KKSMultiACBulkBase().

◆ _etai_var

unsigned int KKSMultiACBulkBase::_etai_var

protectedinherited

index of order parameter that derivatives are taken wrt

Definition at line 42 of file KKSMultiACBulkBase.h.

Referenced by KKSMultiACBulkC::computeDFDOP(), computeDFDOP(), and computeQpOffDiagJacobian().

◆ _Fj_names

std::vector<MaterialPropertyName> KKSMultiACBulkBase::_Fj_names

protectedinherited

Names of free energy functions for each phase \( F_j \).

Definition at line 45 of file KKSMultiACBulkBase.h.

Referenced by KKSMultiACBulkBase::initialSetup(), KKSMultiACBulkBase::KKSMultiACBulkBase(), and KKSMultiACBulkC::KKSMultiACBulkC().

◆ _hj_names

std::vector<MaterialPropertyName> KKSMultiACBulkBase::_hj_names

protectedinherited

switching function names

Definition at line 55 of file KKSMultiACBulkBase.h.

Referenced by KKSMultiACBulkBase::initialSetup(), and KKSMultiACBulkBase::KKSMultiACBulkBase().

◆ _L

const MaterialProperty<Real >& ACBulk< Real >::_L

protectedinherited

Mobility.

Definition at line 46 of file ACBulk.h.

◆ _num_j

unsigned int KKSMultiACBulkBase::_num_j

protectedinherited

Definition at line 46 of file KKSMultiACBulkBase.h.

Referenced by KKSMultiACBulkC::computeDFDOP(), computeDFDOP(), KKSMultiACBulkC::computeQpOffDiagJacobian(), computeQpOffDiagJacobian(), KKSMultiACBulkBase::initialSetup(), KKSMultiACBulkBase::KKSMultiACBulkBase(), and KKSMultiACBulkC::KKSMultiACBulkC().

◆ _nvar

unsigned int KKSMultiACBulkBase::_nvar

protectedinherited

Number of coupled variables.

Definition at line 36 of file KKSMultiACBulkBase.h.

Referenced by KKSMultiACBulkBase::KKSMultiACBulkBase(), and KKSMultiACBulkC::KKSMultiACBulkC().

◆ _prop_d2gi

const MaterialProperty<Real>& KKSMultiACBulkF::_prop_d2gi

protected

Second derivative of the double well function \( \frac {d^2}{d\eta^2} g(\eta) \).

Definition at line 43 of file KKSMultiACBulkF.h.

Referenced by computeDFDOP(), and computeQpOffDiagJacobian().

◆ _prop_d2hjdetai2

std::vector<const MaterialProperty<Real> *> KKSMultiACBulkBase::_prop_d2hjdetai2

protectedinherited

Second derivatives of the switching functions wrt the order parameter for this kernel.

Definition at line 64 of file KKSMultiACBulkBase.h.

Referenced by KKSMultiACBulkC::computeDFDOP(), computeDFDOP(), and KKSMultiACBulkBase::KKSMultiACBulkBase().

◆ _prop_d2hjdetaidarg

std::vector<std::vector<const MaterialProperty<Real> *> > KKSMultiACBulkBase::_prop_d2hjdetaidarg

protectedinherited

Second derivatives of the switching functions (needed for off-diagonal Jacobians)

Definition at line 67 of file KKSMultiACBulkBase.h.

Referenced by KKSMultiACBulkC::computeQpOffDiagJacobian(), computeQpOffDiagJacobian(), and KKSMultiACBulkBase::KKSMultiACBulkBase().

◆ _prop_dFjdarg

std::vector<std::vector<const MaterialProperty<Real> *> > KKSMultiACBulkBase::_prop_dFjdarg

protectedinherited

Derivatives of the free energy functions (needed for off-diagonal Jacobians)

Definition at line 52 of file KKSMultiACBulkBase.h.

Referenced by computeQpOffDiagJacobian(), and KKSMultiACBulkBase::KKSMultiACBulkBase().

◆ _prop_dgi

const MaterialProperty<Real>& KKSMultiACBulkF::_prop_dgi

protected

Derivative of the double well function \( \frac d{d\eta} g(\eta) \).

Definition at line 40 of file KKSMultiACBulkF.h.

Referenced by computeDFDOP().

◆ _prop_dhjdetai

std::vector<const MaterialProperty<Real> *> KKSMultiACBulkBase::_prop_dhjdetai

protectedinherited

Derivatives of the switching functions wrt the order parameter for this kernel.

Definition at line 61 of file KKSMultiACBulkBase.h.

Referenced by KKSMultiACBulkC::computeDFDOP(), computeDFDOP(), computeQpOffDiagJacobian(), KKSMultiACBulkC::computeQpOffDiagJacobian(), and KKSMultiACBulkBase::KKSMultiACBulkBase().

◆ _prop_Fj

std::vector<const MaterialProperty<Real> *> KKSMultiACBulkBase::_prop_Fj

protectedinherited

Values of the free energy functions for each phase \( F_j \).

Definition at line 49 of file KKSMultiACBulkBase.h.

Referenced by computeDFDOP(), computeQpOffDiagJacobian(), and KKSMultiACBulkBase::KKSMultiACBulkBase().

◆ _prop_hj

std::vector<const MaterialProperty<Real> *> KKSMultiACBulkBase::_prop_hj

protectedinherited

Values of the switching functions for each phase \( h_j \).

Definition at line 58 of file KKSMultiACBulkBase.h.

Referenced by KKSMultiACBulkBase::KKSMultiACBulkBase().

◆ _wi

Real KKSMultiACBulkF::_wi

protected

double well height parameter

Definition at line 37 of file KKSMultiACBulkF.h.

Referenced by computeDFDOP(), and computeQpOffDiagJacobian().

The documentation for this class was generated from the following files:

phase_field/include/kernels/KKSMultiACBulkF.h
phase_field/src/kernels/KKSMultiACBulkF.C

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ PFFunctionType

Constructor & Destructor Documentation

◆ KKSMultiACBulkF()

Member Function Documentation

◆ computeDFDOP() [1/2]

◆ computeDFDOP() [2/2]

◆ computeQpOffDiagJacobian()

◆ initialSetup()

◆ precomputeQpJacobian()

◆ precomputeQpResidual()

◆ validParams()

Member Data Documentation

◆ _dLdarg

◆ _dLdop

◆ _etai_name

◆ _etai_var

◆ _Fj_names

◆ _hj_names

◆ _L

◆ _num_j

◆ _nvar

◆ _prop_d2gi

◆ _prop_d2hjdetai2

◆ _prop_d2hjdetaidarg

◆ _prop_dFjdarg

◆ _prop_dgi

◆ _prop_dhjdetai

◆ _prop_Fj

◆ _prop_hj

◆ _wi