Intrepid2
Public Types | Public Member Functions | Private Attributes | List of all members
Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE > Class Template Reference

Implementation of H(vol) basis on the quadrilateral that is templated on H(vol) on the line. More...

#include <Intrepid2_DerivedBasis_HVOL_HEX.hpp>

Inheritance diagram for Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >:
Intrepid2::Basis_TensorBasis< HVOL_LINE::BasisBase >

Public Types

using ExecutionSpace = typename HVOL_LINE::ExecutionSpace
 
using OutputValueType = typename HVOL_LINE::OutputValueType
 
using PointValueType = typename HVOL_LINE::PointValueType
 
using OutputViewType = typename HVOL_LINE::OutputViewType
 
using PointViewType = typename HVOL_LINE::PointViewType
 
using ScalarViewType = typename HVOL_LINE::ScalarViewType
 
using BasisBase = typename HVOL_LINE::BasisBase
 
using LineBasis = HVOL_LINE
 
using QuadBasis = Intrepid2::Basis_Derived_HVOL_QUAD<HVOL_LINE>
 
using TensorBasis = Basis_TensorBasis<BasisBase>
 
- Public Types inherited from Intrepid2::Basis_TensorBasis< HVOL_LINE::BasisBase >
using BasisBase
 
using BasisPtr
 
using DeviceType
 
using ExecutionSpace
 
using OutputValueType
 
using PointValueType
 
using OrdinalTypeArray1DHost
 
using OrdinalTypeArray2DHost
 
using OutputViewType
 
using PointViewType
 
using TensorBasis
 

Public Member Functions

 Basis_Derived_HVOL_HEX (int polyOrder_x, int polyOrder_y, int polyOrder_z, const EPointType pointType=POINTTYPE_DEFAULT)
 Constructor.
 
 Basis_Derived_HVOL_HEX (int polyOrder, const EPointType pointType=POINTTYPE_DEFAULT)
 Constructor.
 
virtual const char * getName () const override
 Returns basis name.
 
virtual bool requireOrientation () const override
 True if orientation is required.
 
virtual OperatorTensorDecomposition getSimpleOperatorDecomposition (const EOperator &operatorType) const override
 Returns a simple decomposition of the specified operator: what operator(s) should be applied to basis1, and what operator(s) to basis2. A one-element OperatorTensorDecomposition corresponds to a single TensorData entry; a multiple-element OperatorTensorDecomposition corresponds to a VectorData object with axialComponents = false.
 
virtual BasisPtr< typename Kokkos::HostSpace::device_type, typename BasisBase::OutputValueType, typename BasisBase::PointValueType > getHostBasis () const override
 Creates and returns a Basis object whose DeviceType template argument is Kokkos::HostSpace::device_type, but is otherwise identical to this.
 
virtual void getValues (BasisValues< OutputValueType, DeviceType > outputValues, const TensorPoints< PointValueType, DeviceType > inputPoints, const EOperator operatorType=OPERATOR_VALUE) const override
 Evaluation of a FEM basis on a reference cell, using point and output value containers that allow preservation of tensor-product structure.
 
void getValues (OutputViewType outputValues, const PointViewType inputPoints, const EOperator operatorType=OPERATOR_VALUE) const override
 Evaluation of a FEM basis on a reference cell.
 
virtual void getValues (OutputViewType outputValues, const EOperator operatorType, const PointViewType inputPoints1, const PointViewType inputPoints2, bool tensorPoints) const
 Evaluation of a tensor FEM basis on a reference cell; subclasses should override this.
 
void getValues (OutputViewType outputValues, const PointViewType inputPoints1, const EOperator operatorType1, const PointViewType inputPoints2, const EOperator operatorType2, bool tensorPoints, double weight=1.0) const
 Evaluation of a tensor FEM basis on a reference cell.
 
- Public Member Functions inherited from Intrepid2::Basis_TensorBasis< HVOL_LINE::BasisBase >
 Basis_TensorBasis (BasisPtr basis1, BasisPtr basis2, EFunctionSpace functionSpace=FUNCTION_SPACE_MAX, const bool useShardsCellTopologyAndTags=false)
 Constructor.
 
void setShardsTopologyAndTags ()
 
virtual int getNumTensorialExtrusions () const override
 
ordinal_type getTensorDkEnumeration (ordinal_type dkEnum1, ordinal_type operatorOrder1, ordinal_type dkEnum2, ordinal_type operatorOrder2) const
 Given "Dk" enumeration indices for the component bases, returns a Dk enumeration index for the composite basis.
 
virtual OperatorTensorDecomposition getOperatorDecomposition (const EOperator operatorType) const
 Returns a full decomposition of the specified operator. (Full meaning that all TensorBasis components are expanded into their non-TensorBasis components.)
 
virtual BasisValues< OutputValueType, DeviceType > allocateBasisValues (TensorPoints< PointValueType, DeviceType > points, const EOperator operatorType=OPERATOR_VALUE) const override
 Allocate BasisValues container suitable for passing to the getValues() variant that takes a TensorPoints container as argument.
 
void getComponentPoints (const PointViewType inputPoints, const bool attemptTensorDecomposition, PointViewType &inputPoints1, PointViewType &inputPoints2, bool &tensorDecompositionSucceeded) const
 Method to extract component points from composite points.
 
virtual void getDofCoords (typename BasisBase::ScalarViewType dofCoords) const override
 Fills in spatial locations (coordinates) of degrees of freedom (nodes) on the reference cell.
 
virtual void getDofCoeffs (typename BasisBase::ScalarViewType dofCoeffs) const override
 Fills in coefficients of degrees of freedom on the reference cell.
 
std::vector< BasisPtr > getTensorBasisComponents () const
 
virtual void getValues (BasisValues< OutputValueType, DeviceType > outputValues, const TensorPoints< PointValueType, DeviceType > inputPoints, const EOperator operatorType=OPERATOR_VALUE) const override
 Evaluation of a FEM basis on a reference cell, using point and output value containers that allow preservation of tensor-product structure.
 
void getValues (OutputViewType outputValues, const PointViewType inputPoints, const EOperator operatorType=OPERATOR_VALUE) const override
 Evaluation of a FEM basis on a reference cell.
 
virtual void getValues (OutputViewType outputValues, const EOperator operatorType, const PointViewType inputPoints1, const PointViewType inputPoints2, bool tensorPoints) const
 Evaluation of a tensor FEM basis on a reference cell; subclasses should override this.
 
void getValues (OutputViewType outputValues, const PointViewType inputPoints1, const EOperator operatorType1, const PointViewType inputPoints2, const EOperator operatorType2, bool tensorPoints, double weight=1.0) const
 Evaluation of a tensor FEM basis on a reference cell.
 

Private Attributes

std::string name_
 
ordinal_type polyOrder_x_
 
ordinal_type polyOrder_y_
 
ordinal_type polyOrder_z_
 
EPointType pointType_
 

Additional Inherited Members

- Protected Attributes inherited from Intrepid2::Basis_TensorBasis< HVOL_LINE::BasisBase >
BasisPtr basis1_
 
BasisPtr basis2_
 
std::vector< BasisPtr > tensorComponents_
 
std::string name_
 
int numTensorialExtrusions_
 

Detailed Description

template<class HVOL_LINE>
class Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >

Implementation of H(vol) basis on the quadrilateral that is templated on H(vol) on the line.

Definition at line 70 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

Member Typedef Documentation

◆ BasisBase

template<class HVOL_LINE >
using Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::BasisBase = typename HVOL_LINE::BasisBase

Definition at line 87 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ ExecutionSpace

template<class HVOL_LINE >
using Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::ExecutionSpace = typename HVOL_LINE::ExecutionSpace

Definition at line 79 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ LineBasis

template<class HVOL_LINE >
using Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::LineBasis = HVOL_LINE

Definition at line 89 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ OutputValueType

template<class HVOL_LINE >
using Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::OutputValueType = typename HVOL_LINE::OutputValueType

Definition at line 80 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ OutputViewType

template<class HVOL_LINE >
using Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::OutputViewType = typename HVOL_LINE::OutputViewType

Definition at line 83 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ PointValueType

template<class HVOL_LINE >
using Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::PointValueType = typename HVOL_LINE::PointValueType

Definition at line 81 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ PointViewType

template<class HVOL_LINE >
using Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::PointViewType = typename HVOL_LINE::PointViewType

Definition at line 84 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ QuadBasis

template<class HVOL_LINE >
using Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::QuadBasis = Intrepid2::Basis_Derived_HVOL_QUAD<HVOL_LINE>

Definition at line 90 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ ScalarViewType

template<class HVOL_LINE >
using Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::ScalarViewType = typename HVOL_LINE::ScalarViewType

Definition at line 85 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ TensorBasis

template<class HVOL_LINE >
using Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::TensorBasis = Basis_TensorBasis<BasisBase>

Definition at line 91 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

Constructor & Destructor Documentation

◆ Basis_Derived_HVOL_HEX() [1/2]

template<class HVOL_LINE >
Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::Basis_Derived_HVOL_HEX ( int polyOrder_x,
int polyOrder_y,
int polyOrder_z,
const EPointType pointType = POINTTYPE_DEFAULT )
inline

Constructor.

Parameters
[in]polyOrder_x- the polynomial order in the x dimension.
[in]polyOrder_y- the polynomial order in the y dimension.
[in]polyOrder_z- the polynomial order in the z dimension.
[in]pointType- type of lattice used for creating the DoF coordinates.

Definition at line 99 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

References Intrepid2::Basis_TensorBasis< BasisBaseClass >::getName().

◆ Basis_Derived_HVOL_HEX() [2/2]

template<class HVOL_LINE >
Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::Basis_Derived_HVOL_HEX ( int polyOrder,
const EPointType pointType = POINTTYPE_DEFAULT )
inline

Constructor.

Parameters
[in]polyOrder- the polynomial order to use in all dimensions.
[in]pointType- type of lattice used for creating the DoF coordinates.

Definition at line 121 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

Member Function Documentation

◆ getHostBasis()

template<class HVOL_LINE >
virtual BasisPtr< typename Kokkos::HostSpace::device_type, typename BasisBase::OutputValueType, typename BasisBase::PointValueType > Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::getHostBasis ( ) const
inlineoverridevirtual

Creates and returns a Basis object whose DeviceType template argument is Kokkos::HostSpace::device_type, but is otherwise identical to this.

Returns
Pointer to the new Basis object.

Reimplemented from Intrepid2::Basis_TensorBasis< HVOL_LINE::BasisBase >.

Definition at line 160 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ getName()

template<class HVOL_LINE >
virtual const char * Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::getName ( ) const
inlineoverridevirtual

Returns basis name.

Returns
the name of the basis

Reimplemented from Intrepid2::Basis_TensorBasis< HVOL_LINE::BasisBase >.

Definition at line 129 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ getSimpleOperatorDecomposition()

template<class HVOL_LINE >
virtual OperatorTensorDecomposition Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::getSimpleOperatorDecomposition ( const EOperator & operatorType) const
inlineoverridevirtual

Returns a simple decomposition of the specified operator: what operator(s) should be applied to basis1, and what operator(s) to basis2. A one-element OperatorTensorDecomposition corresponds to a single TensorData entry; a multiple-element OperatorTensorDecomposition corresponds to a VectorData object with axialComponents = false.

Subclasses must override this method.

Reimplemented from Intrepid2::Basis_TensorBasis< HVOL_LINE::BasisBase >.

Definition at line 139 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ getValues() [1/4]

template<class HVOL_LINE >
virtual void Intrepid2::Basis_TensorBasis< BasisBaseClass >::getValues ( BasisValues< OutputValueType, DeviceType > outputValues,
const TensorPoints< PointValueType, DeviceType > inputPoints,
const EOperator operatorType = OPERATOR_VALUE ) const
inlineoverride

Evaluation of a FEM basis on a reference cell, using point and output value containers that allow preservation of tensor-product structure.

Returns values of operatorType acting on FEM basis functions for a set of points in the reference cell for which the basis is defined.

Parameters
outputValues[out] - variable rank array with the basis values. Should be allocated using Basis::allocateBasisValues().
inputPoints[in] - rank-2 array (P,D) with the evaluation points. This should be allocated using Cubature::allocateCubaturePoints() and filled using Cubature::getCubature().
operatorType[in] - the operator acting on the basis function

This is the preferred getValues() method for TensorBasis and DirectSumBasis and their subclasses. It allows a reduced memory footprint and optimized integration, etc.

Definition at line 1459 of file Intrepid2_TensorBasis.hpp.

◆ getValues() [2/4]

template<class HVOL_LINE >
virtual void Intrepid2::Basis_TensorBasis< BasisBaseClass >::getValues ( OutputViewType outputValues,
const EOperator operatorType,
const PointViewType inputPoints1,
const PointViewType inputPoints2,
bool tensorPoints ) const
inline

Evaluation of a tensor FEM basis on a reference cell; subclasses should override this.

Returns values of operatorType acting on FEM basis functions for a set of points in the reference cell for which the basis is defined.

Parameters
outputValues[out] - variable rank array with the basis values
operatorType[in] - the operator acting on the basis functions
inputPoints1[in] - rank-2 array (P1,D1) with the evaluation points for basis1
inputPoints2[in] - rank-2 array (P2,D2) with the evaluation points for basis2
tensorPoints[in] - whether the points should be interpreted as tensor components of the evaluation points, or in a one-to-one correspondence

Subclasses should override this method; this gives them an opportunity to specify how operatorType should be decomposed into operators on the component bases.

If tensorPoints is true, then the points dimension of outputValues should be (P1*P2). If tensorPoints is false, then P1 should equal P2, and these should match the points dimension of outputValues.

There are three variants of getValues:

  1. The three-argument version defined by Intrepid2::Basis. TensorBasis provides an implementation of this, which calls the five-argument version (this one).
  2. The five-argument version (this method), which provides separate point sets for the component bases, and must be specified by subclasses. Typical implementations call the seven-argument version.
  3. The seven-argument version (below), implemented by TensorBasis, which provides separate point sets and operators for the component bases, as well as an optional weight.

The intent is that subclasses implement this five-argument version; in that implementation, they need to do little else than call the seven-argument version below.

Note that the three-argument implementation handles the OPERATOR_Dn operators directly; that is, subclasses can omit any consideration of OPERATOR_Dn operators in their implementation of the five-argument version.

Definition at line 1756 of file Intrepid2_TensorBasis.hpp.

◆ getValues() [3/4]

template<class HVOL_LINE >
void Intrepid2::Basis_TensorBasis< BasisBaseClass >::getValues ( OutputViewType outputValues,
const PointViewType inputPoints,
const EOperator operatorType = OPERATOR_VALUE ) const
inlineoverride

Evaluation of a FEM basis on a reference cell.

Returns values of operatorType acting on FEM basis functions for a set of points in the reference cell for which the basis is defined.

Parameters
outputValues[out] - variable rank array with the basis values
inputPoints[in] - rank-2 array (P,D) with the evaluation points
operatorType[in] - the operator acting on the basis functions
Remarks
For rank and dimension specifications of the output array see Section MD array template arguments for basis methods. Dimensions of ArrayScalar arguments are checked at runtime if HAVE_INTREPID2_DEBUG is defined.
A FEM basis spans a COMPLETE or INCOMPLETE polynomial space on the reference cell which is a smooth function space. Thus, all operator types that are meaningful for the approximated function space are admissible. When the order of the operator exceeds the degree of the basis, the output array is filled with the appropriate number of zeros.

Definition at line 1614 of file Intrepid2_TensorBasis.hpp.

◆ getValues() [4/4]

template<class HVOL_LINE >
void Intrepid2::Basis_TensorBasis< BasisBaseClass >::getValues ( OutputViewType outputValues,
const PointViewType inputPoints1,
const EOperator operatorType1,
const PointViewType inputPoints2,
const EOperator operatorType2,
bool tensorPoints,
double weight = 1.0 ) const
inline

Evaluation of a tensor FEM basis on a reference cell.

Returns values of operatorType acting on FEM basis functions for a set of points in the reference cell for which the basis is defined.

Parameters
outputValues[out] - variable rank array with the basis values
inputPoints1[in] - rank-2 array (P1,D1) with the evaluation points for basis1
operatorType1[in] - the operator acting on basis1
inputPoints2[in] - rank-2 array (P2,D2) with the evaluation points for basis2
operatorType2[in] - the operator acting on basis2
tensorPoints[in] - whether the points should be interpreted as tensor components of the evaluation points, or in a one-to-one correspondence
weight[in] - optional weight (typically 1.0 or -1.0)

If tensorPoints is true, then the points dimension of outputValues should be (P1*P2). If tensorPoints is false, then P1 should equal P2, and these should match the points dimension of outputValues.

There are three variants of getValues:

  1. The three-argument version defined by Intrepid2::Basis. TensorBasis provides an implementation of this, which calls the five-argument version (this one).
  2. The five-argument version (above), which provides separate point sets for the component bases, and must be specified by subclasses. Typical implementations call the seven-argument version.
  3. The seven-argument version (this method), implemented by TensorBasis, which provides separate point sets and operators for the component bases, as well as an optional weight.

Subclasses should override the five-argument version above; in their implementation, they need to do little else than call this seven-argument version.

Definition at line 1786 of file Intrepid2_TensorBasis.hpp.

◆ requireOrientation()

template<class HVOL_LINE >
virtual bool Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::requireOrientation ( ) const
inlineoverridevirtual

True if orientation is required.

Definition at line 135 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

Member Data Documentation

◆ name_

template<class HVOL_LINE >
std::string Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::name_
private

Definition at line 75 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ pointType_

template<class HVOL_LINE >
EPointType Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::pointType_
private

Definition at line 77 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ polyOrder_x_

template<class HVOL_LINE >
ordinal_type Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::polyOrder_x_
private

Definition at line 76 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ polyOrder_y_

template<class HVOL_LINE >
ordinal_type Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::polyOrder_y_
private

Definition at line 76 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.

◆ polyOrder_z_

template<class HVOL_LINE >
ordinal_type Intrepid2::Basis_Derived_HVOL_HEX< HVOL_LINE >::polyOrder_z_
private

Definition at line 76 of file Intrepid2_DerivedBasis_HVOL_HEX.hpp.


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