Intrepid2
Intrepid2_HCURL_HEX_In_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
16#ifndef __INTREPID2_HCURL_HEX_IN_FEM_HPP__
17#define __INTREPID2_HCURL_HEX_IN_FEM_HPP__
18
19#include "Intrepid2_Basis.hpp"
21
22namespace Intrepid2 {
23
24 namespace Impl {
25
30 public:
31 typedef struct Hexahedron<8> cell_topology_type;
32
36 template<EOperator opType>
37 struct Serial {
38 template<typename outputValueViewType,
39 typename inputPointViewType,
40 typename workViewType,
41 typename vinvViewType>
42 KOKKOS_INLINE_FUNCTION
43 static void
44 getValues( outputValueViewType outputValues,
45 const inputPointViewType inputPoints,
46 workViewType work,
47 const vinvViewType vinvLine,
48 const vinvViewType vinvBubble );
49
50 KOKKOS_INLINE_FUNCTION
51 static ordinal_type
52 getWorkSizePerPoint(ordinal_type order) {
53 switch(opType) {
54 case OPERATOR_VALUE:
55 return 3*getPnCardinality<1>(order)+getPnCardinality<1>(order-1);
56 case OPERATOR_CURL:
57 return 5*getPnCardinality<1>(order)+getPnCardinality<1>(order-1);
58 default: {
59 INTREPID2_TEST_FOR_ABORT( true,
60 ">>> ERROR: (Intrepid2::Basis_HCURL_HEX_In_FEM::Serial::getWorkSizePerPoint) operator is not supported" );
61 return 0;
62 }
63 }
64 }
65 };
66
67 template<typename DeviceType, ordinal_type numPtsPerEval,
68 typename outputValueValueType, class ...outputValueProperties,
69 typename inputPointValueType, class ...inputPointProperties,
70 typename vinvValueType, class ...vinvProperties>
71 static void
72 getValues( Kokkos::DynRankView<outputValueValueType,outputValueProperties...> outputValues,
73 const Kokkos::DynRankView<inputPointValueType, inputPointProperties...> inputPoints,
74 const Kokkos::DynRankView<vinvValueType, vinvProperties...> vinvLine,
75 const Kokkos::DynRankView<vinvValueType, vinvProperties...> vinvBubble,
76 const EOperator operatorType );
77
81 template<typename outputValueViewType,
82 typename inputPointViewType,
83 typename vinvViewType,
84 typename workViewType,
85 EOperator opType,
86 ordinal_type numPtsEval>
87 struct Functor {
88 outputValueViewType _outputValues;
89 const inputPointViewType _inputPoints;
90 const vinvViewType _vinvLine;
91 const vinvViewType _vinvBubble;
92 workViewType _work;
93
94 KOKKOS_INLINE_FUNCTION
95 Functor( outputValueViewType outputValues_,
96 inputPointViewType inputPoints_,
97 vinvViewType vinvLine_,
98 vinvViewType vinvBubble_,
99 workViewType work_)
100 : _outputValues(outputValues_), _inputPoints(inputPoints_),
101 _vinvLine(vinvLine_), _vinvBubble(vinvBubble_), _work(work_) {}
102
103 KOKKOS_INLINE_FUNCTION
104 void operator()(const size_type iter) const {
105 const auto ptBegin = Util<ordinal_type>::min(iter*numPtsEval, _inputPoints.extent(0));
106 const auto ptEnd = Util<ordinal_type>::min(ptBegin+numPtsEval, _inputPoints.extent(0));
107
108 const auto ptRange = Kokkos::pair<ordinal_type,ordinal_type>(ptBegin, ptEnd);
109 const auto input = Kokkos::subview( _inputPoints, ptRange, Kokkos::ALL() );
110
111 typename workViewType::pointer_type ptr = _work.data() + _work.extent(0)*ptBegin*get_dimension_scalar(_work);
112
113 auto vcprop = Kokkos::common_view_alloc_prop(_work);
114 workViewType work(Kokkos::view_wrap(ptr,vcprop), (ptEnd-ptBegin)*_work.extent(0));
115
116 switch (opType) {
117 case OPERATOR_VALUE : {
118 auto output = Kokkos::subview( _outputValues, Kokkos::ALL(), ptRange, Kokkos::ALL() );
119 Serial<opType>::getValues( output, input, work, _vinvLine, _vinvBubble );
120 break;
121 }
122 case OPERATOR_CURL : {
123 auto output = Kokkos::subview( _outputValues, Kokkos::ALL(), ptRange, Kokkos::ALL() );
124 Serial<opType>::getValues( output, input, work, _vinvLine, _vinvBubble );
125 break;
126 }
127 default: {
128 INTREPID2_TEST_FOR_ABORT( true,
129 ">>> ERROR: (Intrepid2::Basis_HCURL_HEX_In_FEM::Functor) operator is not supported." );
130
131 }
132 }
133 }
134 };
135 };
136 }
137
145 template<typename DeviceType = void,
146 typename outputValueType = double,
147 typename pointValueType = double>
149 : public Basis<DeviceType,outputValueType,pointValueType> {
150 public:
152 using OrdinalTypeArray1DHost = typename BasisBase::OrdinalTypeArray1DHost;
153 using OrdinalTypeArray2DHost = typename BasisBase::OrdinalTypeArray2DHost;
154 using OrdinalTypeArray3DHost = typename BasisBase::OrdinalTypeArray3DHost;
155
158 Basis_HCURL_HEX_In_FEM(const ordinal_type order,
159 const EPointType pointType = POINTTYPE_EQUISPACED);
160
161 using OutputViewType = typename BasisBase::OutputViewType;
162 using PointViewType = typename BasisBase::PointViewType;
163 using ScalarViewType = typename BasisBase::ScalarViewType;
164
166
167 virtual
168 void
169 getValues( OutputViewType outputValues,
170 const PointViewType inputPoints,
171 const EOperator operatorType = OPERATOR_VALUE ) const override {
172#ifdef HAVE_INTREPID2_DEBUG
174 inputPoints,
175 operatorType,
176 this->getBaseCellTopology(),
177 this->getCardinality() );
178#endif
179 constexpr ordinal_type numPtsPerEval = 1;
180 Impl::Basis_HCURL_HEX_In_FEM::
181 getValues<DeviceType,numPtsPerEval>( outputValues,
182 inputPoints,
183 this->vinvLine_,
184 this->vinvBubble_,
185 operatorType );
186 }
187
188 virtual void
189 getScratchSpaceSize( ordinal_type& perTeamSpaceSize,
190 ordinal_type& perThreadSpaceSize,
191 const PointViewType inputPointsconst,
192 const EOperator operatorType = OPERATOR_VALUE) const override;
193
194 KOKKOS_INLINE_FUNCTION
195 virtual void
196 getValues(
197 OutputViewType outputValues,
198 const PointViewType inputPoints,
199 const EOperator operatorType,
200 const typename Kokkos::TeamPolicy<typename DeviceType::execution_space>::member_type& team_member,
201 const typename DeviceType::execution_space::scratch_memory_space & scratchStorage,
202 const ordinal_type subcellDim = -1,
203 const ordinal_type subcellOrdinal = -1) const override;
204
205 virtual
206 void
207 getDofCoords( ScalarViewType dofCoords ) const override {
208#ifdef HAVE_INTREPID2_DEBUG
209 // Verify rank of output array.
210 INTREPID2_TEST_FOR_EXCEPTION( dofCoords.rank() != 2, std::invalid_argument,
211 ">>> ERROR: (Intrepid2::Basis_HCURL_HEX_In_FEM::getDofCoords) rank = 2 required for dofCoords array");
212 // Verify 0th dimension of output array.
213 INTREPID2_TEST_FOR_EXCEPTION( static_cast<ordinal_type>(dofCoords.extent(0)) != this->getCardinality(), std::invalid_argument,
214 ">>> ERROR: (Intrepid2::Basis_HCURL_HEX_In_FEM::getDofCoords) mismatch in number of dof and 0th dimension of dofCoords array");
215 // Verify 1st dimension of output array.
216 INTREPID2_TEST_FOR_EXCEPTION( dofCoords.extent(1) != this->getBaseCellTopology().getDimension(), std::invalid_argument,
217 ">>> ERROR: (Intrepid2::Basis_HCURL_HEX_In_FEM::getDofCoords) incorrect reference cell (1st) dimension in dofCoords array");
218#endif
219 Kokkos::deep_copy(dofCoords, this->dofCoords_);
220 }
221
222 virtual
223 void
224 getDofCoeffs( ScalarViewType dofCoeffs ) const override {
225#ifdef HAVE_INTREPID2_DEBUG
226 // Verify rank of output array.
227 INTREPID2_TEST_FOR_EXCEPTION( dofCoeffs.rank() != 2, std::invalid_argument,
228 ">>> ERROR: (Intrepid2::Basis_HCURL_HEX_In_FEM::getDofCoeffs) rank = 2 required for dofCoeffs array");
229 // Verify 0th dimension of output array.
230 INTREPID2_TEST_FOR_EXCEPTION( static_cast<ordinal_type>(dofCoeffs.extent(0)) != this->getCardinality(), std::invalid_argument,
231 ">>> ERROR: (Intrepid2::Basis_HCURL_HEX_In_FEM::getDofCoeffs) mismatch in number of dof and 0th dimension of dofCoeffs array");
232 // Verify 1st dimension of output array.
233 INTREPID2_TEST_FOR_EXCEPTION( dofCoeffs.extent(1) != this->getBaseCellTopology().getDimension(), std::invalid_argument,
234 ">>> ERROR: (Intrepid2::Basis_HCURL_HEX_In_FEM::getDofCoeffs) incorrect reference cell (1st) dimension in dofCoeffs array");
235#endif
236 Kokkos::deep_copy(dofCoeffs, this->dofCoeffs_);
237 }
238
239 virtual
240 const char*
241 getName() const override {
242 return "Intrepid2_HCURL_HEX_In_FEM";
243 }
244
245 virtual
246 bool
247 requireOrientation() const override {
248 return true;
249 }
250
261 getSubCellRefBasis(const ordinal_type subCellDim, const ordinal_type subCellOrd) const override{
262 if(subCellDim == 1) {
263 return Teuchos::rcp(new
265 (this->basisDegree_-1, POINTTYPE_GAUSS));
266 } else if(subCellDim == 2) {
267 return Teuchos::rcp(new
269 (this->basisDegree_, pointType_));
270 }
271 INTREPID2_TEST_FOR_EXCEPTION(true,std::invalid_argument,"Input parameters out of bounds");
272 }
273
278
279 private:
280
282 Kokkos::DynRankView<typename ScalarViewType::value_type,DeviceType> vinvLine_, vinvBubble_;
283
285 EPointType pointType_;
286 };
287
288}// namespace Intrepid2
289
290
291
293
294#endif
Header file for the abstract base class Intrepid2::Basis.
Teuchos::RCP< Basis< DeviceType, OutputType, PointType > > BasisPtr
Basis Pointer.
void getValues_HCURL_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 HCURL-conforming FEM basis....
Definition file for FEM basis functions of degree n for H(curl) functions on HEX cells.
Header file for the Intrepid2::Basis_HCURL_QUAD_In_FEM class.
Implementation of the default H(curl)-compatible FEM basis on Hexahedron cell.
virtual bool requireOrientation() const override
True if orientation is required.
Kokkos::DynRankView< typename ScalarViewType::value_type, DeviceType > vinvLine_
inverse of Generalized Vandermonde matrix (isotropic order)
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.
BasisPtr< DeviceType, outputValueType, pointValueType > getSubCellRefBasis(const ordinal_type subCellDim, const ordinal_type subCellOrd) const override
returns the basis associated to a subCell.
EPointType pointType_
type of lattice used for creating the DoF coordinates
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...
virtual const char * getName() const override
Returns basis name.
Implementation of the default H(curl)-compatible FEM basis on Quadrilateral cell.
Implementation of the locally HVOL-compatible FEM basis of variable order on the [-1,...
An abstract base class that defines interface for concrete basis implementations for Finite Element (...
Kokkos::DynRankView< PointValueType, Kokkos::LayoutStride, DeviceType > PointViewType
View type for input points.
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
View type for basis value output.
Kokkos::View< ordinal_type ***, typename ExecutionSpace::array_layout, Kokkos::HostSpace > OrdinalTypeArray3DHost
View type for 3d host array.
ordinal_type basisDegree_
Degree of the largest complete polynomial space that can be represented by the basis.
ordinal_type getCardinality() const
Returns cardinality of the basis.
Kokkos::DynRankView< scalarType, Kokkos::LayoutStride, DeviceType > ScalarViewType
View type for scalars.
Kokkos::DynRankView< scalarType, DeviceType > dofCoords_
Coordinates of degrees-of-freedom for basis functions defined in physical space.
Kokkos::DynRankView< scalarType, DeviceType > dofCoeffs_
Coefficients for computing degrees of freedom for Lagrangian basis If P is an element of the space sp...
Kokkos::View< ordinal_type **, typename ExecutionSpace::array_layout, Kokkos::HostSpace > OrdinalTypeArray2DHost
View type for 2d host array.
shards::CellTopology getBaseCellTopology() const
Returns the base cell topology for which the basis is defined. See Shards documentation https://trili...
Kokkos::View< ordinal_type *, typename ExecutionSpace::array_layout, Kokkos::HostSpace > OrdinalTypeArray1DHost
View type for 1d host array.
See Intrepid2::Basis_HCURL_HEX_In_FEM.
small utility functions