Intrepid2
Intrepid2_HDIV_HEX_I1_FEM.hpp
Go to the documentation of this file.
1 // @HEADER
2 // ************************************************************************
3 //
4 // Intrepid2 Package
5 // Copyright (2007) Sandia Corporation
6 //
7 // Under terms of Contract DE-AC04-94AL85000, there is a non-exclusive
8 // license for use of this work by or on behalf of the U.S. Government.
9 //
10 // Redistribution and use in source and binary forms, with or without
11 // modification, are permitted provided that the following conditions are
12 // met:
13 //
14 // 1. Redistributions of source code must retain the above copyright
15 // notice, this list of conditions and the following disclaimer.
16 //
17 // 2. Redistributions in binary form must reproduce the above copyright
18 // notice, this list of conditions and the following disclaimer in the
19 // documentation and/or other materials provided with the distribution.
20 //
21 // 3. Neither the name of the Corporation nor the names of the
22 // contributors may be used to endorse or promote products derived from
23 // this software without specific prior written permission.
24 //
25 // THIS SOFTWARE IS PROVIDED BY SANDIA CORPORATION "AS IS" AND ANY
26 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28 // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SANDIA CORPORATION OR THE
29 // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
30 // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
31 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
32 // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
33 // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
34 // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
35 // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36 //
37 // Questions? Contact Kyungjoo Kim (kyukim@sandia.gov), or
38 // Mauro Perego (mperego@sandia.gov)
39 //
40 // ************************************************************************
41 // @HEADER
42 
49 #ifndef __INTREPID2_HDIV_HEX_I1_FEM_HPP__
50 #define __INTREPID2_HDIV_HEX_I1_FEM_HPP__
51 
52 #include "Intrepid2_Basis.hpp"
54 
55 namespace Intrepid2 {
56 
106  namespace Impl {
107 
112  public:
113  typedef struct Hexahedron<8> cell_topology_type;
117  template<EOperator opType>
118  struct Serial {
119  template<typename OutputViewType,
120  typename inputViewType>
121  KOKKOS_INLINE_FUNCTION
122  static void
123  getValues( OutputViewType output,
124  const inputViewType input );
125  };
126 
127  template<typename DeviceType,
128  typename outputValueValueType, class ...outputValueProperties,
129  typename inputPointValueType, class ...inputPointProperties>
130  static void
131  getValues( Kokkos::DynRankView<outputValueValueType,outputValueProperties...> outputValues,
132  const Kokkos::DynRankView<inputPointValueType, inputPointProperties...> inputPoints,
133  const EOperator operatorType);
134 
138  template<typename outputValueViewType,
139  typename inputPointViewType,
140  EOperator opType>
141  struct Functor {
142  outputValueViewType _outputValues;
143  const inputPointViewType _inputPoints;
144 
145  KOKKOS_INLINE_FUNCTION
146  Functor( outputValueViewType outputValues_,
147  inputPointViewType inputPoints_ )
148  : _outputValues(outputValues_), _inputPoints(inputPoints_) {}
149 
150  KOKKOS_INLINE_FUNCTION
151  void operator()(const ordinal_type pt) const {
152  switch (opType) {
153  case OPERATOR_VALUE : {
154  auto output = Kokkos::subview( _outputValues, Kokkos::ALL(), pt, Kokkos::ALL() );
155  const auto input = Kokkos::subview( _inputPoints, pt, Kokkos::ALL() );
156  Serial<opType>::getValues( output, input );
157  break;
158  }
159  case OPERATOR_DIV :{
160  auto output = Kokkos::subview( _outputValues, Kokkos::ALL(), pt );
161  const auto input = Kokkos::subview( _inputPoints, pt, Kokkos::ALL() );
162  Serial<opType>::getValues( output, input );
163  break;
164  }
165  default: {
166  INTREPID2_TEST_FOR_ABORT( opType != OPERATOR_VALUE &&
167  opType != OPERATOR_DIV,
168  ">>> ERROR: (Intrepid2::Basis_HDIV_HEX_I1_FEM::Serial::getValues) operator is not supported");
169  }
170  }
171  }
172  };
173  };
174 
175  }
176 
177  template<typename DeviceType = void,
178  typename outputValueType = double,
179  typename pointValueType = double>
180  class Basis_HDIV_HEX_I1_FEM : public Basis<DeviceType,outputValueType,pointValueType> {
181  public:
182  using OrdinalTypeArray1DHost = typename Basis<DeviceType,outputValueType,pointValueType>::OrdinalTypeArray1DHost;
183  using OrdinalTypeArray2DHost = typename Basis<DeviceType,outputValueType,pointValueType>::OrdinalTypeArray2DHost;
184  using OrdinalTypeArray3DHost = typename Basis<DeviceType,outputValueType,pointValueType>::OrdinalTypeArray3DHost;
185 
186  template<EOperator opType>
187  struct Serial {
188  template<typename outputValueValueType, class ...outputValueProperties,
189  typename inputPointValueType, class ...inputPointProperties>
190  KOKKOS_INLINE_FUNCTION
191  static void
192  getValues( Kokkos::DynRankView<outputValueValueType,outputValueProperties...> outputValues,
193  const Kokkos::DynRankView<inputPointValueType, inputPointProperties...> inputPoints );
194 
195  };
196 
197 
201 
205 
207 
208  virtual
209  void
210  getValues( OutputViewType outputValues,
211  const PointViewType inputPoints,
212  const EOperator operatorType = OPERATOR_VALUE ) const override {
213 #ifdef HAVE_INTREPID2_DEBUG
214  Intrepid2::getValues_HDIV_Args(outputValues,
215  inputPoints,
216  operatorType,
217  this->getBaseCellTopology(),
218  this->getCardinality() );
219 #endif
220  Impl::Basis_HDIV_HEX_I1_FEM::
221  getValues<DeviceType>( outputValues,
222  inputPoints,
223  operatorType );
224  }
225 
226  virtual
227  void
228  getDofCoords( ScalarViewType dofCoords ) const override {
229 #ifdef HAVE_INTREPID2_DEBUG
230  // Verify rank of output array.
231  INTREPID2_TEST_FOR_EXCEPTION( dofCoords.rank() != 2, std::invalid_argument,
232  ">>> ERROR: (Intrepid2::Basis_HDIV_HEX_I1_FEM::getDofCoords) rank = 2 required for dofCoords array");
233  // Verify 0th dimension of output array.
234  INTREPID2_TEST_FOR_EXCEPTION( static_cast<ordinal_type>(dofCoords.extent(0)) != this->basisCardinality_, std::invalid_argument,
235  ">>> ERROR: (Intrepid2::Basis_HDIV_HEX_I1_FEM::getDofCoords) mismatch in number of dof and 0th dimension of dofCoords array");
236  // Verify 1st dimension of output array.
237  INTREPID2_TEST_FOR_EXCEPTION( dofCoords.extent(1) != this->basisCellTopology_.getDimension(), std::invalid_argument,
238  ">>> ERROR: (Intrepid2::Basis_HDIV_HEX_I1_FEM::getDofCoords) incorrect reference cell (1st) dimension in dofCoords array");
239 #endif
240  Kokkos::deep_copy(dofCoords, this->dofCoords_);
241  }
242 
243  virtual
244  void
245  getDofCoeffs( ScalarViewType dofCoeffs ) const override {
246 #ifdef HAVE_INTREPID2_DEBUG
247  // Verify rank of output array.
248  INTREPID2_TEST_FOR_EXCEPTION( dofCoeffs.rank() != 2, std::invalid_argument,
249  ">>> ERROR: (Intrepid2::Basis_HDIV_HEX_I1_FEM::getDofCoeffs) rank = 2 required for dofCoeffs array");
250  // Verify 0th dimension of output array.
251  INTREPID2_TEST_FOR_EXCEPTION( static_cast<ordinal_type>(dofCoeffs.extent(0)) != this->getCardinality(), std::invalid_argument,
252  ">>> ERROR: (Intrepid2::Basis_HDIV_HEX_I1_FEM::getDofCoeffs) mismatch in number of dof and 0th dimension of dofCoeffs array");
253  // Verify 1st dimension of output array.
254  INTREPID2_TEST_FOR_EXCEPTION( dofCoeffs.extent(1) != this->getBaseCellTopology().getDimension(), std::invalid_argument,
255  ">>> ERROR: (Intrepid2::Basis_HDIV_HEX_I1_FEM::getDofCoeffs) incorrect reference cell (1st) dimension in dofCoeffs array");
256 #endif
257  Kokkos::deep_copy(dofCoeffs, this->dofCoeffs_);
258  }
259 
260  virtual
261  const char*
262  getName() const override {
263  return "Intrepid2_HDIV_HEX_I1_FEM";
264  }
265 
266  virtual
267  bool
268  requireOrientation() const override {
269  return true;
270  }
271 
282  getSubCellRefBasis(const ordinal_type subCellDim, const ordinal_type subCellOrd) const override{
283 
284  if(subCellDim == 2) {
285  return Teuchos::rcp(new
286  Basis_HVOL_C0_FEM<DeviceType,outputValueType,pointValueType>(shards::getCellTopologyData<shards::Quadrilateral<4> >()));
287  }
288  INTREPID2_TEST_FOR_EXCEPTION(true,std::invalid_argument,"Input parameters out of bounds");
289  }
291  getHostBasis() const override{
293  }
294  };
295 
296 }// namespace Intrepid2
297 
299 
300 #endif
Header file for the abstract base class Intrepid2::Basis.
Teuchos::RCP< Basis< DeviceType, OutputType, PointType > > BasisPtr
Basis Pointer.
void getValues_HDIV_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 HDIV-conforming FEM basis....
Definition file for FEM basis functions of degree 1 for H(div) functions on HEX cells.
Header file for the Intrepid2::Basis_HVOL_C0_FEM class.
Implementation of the default H(div)-compatible FEM basis of degree 1 on Hexahedron cell.
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...
BasisPtr< DeviceType, outputValueType, pointValueType > getSubCellRefBasis(const ordinal_type subCellDim, const ordinal_type subCellOrd) const override
returns the basis associated to a subCell.
virtual bool requireOrientation() const override
True if orientation is required.
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.
virtual void getDofCoords(ScalarViewType dofCoords) const override
Returns spatial locations (coordinates) of degrees of freedom on the reference cell.
virtual void getValues(OutputViewType outputValues, const PointViewType inputPoints, const EOperator operatorType=OPERATOR_VALUE) const override
Evaluation of a FEM basis on a reference cell.
Implementation of the default HVOL-compatible FEM contstant basis on triangle, quadrilateral,...
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.
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 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_HDIV_HEX_I1_FEM.