Intrepid
Intrepid_HCURL_QUAD_I1_FEMDef.hpp
Go to the documentation of this file.
1 // @HEADER
2 // ************************************************************************
3 //
4 // Intrepid 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 Pavel Bochev (pbboche@sandia.gov)
38 // Denis Ridzal (dridzal@sandia.gov), or
39 // Kara Peterson (kjpeter@sandia.gov)
40 //
41 // ************************************************************************
42 // @HEADER
43 
49 namespace Intrepid {
50 
51 template<class Scalar, class ArrayScalar>
53  {
54  this -> basisCardinality_ = 4;
55  this -> basisDegree_ = 1;
56  this -> basisCellTopology_ = shards::CellTopology(shards::getCellTopologyData<shards::Quadrilateral<4> >() );
57  this -> basisType_ = BASIS_FEM_DEFAULT;
58  this -> basisCoordinates_ = COORDINATES_CARTESIAN;
59  this -> basisTagsAreSet_ = false;
60  }
61 
62 template<class Scalar, class ArrayScalar>
64 
65  // Basis-dependent intializations
66  int tagSize = 4; // size of DoF tag
67  int posScDim = 0; // position in the tag, counting from 0, of the subcell dim
68  int posScOrd = 1; // position in the tag, counting from 0, of the subcell ordinal
69  int posDfOrd = 2; // position in the tag, counting from 0, of DoF ordinal relative to the subcell
70 
71  // An array with local DoF tags assigned to basis functions, in the order of their local enumeration
72  int tags[] = {
73  1, 0, 0, 1,
74  1, 1, 0, 1,
75  1, 2, 0, 1,
76  1, 3, 0, 1};
77 
78  // Basis-independent function sets tag and enum data in tagToOrdinal_ and ordinalToTag_ arrays:
79  Intrepid::setOrdinalTagData(this -> tagToOrdinal_,
80  this -> ordinalToTag_,
81  tags,
82  this -> basisCardinality_,
83  tagSize,
84  posScDim,
85  posScOrd,
86  posDfOrd);
87 }
88 
89 
90 
91 template<class Scalar, class ArrayScalar>
93  const ArrayScalar & inputPoints,
94  const EOperator operatorType) const {
95 
96 // Verify arguments
97 #ifdef HAVE_INTREPID_DEBUG
98  Intrepid::getValues_HCURL_Args<Scalar, ArrayScalar>(outputValues,
99  inputPoints,
100  operatorType,
101  this -> getBaseCellTopology(),
102  this -> getCardinality() );
103 #endif
104 
105  // Number of evaluation points = dim 0 of inputPoints
106  int dim0 = inputPoints.dimension(0);
107 
108  // Temporaries: (x,y) coordinates of the evaluation point
109  Scalar x = 0.0;
110  Scalar y = 0.0;
111 
112  switch (operatorType) {
113  case OPERATOR_VALUE:
114  for (int i0 = 0; i0 < dim0; i0++) {
115  x = inputPoints(i0, 0);
116  y = inputPoints(i0, 1);
117 
118  // outputValues is a rank-3 array with dimensions (basisCardinality_, dim0, spaceDim)
119  outputValues(0, i0, 0) = (1.0 - y)/4.0;
120  outputValues(0, i0, 1) = 0.0;
121 
122  outputValues(1, i0, 0) = 0.0;
123  outputValues(1, i0, 1) = (1.0 + x)/4.0;
124 
125  outputValues(2, i0, 0) =-(1.0 + y)/4.0;
126  outputValues(2, i0, 1) = 0.0;
127 
128  outputValues(3, i0, 0) = 0.0;
129  outputValues(3, i0, 1) =-(1.0 - x)/4.0;
130  }
131  break;
132 
133  case OPERATOR_CURL:
134  for (int i0 = 0; i0 < dim0; i0++) {
135 
136  // outputValues is a rank-2 array with dimensions (basisCardinality_, dim0)
137  outputValues(0, i0) = 0.25;
138  outputValues(1, i0) = 0.25;
139  outputValues(2, i0) = 0.25;
140  outputValues(3, i0) = 0.25;
141  }
142  break;
143 
144  case OPERATOR_DIV:
145  TEUCHOS_TEST_FOR_EXCEPTION( (operatorType == OPERATOR_DIV), std::invalid_argument,
146  ">>> ERROR (Basis_HCURL_QUAD_I1_FEM): DIV is invalid operator for HCURL Basis Functions");
147  break;
148 
149  case OPERATOR_GRAD:
150  TEUCHOS_TEST_FOR_EXCEPTION( (operatorType == OPERATOR_GRAD), std::invalid_argument,
151  ">>> ERROR (Basis_HCURL_QUAD_I1_FEM): GRAD is invalid operator for HCURL Basis Functions");
152  break;
153 
154  case OPERATOR_D1:
155  case OPERATOR_D2:
156  case OPERATOR_D3:
157  case OPERATOR_D4:
158  case OPERATOR_D5:
159  case OPERATOR_D6:
160  case OPERATOR_D7:
161  case OPERATOR_D8:
162  case OPERATOR_D9:
163  case OPERATOR_D10:
164  TEUCHOS_TEST_FOR_EXCEPTION( ( (operatorType == OPERATOR_D1) ||
165  (operatorType == OPERATOR_D2) ||
166  (operatorType == OPERATOR_D3) ||
167  (operatorType == OPERATOR_D4) ||
168  (operatorType == OPERATOR_D5) ||
169  (operatorType == OPERATOR_D6) ||
170  (operatorType == OPERATOR_D7) ||
171  (operatorType == OPERATOR_D8) ||
172  (operatorType == OPERATOR_D9) ||
173  (operatorType == OPERATOR_D10) ),
174  std::invalid_argument,
175  ">>> ERROR (Basis_HCURL_QUAD_I1_FEM): Invalid operator type");
176  break;
177 
178  default:
179  TEUCHOS_TEST_FOR_EXCEPTION( ( (operatorType != OPERATOR_VALUE) &&
180  (operatorType != OPERATOR_GRAD) &&
181  (operatorType != OPERATOR_CURL) &&
182  (operatorType != OPERATOR_DIV) &&
183  (operatorType != OPERATOR_D1) &&
184  (operatorType != OPERATOR_D2) &&
185  (operatorType != OPERATOR_D3) &&
186  (operatorType != OPERATOR_D4) &&
187  (operatorType != OPERATOR_D5) &&
188  (operatorType != OPERATOR_D6) &&
189  (operatorType != OPERATOR_D7) &&
190  (operatorType != OPERATOR_D8) &&
191  (operatorType != OPERATOR_D9) &&
192  (operatorType != OPERATOR_D10) ),
193  std::invalid_argument,
194  ">>> ERROR (Basis_HCURL_QUAD_I1_FEM): Invalid operator type");
195  }
196 }
197 
198 
199 
200 template<class Scalar, class ArrayScalar>
202  const ArrayScalar & inputPoints,
203  const ArrayScalar & cellVertices,
204  const EOperator operatorType) const {
205  TEUCHOS_TEST_FOR_EXCEPTION( (true), std::logic_error,
206  ">>> ERROR (Basis_HCURL_QUAD_I1_FEM): FEM Basis calling an FVD member function");
207  }
208 
209 template<class Scalar, class ArrayScalar>
211 #ifdef HAVE_INTREPID_DEBUG
212  // Verify rank of output array.
213  TEUCHOS_TEST_FOR_EXCEPTION( !(DofCoords.rank() == 2), std::invalid_argument,
214  ">>> ERROR: (Intrepid::Basis_HCURL_QUAD_I1_FEM::getDofCoords) rank = 2 required for DofCoords array");
215  // Verify 0th dimension of output array.
216  TEUCHOS_TEST_FOR_EXCEPTION( !( DofCoords.dimension(0) == this -> basisCardinality_ ), std::invalid_argument,
217  ">>> ERROR: (Intrepid::Basis_HCURL_QUAD_I1_FEM::getDofCoords) mismatch in number of DoF and 0th dimension of DofCoords array");
218  // Verify 1st dimension of output array.
219  TEUCHOS_TEST_FOR_EXCEPTION( !( DofCoords.dimension(1) == (int)(this -> basisCellTopology_.getDimension()) ), std::invalid_argument,
220  ">>> ERROR: (Intrepid::Basis_HCURL_QUAD_I1_FEM::getDofCoords) incorrect reference cell (1st) dimension in DofCoords array");
221 #endif
222 
223  DofCoords(0,0) = 0.0; DofCoords(0,1) = -1.0;
224  DofCoords(1,0) = 1.0; DofCoords(1,1) = 0.0;
225  DofCoords(2,0) = 0.0; DofCoords(2,1) = 1.0;
226  DofCoords(3,0) = -1.0; DofCoords(3,1) = 0.0;
227 }
228 
229 }// namespace Intrepid
230 
231 #if defined(Intrepid_SHOW_DEPRECATED_WARNINGS)
232 #ifdef __GNUC__
233 #warning "The Intrepid package is deprecated"
234 #endif
235 #endif
236 
void initializeTags()
Initializes tagToOrdinal_ and ordinalToTag_ lookup arrays.
void getDofCoords(ArrayScalar &DofCoords) const
Returns spatial locations (coordinates) of degrees of freedom on a reference Quadrilateral.
void getValues(ArrayScalar &outputValues, const ArrayScalar &inputPoints, const EOperator operatorType) const
Evaluation of a FEM basis on a reference Quadrilateral cell.