Computes $Ma(x)b(x)\cdots\int(\nabla\phi(x))\times \vec{s}(x)\,dx$ . More...

#include <Panzer_Integrator_GradBasisCrossVector_decl.hpp>

Inheritance diagram for panzer::Integrator_GradBasisCrossVector< EvalT, Traits >:

Classes
struct	FieldMultTag
	This empty struct allows us to optimize `operator()()` depending on the number of field multipliers. More...

Public Member Functions
	Integrator_GradBasisCrossVector (const panzer::EvaluatorStyle &evalStyle, const std::vector< std::string > &resNames, const std::string &vecName, const panzer::BasisIRLayout &basis, const panzer::IntegrationRule &ir, const double &multiplier=1, const std::vector< std::string > &fmNames=std::vector< std::string >(), const Teuchos::RCP< PHX::DataLayout > &vecDL=Teuchos::null)
	Main Constructor. More...

	Integrator_GradBasisCrossVector (const Teuchos::ParameterList &p)
	`ParameterList` Constructor. More...

void	postRegistrationSetup (typename Traits::SetupData d, PHX::FieldManager< Traits > &fm)
	Post-Registration Setup. More...

void	evaluateFields (typename Traits::EvalData d)
	Evaluate Fields. More...

template<int NUM_FIELD_MULT>
KOKKOS_INLINE_FUNCTION void	operator() (const FieldMultTag< NUM_FIELD_MULT > &tag, const std::size_t &cell) const
	Perform the integration. More...

template<int NUM_FIELD_MULT>
KOKKOS_INLINE_FUNCTION void	operator() (const FieldMultTag< NUM_FIELD_MULT > &, const size_t &cell) const

Public Member Functions inherited from panzer::EvaluatorWithBaseImpl< Traits >
void	setDetailsIndex (const int di)
	An evaluator builder sets the details index. More...

Public Member Functions inherited from PHX::EvaluatorWithBaseImpl< Traits >
virtual void	evaluateFields (typename Traits::EvalData d) override=0

Public Member Functions inherited from PHX::Evaluator< Traits >
	Evaluator ()

virtual	~Evaluator ()

virtual void	postRegistrationSetup (typename Traits::SetupData d, PHX::FieldManager< Traits > &vm)=0

virtual const std::vector < Teuchos::RCP< FieldTag > > &	evaluatedFields () const =0

virtual const std::vector < Teuchos::RCP< FieldTag > > &	contributedFields () const =0

virtual const std::vector < Teuchos::RCP< FieldTag > > &	dependentFields () const =0

virtual const std::vector < Teuchos::RCP< FieldTag > > &	unsharedFields () const =0

virtual void	preEvaluate (typename Traits::PreEvalData d)=0

virtual void	postEvaluate (typename Traits::PostEvalData d)=0

virtual const std::string &	getName () const =0

virtual void	bindField (const PHX::FieldTag &ft, const std::any &f)=0

virtual PHX::DeviceEvaluator < Traits > *	createDeviceEvaluator () const =0

virtual void	rebuildDeviceEvaluator (PHX::DeviceEvaluator< Traits > *e) const =0

virtual void	deleteDeviceEvaluator (PHX::DeviceEvaluator< Traits > *e) const =0

virtual void	printFieldValues (std::ostream &os) const =0

Public Member Functions inherited from panzer::DomainEvaluator
	DomainEvaluator (DomainType domain=ALL)
	Constructor. More...

virtual	~DomainEvaluator ()=default
	Default destructor. More...

void	setDomain (const DomainType domain)
	Set the domain for the evaluator. More...

DomainType	getDomain ()
	Get the domain for the evaluator. More...

virtual int	cellStartIndex (const panzer::Workset &workset) const
	Returns the starting cell for the specified domain for a given workset. More...

virtual int	cellEndIndex (const panzer::Workset &workset) const
	Returns the non-inclusive end cell for the specified domain for a given workset. More...

Private Types
using	ScalarT = typename EvalT::ScalarT
	The scalar type. More...

using	InnerView = PHX::UnmanagedView< ScalarT ** >

using	OuterView = PHX::View< InnerView * >

Private Member Functions
Teuchos::RCP < Teuchos::ParameterList >	getValidParameters () const
	Get Valid Parameters. More...

Private Attributes
const panzer::EvaluatorStyle	evalStyle_
	An `enum` determining the behavior of this `Evaluator`. More...

std::vector< PHX::MDField < ScalarT, Cell, BASIS > >	fields_host_
	The fields to which we'll contribute, or in which we'll store, the result of computing this integral. More...

OuterView	fields_

PHX::MDField< const ScalarT, Cell, IP, Dim >	vector_
	A field representing the vector-valued function we're integrating ( $\vec{s}$ ). More...

double	multiplier_
	The scalar multiplier out in front of the integral ( ). More...

std::vector< PHX::MDField < const ScalarT, Cell, IP > >	fieldMults_
	The (possibly empty) list of fields that are multipliers out in front of the integral ( , , etc.). More...

PHX::View< PHX::UnmanagedView < const ScalarT ** > * >	kokkosFieldMults_
	The `PHX::View` representation of the (possibly empty) list of fields that are multipliers out in front of the integral ( , , etc.). More...

int	numDims_
	The number of dimensions associated with the vector. More...

int	numGradDims_
	The number of dimensions associated with the gradient. More...

std::string	basisName_
	The name of the basis we're using. More...

std::size_t	basisIndex_
	The index in the `Workset` bases for our particular `BasisIRLayout` name. More...

PHX::MDField< double, panzer::Cell, panzer::BASIS, panzer::IP, panzer::Dim >	basis_
	The gradient vector basis information necessary for integration. More...

Additional Inherited Members
Public Types inherited from panzer::DomainEvaluator
enum	DomainType : int { OWNED =0, GHOST =1, REAL =2, VIRTUAL =3, EXTERNAL =4, ALL =5 }
	Domain types supported by worksets. More...

Protected Attributes inherited from panzer::EvaluatorWithBaseImpl< Traits >
WorksetDetailsAccessor	wda

Detailed Description

template<typename EvalT, typename Traits>
class panzer::Integrator_GradBasisCrossVector< EvalT, Traits >

Computes $Ma(x)b(x)\cdots\int(\nabla\phi(x))\times \vec{s}(x)\,dx$ .

Evaluates the integral

$Ma(x)b(x)\cdots\int(\nabla\phi(x))\times\vec{s}(x)\,dx,$

where $ M $ is some constant, $ a(x) $ , $ b(x) $ , etc., are some fields that depend on position, $\vec{s}$ is some vector-valued function, and $\phi$ is some vector basis.

Definition at line 49 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

Member Typedef Documentation

template<typename EvalT , typename Traits >

using panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::ScalarT = typename EvalT::ScalarT

private

The scalar type.

Definition at line 238 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

template<typename EvalT , typename Traits >

using panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::InnerView = PHX::UnmanagedView<ScalarT**>

private

Definition at line 255 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

template<typename EvalT , typename Traits >

using panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::OuterView = PHX::View<InnerView*>

private

Definition at line 256 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

Constructor & Destructor Documentation

template<typename EvalT , typename Traits >

panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::Integrator_GradBasisCrossVector	(	const panzer::EvaluatorStyle &	evalStyle,
		const std::vector< std::string > &	resNames,
		const std::string &	vecName,
		const panzer::BasisIRLayout &	basis,
		const panzer::IntegrationRule &	ir,
		const double &	multiplier = `1`,
		const std::vector< std::string > &	fmNames = `std::vector<std::string>()`,
		const Teuchos::RCP< PHX::DataLayout > &	vecDL = `Teuchos::null`
	)

Main Constructor.

Creates an Evaluator to evaluate the integral

$Ma(x)b(x)\cdots\int(\nabla\phi(x))\times\vec{s}(x)\,dx,$

where $ M $ is some constant, $ a(x) $ , $ b(x) $ , etc., are some fields that depend on position, $\vec{s}$ is some vector-valued function, and $\phi$ is some vector basis.

Parameters

[in]	evalStyle	An `enum` declaring the behavior of this `Evaluator`, which is to either: compute and contribute (`CONTRIBUTES`), or compute and store (`EVALUATES`).
[in]	resNames	The names of either the contributed or evaluated fields, depending on `evalStyle`. This `Evaluator` computes either two or three fields, depending on the dimensionality of $\nabla\phi$ .
[in]	vecName	The name of the vector-valued function being integrated ( $\vec{s}$ ).
[in]	basis	The basis that you'd like to use ( $\phi$ ).
[in]	ir	The integration rule that you'd like to use.
[in]	multiplier	The scalar multiplier out in front of the integral you're computing ( ). If not specified, this defaults to 1.
[in]	fmNames	A list of names of fields that are multipliers out in front of the integral you're computing ( , , etc.). If not specified, this defaults to an empty `vector`.
[in]	vecDL	The vector data layout that you'd like to use. If not specified, this defaults to `Teuchos::null` and the vector data layout from the given `ir` is used.

Exceptions

std::invalid_argument	If any of the inputs are invalid.
std::logic_error	If the `basis` supplied does not support the gradient operator, or if the dimension of the space exceeds the dimension of the vector data layout, or if has fewer components than the dimensionality of the mesh.

Definition at line 40 of file Panzer_Integrator_GradBasisCrossVector_impl.hpp.

template<typename EvalT , typename Traits >

panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::Integrator_GradBasisCrossVector ( const Teuchos::ParameterList & p )

ParameterList Constructor.

Creates an Evaluator to evaluate the integral

$Ma(x)b(x)\cdots\int(\nabla\phi(x))\times\vec{s}(x)\,dx,$

where $ M $ is some constant, $ a(x) $ , $ b(x) $ , etc., are some fields that depend on position, $\vec{s}$ is some vector-valued function, and $\phi$ is some basis.

Note: This constructor exists to preserve the older way of creating an Evaluator with a ParameterList; however, it is strongly advised that you not use this ParameterList Constructor, but rather that you favor the main constructor with its compile-time argument checking instead.

Parameters

[in]

p

A ParameterList of the form

<ParameterList>
  <Parameter name = "Residual Names"     type = "std::vector<std::string>"            value = (required)    />
  <Parameter name = "Vector Name"        type = "std::string"                         value = (required)    />
  <Parameter name = "Basis"              type = "RCP<panzer::BasisIRLayout>"          value = (required)    />
  <Parameter name = "IR"                 type = "RCP<panzer::IntegrationRule>"        value = (required)    />
  <Parameter name = "Multiplier"         type = "double"                              value = (required)    />
  <Parameter name = "Field Multipliers"  type = "RCP<const std::vector<std::string>>" value = null (default)/>
  <Parameter name = "Data Layout Vector" type = "RCP<PHX::DataLayout>"                value = null (default)/>
</ParameterList>

where

"Residual Names" are the names for the terms this Evaluator is evaluating,
"Vector Name" is the name of the vector-valued function being integrated ( $\vec{s}$ ),
"Basis" is the basis that you'd like to use ( $\phi$ ),
"IR" is the integration rule that you'd like to use,
"Multiplier" is the scalar multiplier out in front of the integral you're computing ( ), and
"Field Multipliers" is an optional list of names of fields that are multipliers out in front of the integral you're computing ( , , etc.).
"Data Layout Vector" is the vector data layout that you'd like to use.

Definition at line 154 of file Panzer_Integrator_GradBasisCrossVector_impl.hpp.

Member Function Documentation

template<typename EvalT , typename Traits >

void panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::postRegistrationSetup	(	typename Traits::SetupData	d,
		PHX::FieldManager< Traits > &	fm
	)

Post-Registration Setup.

Sets the basis index, and gets the PHX::View versions of the field multipliers, if there are any.

Parameters

[in]	sd	Essentially a list of `Workset`s, which are collections of cells (elements) that all live on a single process.
[in]	fm	This is an unused part of the `Evaluator` interface.

Definition at line 188 of file Panzer_Integrator_GradBasisCrossVector_impl.hpp.

template<typename EvalT , typename Traits >

void panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::evaluateFields ( typename Traits::EvalData d )

Evaluate Fields.

This actually performs the integration by calling operator()() in a Kokkos::parallel_for over the cells in the Workset.

Parameters

[in] workset The Workset on which you're going to do the integration.

Definition at line 425 of file Panzer_Integrator_GradBasisCrossVector_impl.hpp.

template<typename EvalT , typename Traits >

template<int NUM_FIELD_MULT>

KOKKOS_INLINE_FUNCTION void panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::operator()	(	const FieldMultTag< NUM_FIELD_MULT > &	tag,
		const std::size_t &	cell
	)		const

Perform the integration.

Generally speaking, for a given cell in the Workset, this routine loops over quadrature points and bases to perform the integration, scaling the vector field to be integrated by the multiplier ( $ M $ ) and any field multipliers ( $ a(x) $ , $ b(x) $ , etc.).

Note: Optimizations are made for the cases in which we have no field multipliers or only a single one.

Parameters

[in]	tag	An indication of the number of field multipliers we have; either 0, 1, or something else.
[in]	cell	The cell in the `Workset` over which to integrate.

template<typename EvalT , typename TRAITS >

Teuchos::RCP< Teuchos::ParameterList > panzer::Integrator_GradBasisCrossVector< EvalT, TRAITS >::getValidParameters ( ) const

private

Get Valid Parameters.

Get all the parameters that we support such that the ParameterList Constructor can do some validation of the input ParameterList.

Returns: A ParameterList with all the valid parameters (keys) in it. The values tied to those keys are meaningless default values.

Definition at line 453 of file Panzer_Integrator_GradBasisCrossVector_impl.hpp.

template<typename EvalT , typename Traits >

template<int NUM_FIELD_MULT>

KOKKOS_INLINE_FUNCTION void panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::operator()	(	const FieldMultTag< NUM_FIELD_MULT > &	,
		const size_t &	cell
	)		const

Definition at line 222 of file Panzer_Integrator_GradBasisCrossVector_impl.hpp.

Member Data Documentation

template<typename EvalT , typename Traits >

const panzer::EvaluatorStyle panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::evalStyle_

private

An enum determining the behavior of this Evaluator.

This Evaluator will compute the result of its integration and then:

CONTRIBUTES: contribute it to a specified residual, not saving anything; or
EVALUATES: save it under a specified name for future use.

Definition at line 248 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

template<typename EvalT , typename Traits >

std::vector<PHX::MDField<ScalarT,Cell,BASIS> > panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::fields_host_

private

The fields to which we'll contribute, or in which we'll store, the result of computing this integral.

Definition at line 254 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

template<typename EvalT , typename Traits >

OuterView panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::fields_

private

Definition at line 257 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

template<typename EvalT , typename Traits >

PHX::MDField<const ScalarT, Cell, IP, Dim> panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::vector_

private

A field representing the vector-valued function we're integrating ( $\vec{s}$ ).

Definition at line 263 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

template<typename EvalT , typename Traits >

double panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::multiplier_

private

The scalar multiplier out in front of the integral ( $ M $ ).

Definition at line 269 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

template<typename EvalT , typename Traits >

std::vector<PHX::MDField<const ScalarT, Cell, IP> > panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::fieldMults_

private

The (possibly empty) list of fields that are multipliers out in front of the integral ( $ a(x) $ , $ b(x) $ , etc.).

Definition at line 275 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

template<typename EvalT , typename Traits >

PHX::View<PHX::UnmanagedView<const ScalarT**>*> panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::kokkosFieldMults_

private

The PHX::View representation of the (possibly empty) list of fields that are multipliers out in front of the integral ( $ a(x) $ , $ b(x) $ , etc.).

Definition at line 282 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

template<typename EvalT , typename Traits >

int panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::numDims_

private

The number of dimensions associated with the vector.

Definition at line 287 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

template<typename EvalT , typename Traits >

int panzer::Integrator_GradBasisCrossVector< EvalT, Traits >::numGradDims_

private

The number of dimensions associated with the gradient.

Definition at line 292 of file Panzer_Integrator_GradBasisCrossVector_decl.hpp.

template<typename EvalT , typename Traits >