www.mooseframework.org
Public Member Functions | Static Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes | Private Attributes | List of all members
CahnHilliard Class Reference

SplitCHWRes creates the residual of the Cahn-Hilliard equation with a scalar (isotropic) mobility. More...

#include <CahnHilliard.h>

Inheritance diagram for CahnHilliard:
[legend]

Public Member Functions

 CahnHilliard (const InputParameters &parameters)
 
virtual void initialSetup ()
 

Static Public Member Functions

static InputParameters validParams ()
 

Protected Types

typedef CHBulk< Real >::PFFunctionType PFFunctionType
 

Protected Member Functions

virtual RealGradient computeGradDFDCons (PFFunctionType type)
 
virtual Real computeQpOffDiagJacobian (unsigned int jvar)
 
virtual RealGradient precomputeQpResidual ()
 
virtual RealGradient precomputeQpJacobian ()
 

Protected Attributes

const MaterialProperty< Real > & _M
 Mobility. More...
 
const MaterialProperty< Real > & _dMdc
 Mobility derivative w.r.t. concentration. More...
 
std::vector< const MaterialProperty< Real > * > _dMdarg
 Mobility derivative w.r.t coupled variables. More...
 

Private Attributes

const unsigned int _nvar
 
std::vector< const MaterialProperty< Real > * > _second_derivatives
 
std::vector< const MaterialProperty< Real > * > _third_derivatives
 
std::vector< std::vector< const MaterialProperty< Real > * > > _third_cross_derivatives
 
std::vector< const VariableGradient * > _grad_vars
 

Detailed Description

SplitCHWRes creates the residual of the Cahn-Hilliard equation with a scalar (isotropic) mobility.

Definition at line 18 of file CahnHilliard.h.

Member Typedef Documentation

◆ PFFunctionType

typedef CHBulk<Real >::PFFunctionType CahnHilliardBase< Real >::PFFunctionType
protectedinherited

Definition at line 29 of file CahnHilliardBase.h.

Constructor & Destructor Documentation

◆ CahnHilliard()

CahnHilliard::CahnHilliard ( const InputParameters &  parameters)

Definition at line 24 of file CahnHilliard.C.

24  : CahnHilliardBase<Real>(parameters)
25 {
26 }

Member Function Documentation

◆ computeGradDFDCons()

RealGradient CahnHilliardBase< Real >::computeGradDFDCons ( PFFunctionType  type)
protectedvirtualinherited

Implements CHBulk< Real >.

Definition at line 127 of file CahnHilliardBase.h.

128 {
129  RealGradient res = 0.0;
130 
131  switch (type)
132  {
133  case CHBulk<T>::Residual:
134  for (unsigned int i = 0; i <= _nvar; ++i)
135  res += (*_grad_vars[i])[_qp] * (*_second_derivatives[i])[_qp];
136  return res;
137 
138  case CHBulk<T>::Jacobian:
139  res = _grad_phi[_j][_qp] * (*_second_derivatives[0])[_qp];
140  for (unsigned int i = 0; i <= _nvar; ++i)
141  res += _phi[_j][_qp] * (*_grad_vars[i])[_qp] * (*_third_derivatives[i])[_qp];
142  return res;
143  }
144 
145  mooseError("Internal error");
146 }

◆ computeQpOffDiagJacobian()

Real CahnHilliardBase< Real >::computeQpOffDiagJacobian ( unsigned int  jvar)
protectedvirtualinherited

Reimplemented from CHBulk< Real >.

Definition at line 150 of file CahnHilliardBase.h.

151 {
152  // get the coupled variable jvar is referring to
153  const unsigned int cvar = this->mapJvarToCvar(jvar);
154 
155  RealGradient J = _grad_u[_qp] * _phi[_j][_qp] * (*_third_derivatives[cvar + 1])[_qp] +
156  _grad_phi[_j][_qp] * (*_second_derivatives[cvar + 1])[_qp];
157 
158  for (unsigned int i = 0; i < _nvar; ++i)
159  J += _phi[_j][_qp] * (*_grad_vars[i + 1])[_qp] * (*_third_cross_derivatives[i][cvar])[_qp];
160 
161  return CHBulk<T>::computeQpOffDiagJacobian(jvar) + _M[_qp] * _grad_test[_i][_qp] * J;
162 }

◆ initialSetup()

void CahnHilliardBase< Real >::initialSetup ( )
virtualinherited

Check if both the non-linear as well as the auxiliary variables variables are coupled. Derivatives with respect to both types of variables contribute the residual.

Reimplemented from CHBulk< Real >.

Definition at line 114 of file CahnHilliardBase.h.

115 {
121  this->template validateCoupling<Real>("f_name", _var.name());
122  this->template validateDerivativeMaterialPropertyBase<Real>("f_name");
123 }

◆ precomputeQpJacobian()

RealGradient CHBulk< Real >::precomputeQpJacobian ( )
protectedvirtualinherited

Definition at line 100 of file CHBulk.h.

101 {
102  RealGradient grad_value = _M[_qp] * computeGradDFDCons(Jacobian) +
103  _dMdc[_qp] * _phi[_j][_qp] * computeGradDFDCons(Residual);
104 
105  return grad_value;
106 }

◆ precomputeQpResidual()

RealGradient CHBulk< Real >::precomputeQpResidual ( )
protectedvirtualinherited

Definition at line 93 of file CHBulk.h.

94 {
95  return _M[_qp] * computeGradDFDCons(Residual);
96 }

◆ validParams()

InputParameters CahnHilliardBase< Real >::validParams ( )
staticinherited

Definition at line 58 of file CahnHilliardBase.h.

59 {
60  InputParameters params = CHBulk<Real>::validParams();
61  params.addClassDescription("Cahn-Hilliard Kernel that uses a DerivativeMaterial Free Energy");
62  params.addRequiredParam<MaterialPropertyName>(
63  "f_name", "Base name of the free energy function F defined in a DerivativeParsedMaterial");
64  params.addCoupledVar("displacement_gradients",
65  "Vector of displacement gradient variables (see "
66  "Modules/PhaseField/DisplacementGradients "
67  "action)");
68  return params;
69 }

Member Data Documentation

◆ _dMdarg

std::vector<const MaterialProperty<Real > *> CHBulk< Real >::_dMdarg
protectedinherited

Mobility derivative w.r.t coupled variables.

Definition at line 53 of file CHBulk.h.

◆ _dMdc

const MaterialProperty<Real >& CHBulk< Real >::_dMdc
protectedinherited

Mobility derivative w.r.t. concentration.

Definition at line 50 of file CHBulk.h.

◆ _grad_vars

std::vector<const VariableGradient *> CahnHilliardBase< Real >::_grad_vars
privateinherited

Definition at line 53 of file CahnHilliardBase.h.

◆ _M

const MaterialProperty<Real >& CHBulk< Real >::_M
protectedinherited

Mobility.

Definition at line 47 of file CHBulk.h.

◆ _nvar

const unsigned int CahnHilliardBase< Real >::_nvar
privateinherited

Definition at line 49 of file CahnHilliardBase.h.

◆ _second_derivatives

std::vector<const MaterialProperty<Real> *> CahnHilliardBase< Real >::_second_derivatives
privateinherited

Definition at line 50 of file CahnHilliardBase.h.

◆ _third_cross_derivatives

std::vector<std::vector<const MaterialProperty<Real> *> > CahnHilliardBase< Real >::_third_cross_derivatives
privateinherited

Definition at line 52 of file CahnHilliardBase.h.

◆ _third_derivatives

std::vector<const MaterialProperty<Real> *> CahnHilliardBase< Real >::_third_derivatives
privateinherited

Definition at line 51 of file CahnHilliardBase.h.


The documentation for this class was generated from the following files:
CHBulk< Real >::computeGradDFDCons
virtual RealGradient computeGradDFDCons(PFFunctionType type)=0
CahnHilliardBase< Real >::_second_derivatives
std::vector< const MaterialProperty< Real > * > _second_derivatives
Definition: CahnHilliardBase.h:50
libMesh::RealGradient
VectorValue< Real > RealGradient
Definition: GrainForceAndTorqueInterface.h:17
CahnHilliardBase< Real >::_nvar
const unsigned int _nvar
Definition: CahnHilliardBase.h:49
CHBulk< Real >::Jacobian
Definition: CHBulk.h:40
CHBulk< Real >::Residual
Definition: CHBulk.h:41
CHBulk< Real >::_dMdc
const MaterialProperty< Real > & _dMdc
Mobility derivative w.r.t. concentration.
Definition: CHBulk.h:50
CahnHilliardBase< Real >::_grad_vars
std::vector< const VariableGradient * > _grad_vars
Definition: CahnHilliardBase.h:53
CahnHilliardBase< Real >::_third_derivatives
std::vector< const MaterialProperty< Real > * > _third_derivatives
Definition: CahnHilliardBase.h:51
CahnHilliardBase< Real >
CHBulk::computeQpOffDiagJacobian
virtual Real computeQpOffDiagJacobian(unsigned int jvar)
Definition: CHBulk.h:110
CHBulk< Real >::_M
const MaterialProperty< Real > & _M
Mobility.
Definition: CHBulk.h:47
CHBulk::validParams
static InputParameters validParams()
Definition: CHBulk.h:75
CahnHilliardBase< Real >::_third_cross_derivatives
std::vector< std::vector< const MaterialProperty< Real > * > > _third_cross_derivatives
Definition: CahnHilliardBase.h:52
CHBulk
This is the Cahn-Hilliard equation base class that implements the bulk or local energy term of the eq...
Definition: CHBulk.h:25