Implements kernels for solving the Damage(or phase-field) equation in a phase-field fracture problem. More...

#include <PhaseFieldDamageFEMKernels.hpp>

Inheritance diagram for geos::PhaseFieldDamageKernel< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE >:

Classes
class	StackVariables
	Kernel variables allocated on the stack. More...

Public Types
using	Base = finiteElement::ImplicitKernelBase< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE, 1, 1 >
	An alias for the base class.

using	LocalDissipation = PhaseFieldDamageKernelLocalDissipation

Public Types inherited from geos::finiteElement::ImplicitKernelBase< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE, 1, 1 >
using	Base = KernelBase< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE, NUM_DOF_PER_TEST_SP, NUM_DOF_PER_TRIAL_SP >
	Alias for the base class. (i.e. geos::finiteElement::KernelBase)

Public Member Functions
	PhaseFieldDamageKernel (NodeManager const &nodeManager, EdgeManager const &edgeManager, FaceManager const &faceManager, localIndex const targetRegionIndex, SUBREGION_TYPE const &elementSubRegion, FE_TYPE const &finiteElementSpace, CONSTITUTIVE_TYPE &inputConstitutiveType, arrayView1d< globalIndex const > const inputDofNumber, globalIndex const rankOffset, CRSMatrixView< real64, globalIndex const > const inputMatrix, arrayView1d< real64 > const inputRhs, real64 const inputDt, string const fieldName, LocalDissipation localDissipationOption)
	Constructor. More...

GEOS_HOST_DEVICE void	setup (localIndex const k, StackVariables &stack) const
	Copy global values from primary field to a local stack array. More...

GEOS_HOST_DEVICE void	quadraturePointKernel (localIndex const k, localIndex const q, StackVariables &stack) const

GEOS_HOST_DEVICE real64	complete (localIndex const k, StackVariables &stack) const
	Performs the complete phase for the kernel. More...

Public Member Functions inherited from geos::finiteElement::ImplicitKernelBase< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE, 1, 1 >
	ImplicitKernelBase (NodeManager const &nodeManager, EdgeManager const &edgeManager, FaceManager const &faceManager, localIndex const targetRegionIndex, SUBREGION_TYPE const &elementSubRegion, FE_TYPE const &finiteElementSpace, CONSTITUTIVE_TYPE &inputConstitutiveType, arrayView1d< globalIndex const > const &inputDofNumber, globalIndex const rankOffset, CRSMatrixView< real64, globalIndex const > const &inputMatrix, arrayView1d< real64 > const &inputRhs, real64 const inputDt)
	Constructor. More...

GEOS_HOST_DEVICE void	setup (localIndex const k, StackVariables &stack) const
	Performs the setup phase for the kernel. More...

Public Member Functions inherited from geos::finiteElement::KernelBase< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE, NUM_DOF_PER_TEST_SP, NUM_DOF_PER_TRIAL_SP >
	KernelBase (SUBREGION_TYPE const &elementSubRegion, FE_TYPE const &finiteElementSpace, CONSTITUTIVE_TYPE &inputConstitutiveType)
	Constructor. More...

GEOS_HOST_DEVICE void	setup (localIndex const k, StackVariables &stack) const
	Performs the setup phase for the kernel. More...

GEOS_HOST_DEVICE GEOS_FORCE_INLINE void	quadraturePointKernel (localIndex const k, localIndex const q, StackVariables &stack) const
	Performs a state update at a quadrature point. More...

GEOS_HOST_DEVICE real64	complete (localIndex const k, StackVariables &stack) const
	Performs the complete phase for the kernel. More...

Static Public Attributes
static constexpr int	numNodesPerElem = Base::maxNumTestSupportPointsPerElem

Static Public Attributes inherited from geos::finiteElement::ImplicitKernelBase< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE, 1, 1 >
static constexpr int	maxNumTestSupportPointsPerElem

static constexpr int	maxNumTrialSupportPointsPerElem

static constexpr int	numDofPerTestSupportPoint

static constexpr int	numDofPerTrialSupportPoint

Static Public Attributes inherited from geos::finiteElement::KernelBase< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE, NUM_DOF_PER_TEST_SP, NUM_DOF_PER_TRIAL_SP >
static constexpr int	maxNumTestSupportPointsPerElem = FE_TYPE::maxSupportPoints

static constexpr int	maxNumTrialSupportPointsPerElem = FE_TYPE::maxSupportPoints

static constexpr int	numDofPerTestSupportPoint = NUM_DOF_PER_TEST_SP

static constexpr int	numDofPerTrialSupportPoint = NUM_DOF_PER_TRIAL_SP

static constexpr int	numQuadraturePointsPerElem = FE_TYPE::numQuadraturePoints
	Compile time value for the number of quadrature points per element.

Protected Attributes
arrayView2d< real64 const, nodes::REFERENCE_POSITION_USD > const	m_X
	The array containing the nodal position array.

arrayView1d< real64 const > const	m_nodalDamage
	The global primary field array.

arrayView2d< real64 const > const	m_quadDamage
	The array containing the damage on each quadrature point of all elements.

arrayView2d< real64 const > const	m_quadExtDrivingForce
	The array containing the external driving force on each quadrature point of all elements.

PhaseFieldDamageKernelLocalDissipation	m_localDissipationOption

Protected Attributes inherited from geos::finiteElement::ImplicitKernelBase< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE, 1, 1 >
arrayView1d< globalIndex const > const	m_dofNumber
	The global degree of freedom number.

globalIndex const	m_dofRankOffset
	The global rank offset.

CRSMatrixView< real64, globalIndex const > const	m_matrix
	The global Jacobian matrix.

arrayView1d< real64 > const	m_rhs
	The global residaul vector.

FE_TYPE::template MeshData< SUBREGION_TYPE >	m_meshData
	Data structure containing mesh data used to setup the finite element.

real64 const	m_dt
	time increment

Protected Attributes inherited from geos::finiteElement::KernelBase< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE, NUM_DOF_PER_TEST_SP, NUM_DOF_PER_TRIAL_SP >
traits::ViewTypeConst< typename SUBREGION_TYPE::NodeMapType::base_type > const	m_elemsToNodes
	The element to nodes map.

arrayView1d< integer const > const	m_elemGhostRank
	The element ghost rank array.

CONSTITUTIVE_TYPE::KernelWrapper const	m_constitutiveUpdate

FE_TYPE const	m_finiteElementSpace

Additional Inherited Members
Static Public Member Functions inherited from geos::finiteElement::KernelBase< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE, NUM_DOF_PER_TEST_SP, NUM_DOF_PER_TRIAL_SP >
template<typename POLICY , typename KERNEL_TYPE >
static real64	kernelLaunch (localIndex const numElems, KERNEL_TYPE const &kernelComponent)
	Kernel Launcher. More...

Public Attributes inherited from geos::finiteElement::ImplicitKernelBase< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE, 1, 1 >
traits::ViewTypeConst< typename SUBREGION_TYPE::NodeMapType::base_type > const	m_elemsToNodes
	The element to nodes map.

FE_TYPE const	m_finiteElementSpace

Detailed Description

template<typename SUBREGION_TYPE, typename CONSTITUTIVE_TYPE, typename FE_TYPE>
class geos::PhaseFieldDamageKernel< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE >

Implements kernels for solving the Damage(or phase-field) equation in a phase-field fracture problem.

Define the base interface for finite element kernels.

Template Parameters

SUBREGION_TYPE	The type of subregion that the kernel will act on.
CONSTITUTIVE_TYPE	The type of constitutive model present in the subregion.
NUM_TEST_SUPPORT_POINTS_PER_ELEM	The number of test space support points per element.
NUM_TRIAL_SUPPORT_POINTS_PER_ELEM	The number of trial space support points per element.
NUM_DOF_PER_TEST_SP	The number of DOF per test support point.
NUM_DOF_PER_TRIAL_SP	The number of DOF per trial support point.

General KernelBase Description

KernelBase defines an interface for implementing finite element kernels that will be callable by the family of kernel launch functions. Specific physics kernels may or may not derive from KernelBase, but must follow the same interface in order to be callable from the generic launching functions.

The template parameters of KernelBase should be duplicated as part of the interface, EXCEPT for NUM_DOF_PER_TEST_SP and NUM_DOF_PER_TRIAL_SP. These values should be set internally by the physics solver since each physics discretization will have a constant intrinsic value for these quantities. For example, when solving or the heat equation with scalar temperature as the primary variable at the support point, these will have a value of 1. In contrast, when solving a solid mechanics problem, with vector displacement as the primary variable at the support point, these will have a value of 3. Note that the interface provided by geos::finiteElement::RegionBasedKernelApplication will construct a kernel assuming only the first 4 template arguments.

Template Parameters

NUM_NODES_PER_ELEM	The number of nodes per element for the `SUBREGION_TYPE`.
UNUSED	An unused parameter since we are assuming that the test and trial space have the same number of support points.

PhaseFieldDamageKernel Description

Implements the KernelBase interface functions required for solving the Damage(or phase-field) equation in a phase-field fracture problem. It uses the finite element kernel application functions such as geos::finiteElement::RegionBasedKernelApplication.

In this implementation, the template parameter NUM_NODES_PER_ELEM is used in place of both NUM_TEST_SUPPORT_POINTS_PER_ELEM and NUM_TRIAL_SUPPORT_POINTS_PER_ELEM, which are assumed to be equal. This results in the UNUSED template parameter as only the NUM_NODES_PER_ELEM is passed to the ImplicitKernelBase template to form the base class.

Additionally, the number of degrees of freedom per support point for both the test and trial spaces are specified as 1 when specifying the base class.

Definition at line 63 of file PhaseFieldDamageFEMKernels.hpp.

Constructor & Destructor Documentation

◆ PhaseFieldDamageKernel()

template<typename SUBREGION_TYPE , typename CONSTITUTIVE_TYPE , typename FE_TYPE >

geos::PhaseFieldDamageKernel< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE >::PhaseFieldDamageKernel	(	NodeManager const &	nodeManager,
		EdgeManager const &	edgeManager,
		FaceManager const &	faceManager,
		localIndex const	targetRegionIndex,
		SUBREGION_TYPE const &	elementSubRegion,
		FE_TYPE const &	finiteElementSpace,
		CONSTITUTIVE_TYPE &	inputConstitutiveType,
		arrayView1d< globalIndex const > const	inputDofNumber,
		globalIndex const	rankOffset,
		CRSMatrixView< real64, globalIndex const > const	inputMatrix,
		arrayView1d< real64 > const	inputRhs,
		real64 const	inputDt,
		string const	fieldName,
		LocalDissipation	localDissipationOption
	)

inline

Constructor.

Parameters

nodeManager	Reference to the NodeManager object.
edgeManager	Reference to the EdgeManager object.
faceManager	Reference to the FaceManager object.
targetRegionIndex	Index of the region the subregion belongs to.
inputDofNumber	The dof number for the primary field.
rankOffset	dof index offset of current rank
inputMatrix	Reference to the Jacobian matrix.
inputRhs	Reference to the RHS vector.
inputDt	The timestep for the physics update.

Constructor.

Parameters

elementSubRegion	Reference to the SUBREGION_TYPE(class template parameter) object.
inputConstitutiveType	The constitutive object.
finiteElementSpace	Placeholder for the finite element space object, which currently doesn't do much.
fieldName	The name of the primary field (i.e. Temperature, Pressure, etc.)

Definition at line 101 of file PhaseFieldDamageFEMKernels.hpp.

Member Function Documentation

◆ complete()

template<typename SUBREGION_TYPE , typename CONSTITUTIVE_TYPE , typename FE_TYPE >

GEOS_HOST_DEVICE real64 geos::PhaseFieldDamageKernel< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE >::complete	(	localIndex const	k,
		StackVariables &	stack
	)		const

inline

Performs the complete phase for the kernel.

Template Parameters

STACK_VARIABLE_TYPE The type of StackVariable that holds the stack variables. This is most likely a defined in a type that derives from KernelBase.

Parameters

k	The element index.
stack	The StackVariable object that hold the stack variables.

Returns: The maximum contribution to the residual.

KernelBase::complete() Description

The operations typically found in complete are the mapping of the local Jacobian and Residual into the global Jacobian and Residual.

Form element residual from the fully formed element Jacobian dotted with the primary field and map the element local Jacobian/Residual to the global matrix/vector.

Definition at line 271 of file PhaseFieldDamageFEMKernels.hpp.

◆ quadraturePointKernel()

template<typename SUBREGION_TYPE , typename CONSTITUTIVE_TYPE , typename FE_TYPE >

GEOS_HOST_DEVICE void geos::PhaseFieldDamageKernel< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE >::quadraturePointKernel	(	localIndex const	k,
		localIndex const	q,
		StackVariables &	stack
	)		const

inline

Definition at line 200 of file PhaseFieldDamageFEMKernels.hpp.

◆ setup()

template<typename SUBREGION_TYPE , typename CONSTITUTIVE_TYPE , typename FE_TYPE >

GEOS_HOST_DEVICE void geos::PhaseFieldDamageKernel< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE >::setup	(	localIndex const	k,
		StackVariables &	stack
	)		const

inline

Copy global values from primary field to a local stack array.

Performs the setup phase for the kernel.

Template Parameters

STACK_VARIABLE_TYPE The type of StackVariable that holds the stack variables. This is most likely a defined in a type that derives from KernelBase.

Parameters

k	The element index.
stack	The StackVariable object that hold the stack variables.

KernelBase::setup() Description

The operations typically found in setup are thing such as the collection of global data into local stack storage.

ImplicitKernelBase::setup() Description

In this implementation, the element local Row and Column DOF stack arrays are filled for when we fill the global matrix and rhs.

Note: This seems like a waste of register space. We should do this in complete() unless we actually need these dof somewhere else in the kernel.

For the PhaseFieldDamageKernel implementation, global values from the primaryField, and degree of freedom numbers are placed into element local stack storage.

Definition at line 178 of file PhaseFieldDamageFEMKernels.hpp.

Member Data Documentation

◆ numNodesPerElem

template<typename SUBREGION_TYPE , typename CONSTITUTIVE_TYPE , typename FE_TYPE >

constexpr int geos::PhaseFieldDamageKernel< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE >::numNodesPerElem = Base::maxNumTestSupportPointsPerElem

staticconstexpr

Maximum number of nodes per element, which is equal to the maxNumTestSupportPointPerElem and maxNumTrialSupportPointPerElem by definition. When the FE_TYPE is not a Virtual Element, this will be the actual number of nodes per element.

Definition at line 93 of file PhaseFieldDamageFEMKernels.hpp.

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

coreComponents/physicsSolvers/simplePDE/PhaseFieldDamageFEMKernels.hpp

Classes

Public Types

Public Member Functions

Static Public Attributes

Protected Attributes

Additional Inherited Members

Detailed Description

template<typename SUBREGION_TYPE, typename CONSTITUTIVE_TYPE, typename FE_TYPE> class geos::PhaseFieldDamageKernel< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE >

General KernelBase Description

PhaseFieldDamageKernel Description

Constructor & Destructor Documentation

◆ PhaseFieldDamageKernel()

Member Function Documentation

◆ complete()

KernelBase::complete() Description

◆ quadraturePointKernel()

◆ setup()

KernelBase::setup() Description

ImplicitKernelBase::setup() Description

Member Data Documentation

◆ numNodesPerElem

template<typename SUBREGION_TYPE, typename CONSTITUTIVE_TYPE, typename FE_TYPE>
class geos::PhaseFieldDamageKernel< SUBREGION_TYPE, CONSTITUTIVE_TYPE, FE_TYPE >