Intrepid2
Intrepid2_HGRAD_HEX_Cn_FEM.hpp
Go to the documentation of this file.
1// @HEADER
2// *****************************************************************************
3// Intrepid2 Package
4//
5// Copyright 2007 NTESS and the Intrepid2 contributors.
6// SPDX-License-Identifier: BSD-3-Clause
7// *****************************************************************************
8// @HEADER
9
15
16#ifndef __INTREPID2_HGRAD_HEX_CN_FEM_HPP__
17#define __INTREPID2_HGRAD_HEX_CN_FEM_HPP__
18
19#include "Intrepid2_Basis.hpp"
21
22namespace Intrepid2 {
23
24 namespace Impl {
29 public:
30 typedef struct Hexahedron<8> cell_topology_type;
34 template<EOperator opType>
35 struct Serial {
36 template<typename outputValueViewType,
37 typename inputPointViewType,
38 typename workViewType,
39 typename vinvViewType>
40 KOKKOS_INLINE_FUNCTION
41 static void
42 getValues( outputValueViewType outputValues,
43 const inputPointViewType inputPoints,
44 workViewType work,
45 const vinvViewType vinv,
46 const ordinal_type operatorDn = 0 );
47 };
48
49 template<typename DeviceType, ordinal_type numPtsPerEval,
50 typename outputValueValueType, class ...outputValueProperties,
51 typename inputPointValueType, class ...inputPointProperties,
52 typename vinvValueType, class ...vinvProperties>
53 static void
54 getValues( const typename DeviceType::execution_space& space,
55 Kokkos::DynRankView<outputValueValueType,outputValueProperties...> outputValues,
56 const Kokkos::DynRankView<inputPointValueType, inputPointProperties...> inputPoints,
57 const Kokkos::DynRankView<vinvValueType, vinvProperties...> vinv,
58 const EOperator operatorType );
59
63 template<typename outputValueViewType,
64 typename inputPointViewType,
65 typename vinvViewType,
66 typename workViewType,
67 EOperator opType,
68 ordinal_type numPtsEval>
69 struct Functor {
70 outputValueViewType _outputValues;
71 const inputPointViewType _inputPoints;
72 const vinvViewType _vinv;
73 workViewType _work;
74 const ordinal_type _opDn;
75
76 KOKKOS_INLINE_FUNCTION
77 Functor( outputValueViewType outputValues_,
78 inputPointViewType inputPoints_,
79 vinvViewType vinv_,
80 workViewType work_,
81 const ordinal_type opDn_ = 0 )
82 : _outputValues(outputValues_), _inputPoints(inputPoints_),
83 _vinv(vinv_), _work(work_), _opDn(opDn_) {}
84
85 KOKKOS_INLINE_FUNCTION
86 void operator()(const size_type iter) const {
87 const auto ptBegin = Util<ordinal_type>::min(iter*numPtsEval, _inputPoints.extent(0));
88 const auto ptEnd = Util<ordinal_type>::min(ptBegin+numPtsEval, _inputPoints.extent(0));
89
90 const auto ptRange = Kokkos::pair<ordinal_type,ordinal_type>(ptBegin, ptEnd);
91 const auto input = Kokkos::subview( _inputPoints, ptRange, Kokkos::ALL() );
92
93 typename workViewType::pointer_type ptr = _work.data() + _work.extent(0)*ptBegin*get_dimension_scalar(_work);
94
95 workViewType work = createMatchingUnmanagedView<workViewType>(_work, ptr, (ptEnd-ptBegin)*_work.extent(0));
96
97 switch (opType) {
98 case OPERATOR_VALUE : {
99 auto output = Kokkos::subview( _outputValues, Kokkos::ALL(), ptRange );
100 Serial<opType>::getValues( output, input, work, _vinv );
101 break;
102 }
103 case OPERATOR_CURL :
104 case OPERATOR_Dn : {
105 auto output = Kokkos::subview( _outputValues, Kokkos::ALL(), ptRange, Kokkos::ALL() );
106 Serial<opType>::getValues( output, input, work, _vinv, _opDn );
107 break;
108 }
109 default: {
110 INTREPID2_TEST_FOR_ABORT( true,
111 ">>> ERROR: (Intrepid2::Basis_HGRAD_HEX_Cn_FEM::Functor) operator is not supported");
112
113 }
114 }
115 }
116 };
117 };
118 }
119
130
131 template<typename DeviceType = void,
132 typename outputValueType = double,
133 typename pointValueType = double>
135 : public Basis<DeviceType,outputValueType,pointValueType> {
136 public:
137 using BasisBase = Basis<DeviceType,outputValueType,pointValueType>;
138 using typename BasisBase::ExecutionSpace;
139
143
144 using typename BasisBase::OutputViewType;
145 using typename BasisBase::PointViewType ;
146 using typename BasisBase::ScalarViewType;
147
148 private:
150 Kokkos::DynRankView<typename ScalarViewType::value_type,DeviceType> vinv_;
151
153 EPointType pointType_;
154
155 public:
156
159 Basis_HGRAD_HEX_Cn_FEM(const ordinal_type order,
160 const EPointType pointType = POINTTYPE_EQUISPACED);
161
163
164 virtual
165 void
166 getValues( const ExecutionSpace& space,
167 OutputViewType outputValues,
168 const PointViewType inputPoints,
169 const EOperator operatorType = OPERATOR_VALUE ) const override {
170#ifdef HAVE_INTREPID2_DEBUG
172 inputPoints,
173 operatorType,
174 this->getBaseCellTopology(),
175 this->getCardinality() );
176#endif
177 constexpr ordinal_type numPtsPerEval = Parameters::MaxNumPtsPerBasisEval;
178 Impl::Basis_HGRAD_HEX_Cn_FEM::
179 getValues<DeviceType,numPtsPerEval>(space,
180 outputValues,
181 inputPoints,
182 this->vinv_,
183 operatorType);
184 }
185
186 virtual void
187 getScratchSpaceSize( ordinal_type& perTeamSpaceSize,
188 ordinal_type& perThreadSpaceSize,
189 const PointViewType inputPoints,
190 const EOperator operatorType = OPERATOR_VALUE) const override;
191
192 KOKKOS_INLINE_FUNCTION
193 virtual void
194 getValues(
195 OutputViewType outputValues,
196 const PointViewType inputPoints,
197 const EOperator operatorType,
198 const typename Kokkos::TeamPolicy<typename DeviceType::execution_space>::member_type& team_member,
199 const typename DeviceType::execution_space::scratch_memory_space & scratchStorage,
200 const ordinal_type subcellDim = -1,
201 const ordinal_type subcellOrdinal = -1) const override;
202
203
204 virtual
205 void
206 getDofCoords( ScalarViewType dofCoords ) const override {
207#ifdef HAVE_INTREPID2_DEBUG
208 // Verify rank of output array.
209 INTREPID2_TEST_FOR_EXCEPTION( rank(dofCoords) != 2, std::invalid_argument,
210 ">>> ERROR: (Intrepid2::Basis_HGRAD_HEX_Cn_FEM::getDofCoords) rank = 2 required for dofCoords array");
211 // Verify 0th dimension of output array.
212 INTREPID2_TEST_FOR_EXCEPTION( static_cast<ordinal_type>(dofCoords.extent(0)) != this->getCardinality(), std::invalid_argument,
213 ">>> ERROR: (Intrepid2::Basis_HGRAD_HEX_Cn_FEM::getDofCoords) mismatch in number of dof and 0th dimension of dofCoords array");
214 // Verify 1st dimension of output array.
215 INTREPID2_TEST_FOR_EXCEPTION( dofCoords.extent(1) != this->getBaseCellTopology().getDimension(), std::invalid_argument,
216 ">>> ERROR: (Intrepid2::Basis_HGRAD_HEX_Cn_FEM::getDofCoords) incorrect reference cell (1st) dimension in dofCoords array");
217#endif
218 Kokkos::deep_copy(dofCoords, this->dofCoords_);
219 }
220
221 virtual
222 void
223 getDofCoeffs( ScalarViewType dofCoeffs ) const override {
224#ifdef HAVE_INTREPID2_DEBUG
225 // Verify rank of output array.
226 INTREPID2_TEST_FOR_EXCEPTION( rank(dofCoeffs) != 1, std::invalid_argument,
227 ">>> ERROR: (Intrepid2::Basis_HGRAD_HEX_Cn_FEM::getdofCoeffs) rank = 1 required for dofCoeffs array");
228 // Verify 0th dimension of output array.
229 INTREPID2_TEST_FOR_EXCEPTION( static_cast<ordinal_type>(dofCoeffs.extent(0)) != this->getCardinality(), std::invalid_argument,
230 ">>> ERROR: (Intrepid2::Basis_HGRAD_HEX_Cn_FEM::getdofCoeffs) mismatch in number of dof and 0th dimension of dofCoeffs array");
231#endif
232 Kokkos::deep_copy(dofCoeffs, 1.0);
233 }
234
235 virtual
236 const char*
237 getName() const override {
238 return "Intrepid2_HGRAD_HEX_Cn_FEM";
239 }
240
241 virtual
242 bool
243 requireOrientation() const override {
244 return (this->basisDegree_ > 2);
245 }
246
247 Kokkos::DynRankView<typename ScalarViewType::const_value_type,DeviceType>
248 getVandermondeInverse() {
249 return vinv_;
250 }
251
252 ordinal_type
253 getWorkSizePerPoint(const EOperator operatorType) {
254 return 4*getPnCardinality<1>(this->basisDegree_);
255 }
256
265 BasisPtr<DeviceType,outputValueType,pointValueType>
266 getSubCellRefBasis(const ordinal_type subCellDim, const ordinal_type subCellOrd) const override{
267 if(subCellDim == 1) {
268 return Teuchos::rcp(new
270 (this->basisDegree_, pointType_));
271 } else if(subCellDim == 2) {
272 return Teuchos::rcp(new
274 (this->basisDegree_, pointType_));
275 }
276 INTREPID2_TEST_FOR_EXCEPTION(true,std::invalid_argument,"Input parameters out of bounds");
277 }
278
283 };
284
285}// namespace Intrepid2
286
288
289#endif
Header file for the abstract base class Intrepid2::Basis.
void getValues_HGRAD_Args(const outputValueViewType outputValues, const inputPointViewType inputPoints, const EOperator operatorType, const shards::CellTopology cellTopo, const ordinal_type basisCard)
Runtime check of the arguments for the getValues method in an HGRAD-conforming FEM basis....
Teuchos::RCP< Basis< DeviceType, OutputType, PointType > > BasisPtr
Basis Pointer.
Definition file for basis function of degree n for H(grad) functions on HEX cells.
Header file for the Intrepid2::Basis_HGRAD_QUAD_Cn_FEM class.
KOKKOS_INLINE_FUNCTION std::enable_if< std::is_pointer_v< CtorProp > &&!std::is_convertible_v< CtorProp, constchar * >, OutViewType >::type createMatchingUnmanagedView(const InViewType &view, const CtorProp &data, const Dims... dims)
Creates an unmanaged view that matches the value_type of the provided view The type of the output vie...
Basis_HGRAD_HEX_Cn_FEM(const ordinal_type order, const EPointType pointType=POINTTYPE_EQUISPACED)
Constructor.
BasisPtr< DeviceType, outputValueType, pointValueType > getSubCellRefBasis(const ordinal_type subCellDim, const ordinal_type subCellOrd) const override
returns the basis associated to a subCell.
virtual void getDofCoeffs(ScalarViewType dofCoeffs) const override
Coefficients for computing degrees of freedom for Lagrangian basis If P is an element of the space sp...
Kokkos::DynRankView< typename ScalarViewType::value_type, ExecutionSpace > vinv_
BasisPtr< typename Kokkos::HostSpace::device_type, outputValueType, pointValueType > getHostBasis() const override
Creates and returns a Basis object whose DeviceType template argument is Kokkos::HostSpace::device_ty...
virtual void getDofCoords(ScalarViewType dofCoords) const override
Returns spatial locations (coordinates) of degrees of freedom on the reference cell.
virtual bool requireOrientation() const override
True if orientation is required.
virtual const char * getName() const override
Returns basis name.
Implementation of the locally H(grad)-compatible FEM basis of variable order on the [-1,...
Implementation of the default H(grad)-compatible FEM basis of degree n on Quadrilateral cell Implemen...
Kokkos::DynRankView< PointValueType, Kokkos::LayoutStride, DeviceType > PointViewType
virtual KOKKOS_INLINE_FUNCTION void getValues(OutputViewType, const PointViewType, const EOperator, const typename Kokkos::TeamPolicy< ExecutionSpace >::member_type &teamMember, const typename ExecutionSpace::scratch_memory_space &scratchStorage, const ordinal_type subcellDim=-1, const ordinal_type subcellOrdinal=-1) const
Team-level evaluation of basis functions on a reference cell.
Kokkos::DynRankView< OutputValueType, Kokkos::LayoutStride, DeviceType > OutputViewType
Kokkos::View< ordinal_type ***, typename ExecutionSpace::array_layout, Kokkos::HostSpace > OrdinalTypeArray3DHost
ordinal_type basisDegree_
Degree of the largest complete polynomial space that can be represented by the basis.
Kokkos::DynRankView< scalarType, Kokkos::LayoutStride, DeviceType > ScalarViewType
Kokkos::DynRankView< scalarType, DeviceType > dofCoords_
Coordinates of degrees-of-freedom for basis functions defined in physical space.
Kokkos::View< ordinal_type **, typename ExecutionSpace::array_layout, Kokkos::HostSpace > OrdinalTypeArray2DHost
shards::CellTopology getBaseCellTopology() const
Kokkos::View< ordinal_type *, typename ExecutionSpace::array_layout, Kokkos::HostSpace > OrdinalTypeArray1DHost
See Intrepid2::Basis_HGRAD_HEX_Cn_FEM.
static constexpr ordinal_type MaxNumPtsPerBasisEval
The maximum number of points to eval in serial mode.