Intrepid
Intrepid_HCURL_TRI_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_ = 3;
55  this -> basisDegree_ = 1;
56  this -> basisCellTopology_ = shards::CellTopology(shards::getCellTopologyData<shards::Triangle<3> >() );
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 
77  // Basis-independent function sets tag and enum data in tagToOrdinal_ and ordinalToTag_ arrays:
78  Intrepid::setOrdinalTagData(this -> tagToOrdinal_,
79  this -> ordinalToTag_,
80  tags,
81  this -> basisCardinality_,
82  tagSize,
83  posScDim,
84  posScOrd,
85  posDfOrd);
86 }
87 
88 
89 
90 template<class Scalar, class ArrayScalar>
92  const ArrayScalar & inputPoints,
93  const EOperator operatorType) const {
94 
95 // Verify arguments
96 #ifdef HAVE_INTREPID_DEBUG
97  Intrepid::getValues_HCURL_Args<Scalar, ArrayScalar>(outputValues,
98  inputPoints,
99  operatorType,
100  this -> getBaseCellTopology(),
101  this -> getCardinality() );
102 #endif
103 
104  // Number of evaluation points = dim 0 of inputPoints
105  int dim0 = inputPoints.dimension(0);
106 
107  // Temporaries: (x,y) coordinates of the evaluation point
108  Scalar x = 0.0;
109  Scalar y = 0.0;
110 
111  switch (operatorType) {
112  case OPERATOR_VALUE:
113  for (int i0 = 0; i0 < dim0; i0++) {
114  x = inputPoints(i0, 0);
115  y = inputPoints(i0, 1);
116 
117  // outputValues is a rank-3 array with dimensions (basisCardinality_, dim0, spaceDim)
118  outputValues(0, i0, 0) = 1.0 - y;
119  outputValues(0, i0, 1) = x;
120 
121  outputValues(1, i0, 0) = -y;
122  outputValues(1, i0, 1) = x;
123 
124  outputValues(2, i0, 0) = -y;
125  outputValues(2, i0, 1) = -1.0 + x;
126  }
127  break;
128 
129  case OPERATOR_CURL:
130  for (int i0 = 0; i0 < dim0; i0++) {
131  x = inputPoints(i0, 0);
132  y = inputPoints(i0, 1);
133 
134  // outputValues is a rank-2 array with dimensions (basisCardinality_, dim0)
135  outputValues(0, i0) = 2.0;
136  outputValues(1, i0) = 2.0;
137  outputValues(2, i0) = 2.0;
138  }
139  break;
140 
141  case OPERATOR_DIV:
142  TEUCHOS_TEST_FOR_EXCEPTION( (operatorType == OPERATOR_DIV), std::invalid_argument,
143  ">>> ERROR (Basis_HCURL_TRI_I1_FEM): DIV is invalid operator for HCURL Basis Functions");
144  break;
145 
146  case OPERATOR_GRAD:
147  TEUCHOS_TEST_FOR_EXCEPTION( (operatorType == OPERATOR_GRAD), std::invalid_argument,
148  ">>> ERROR (Basis_HCURL_TRI_I1_FEM): GRAD is invalid operator for HCURL Basis Functions");
149  break;
150 
151  case OPERATOR_D1:
152  case OPERATOR_D2:
153  case OPERATOR_D3:
154  case OPERATOR_D4:
155  case OPERATOR_D5:
156  case OPERATOR_D6:
157  case OPERATOR_D7:
158  case OPERATOR_D8:
159  case OPERATOR_D9:
160  case OPERATOR_D10:
161  TEUCHOS_TEST_FOR_EXCEPTION( ( (operatorType == OPERATOR_D1) ||
162  (operatorType == OPERATOR_D2) ||
163  (operatorType == OPERATOR_D3) ||
164  (operatorType == OPERATOR_D4) ||
165  (operatorType == OPERATOR_D5) ||
166  (operatorType == OPERATOR_D6) ||
167  (operatorType == OPERATOR_D7) ||
168  (operatorType == OPERATOR_D8) ||
169  (operatorType == OPERATOR_D9) ||
170  (operatorType == OPERATOR_D10) ),
171  std::invalid_argument,
172  ">>> ERROR (Basis_HCURL_TRI_I1_FEM): Invalid operator type");
173  break;
174 
175  default:
176  TEUCHOS_TEST_FOR_EXCEPTION( ( (operatorType != OPERATOR_VALUE) &&
177  (operatorType != OPERATOR_GRAD) &&
178  (operatorType != OPERATOR_CURL) &&
179  (operatorType != OPERATOR_DIV) &&
180  (operatorType != OPERATOR_D1) &&
181  (operatorType != OPERATOR_D2) &&
182  (operatorType != OPERATOR_D3) &&
183  (operatorType != OPERATOR_D4) &&
184  (operatorType != OPERATOR_D5) &&
185  (operatorType != OPERATOR_D6) &&
186  (operatorType != OPERATOR_D7) &&
187  (operatorType != OPERATOR_D8) &&
188  (operatorType != OPERATOR_D9) &&
189  (operatorType != OPERATOR_D10) ),
190  std::invalid_argument,
191  ">>> ERROR (Basis_HCURL_TRI_I1_FEM): Invalid operator type");
192  }
193 }
194 
195 
196 
197 template<class Scalar, class ArrayScalar>
199  const ArrayScalar & inputPoints,
200  const ArrayScalar & cellVertices,
201  const EOperator operatorType) const {
202  TEUCHOS_TEST_FOR_EXCEPTION( (true), std::logic_error,
203  ">>> ERROR (Basis_HCURL_TRI_I1_FEM): FEM Basis calling an FVD member function");
204  }
205 
206 template<class Scalar, class ArrayScalar>
208 #ifdef HAVE_INTREPID_DEBUG
209  // Verify rank of output array.
210  TEUCHOS_TEST_FOR_EXCEPTION( !(DofCoords.rank() == 2), std::invalid_argument,
211  ">>> ERROR: (Intrepid::Basis_HCURL_TRI_I1_FEM::getDofCoords) rank = 2 required for DofCoords array");
212  // Verify 0th dimension of output array.
213  TEUCHOS_TEST_FOR_EXCEPTION( !( DofCoords.dimension(0) == this -> basisCardinality_ ), std::invalid_argument,
214  ">>> ERROR: (Intrepid::Basis_HCURL_TRI_I1_FEM::getDofCoords) mismatch in number of DoF and 0th dimension of DofCoords array");
215  // Verify 1st dimension of output array.
216  TEUCHOS_TEST_FOR_EXCEPTION( !( DofCoords.dimension(1) == (int)(this -> basisCellTopology_.getDimension()) ), std::invalid_argument,
217  ">>> ERROR: (Intrepid::Basis_HCURL_TRI_I1_FEM::getDofCoords) incorrect reference cell (1st) dimension in DofCoords array");
218 #endif
219 
220  DofCoords(0,0) = 0.5; DofCoords(0,1) = 0.0;
221  DofCoords(1,0) = 0.5; DofCoords(1,1) = 0.5;
222  DofCoords(2,0) = 0.0; DofCoords(2,1) = 0.5;
223 }
224 
225 
226 }// namespace Intrepid
227 
228 #if defined(Intrepid_SHOW_DEPRECATED_WARNINGS)
229 #ifdef __GNUC__
230 #warning "The Intrepid package is deprecated"
231 #endif
232 #endif
233 
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 Triangle cell.
void getDofCoords(ArrayScalar &DofCoords) const
Returns spatial locations (coordinates) of degrees of freedom on a reference Triangle.