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
49namespace Intrepid {
50
51template<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
62template<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
91template<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
200template<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
209template<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
void setOrdinalTagData(std::vector< std::vector< std::vector< int > > > &tagToOrdinal, std::vector< std::vector< int > > &ordinalToTag, const int *tags, const int basisCard, const int tagSize, const int posScDim, const int posScOrd, const int posDfOrd)
Fills ordinalToTag_ and tagToOrdinal_ by basis-specific tag data.
void initializeTags()
Initializes tagToOrdinal_ and ordinalToTag_ lookup arrays.
void getValues(ArrayScalar &outputValues, const ArrayScalar &inputPoints, const EOperator operatorType) const
Evaluation of a FEM basis on a reference Quadrilateral cell.
void getDofCoords(ArrayScalar &DofCoords) const
Returns spatial locations (coordinates) of degrees of freedom on a reference Quadrilateral.