Nektar++
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
QuadExp.h
Go to the documentation of this file.
1 ///////////////////////////////////////////////////////////////////////////////
2 //
3 // File QuadExp.h
4 //
5 // For more information, please see: http://www.nektar.info
6 //
7 // The MIT License
8 //
9 // Copyright (c) 2006 Division of Applied Mathematics, Brown University (USA),
10 // Department of Aeronautics, Imperial College London (UK), and Scientific
11 // Computing and Imaging Institute, University of Utah (USA).
12 //
13 // License for the specific language governing rights and limitations under
14 // Permission is hereby granted, free of charge, to any person obtaining a
15 // copy of this software and associated documentation files (the "Software"),
16 // to deal in the Software without restriction, including without limitation
17 // the rights to use, copy, modify, merge, publish, distribute, sublicense,
18 // and/or sell copies of the Software, and to permit persons to whom the
19 // Software is furnished to do so, subject to the following conditions:
20 //
21 // The above copyright notice and this permission notice shall be included
22 // in all copies or substantial portions of the Software.
23 //
24 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
25 // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
26 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
27 // THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
28 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
29 // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
30 // DEALINGS IN THE SOFTWARE.
31 //
32 // Description: Expansion for quadrilateral elements.
33 //
34 ///////////////////////////////////////////////////////////////////////////////
35 
36 #ifndef QUADEXP_H
37 #define QUADEXP_H
38 
39 #include <LocalRegions/LocalRegionsDeclspec.h>
40 #include <LocalRegions/Expansion2D.h>
41 #include <LocalRegions/MatrixKey.h>
42 #include <StdRegions/StdQuadExp.h>
43 #include <SpatialDomains/QuadGeom.h>
44 #include <SpatialDomains/GeomFactors.h>
45 
46 
47 namespace Nektar
48 {
49  namespace LocalRegions
50  {
51 
52  class QuadExp: virtual public StdRegions::StdQuadExp,
53  virtual public Expansion2D
54  {
55  public:
56  /**
57  * @brief Constructor using BasisKey class for quadrature
58  * points and order definition
59  */
60  LOCAL_REGIONS_EXPORT QuadExp(
61  const LibUtilities::BasisKey &Ba,
62  const LibUtilities::BasisKey &Bb,
63  const SpatialDomains::QuadGeomSharedPtr &geom);
64 
65  LOCAL_REGIONS_EXPORT QuadExp(const QuadExp &T);
66 
67  LOCAL_REGIONS_EXPORT virtual ~QuadExp();
68 
69  protected:
70  //-------------------------------
71  // Integration Methods
72  //-------------------------------
73  LOCAL_REGIONS_EXPORT virtual NekDouble v_Integral(
74  const Array<OneD, const NekDouble> &inarray);
75 
76  //----------------------------
77  // Differentiation Methods
78  //----------------------------
79  LOCAL_REGIONS_EXPORT virtual NekDouble v_StdPhysEvaluate(
80  const Array<OneD, const NekDouble> &Lcoord,
81  const Array<OneD, const NekDouble> &physvals);
82  LOCAL_REGIONS_EXPORT virtual void v_PhysDeriv(
83  const Array<OneD, const NekDouble> &inarray,
84  Array<OneD, NekDouble> &out_d0,
85  Array<OneD, NekDouble> &out_d1,
86  Array<OneD, NekDouble> &out_d2 = NullNekDouble1DArray);
87  LOCAL_REGIONS_EXPORT virtual void v_PhysDeriv(
88  const int dir,
89  const Array<OneD, const NekDouble> &inarray,
90  Array<OneD, NekDouble> &outarray);
91  LOCAL_REGIONS_EXPORT virtual void v_PhysDirectionalDeriv(
92  const Array<OneD, const NekDouble> &inarray,
93  const Array<OneD, const NekDouble> &direction,
94  Array<OneD, NekDouble> &out);
95 
96  //---------------------------------------
97  // Transforms
98  //---------------------------------------
99  LOCAL_REGIONS_EXPORT virtual void v_FwdTrans(
100  const Array<OneD, const NekDouble> &inarray,
101  Array<OneD, NekDouble> &outarray);
102 
103  LOCAL_REGIONS_EXPORT virtual void v_FwdTrans_BndConstrained(
104  const Array<OneD, const NekDouble> &inarray,
105  Array<OneD, NekDouble> &outarray);
106 
107  //---------------------------------------
108  // Inner product functions
109  //---------------------------------------
110  LOCAL_REGIONS_EXPORT virtual void v_IProductWRTBase(
111  const Array<OneD, const NekDouble> &inarray,
112  Array<OneD, NekDouble> &outarray);
113  LOCAL_REGIONS_EXPORT virtual void v_IProductWRTDerivBase(
114  const int dir,
115  const Array<OneD, const NekDouble> &inarray,
116  Array<OneD, NekDouble> &outarray);
117  LOCAL_REGIONS_EXPORT virtual void v_IProductWRTBase_SumFac(
118  const Array<OneD, const NekDouble> &inarray,
119  Array<OneD, NekDouble> &outarray);
120  LOCAL_REGIONS_EXPORT virtual void v_IProductWRTBase_MatOp(
121  const Array<OneD, const NekDouble> &inarray,
122  Array<OneD, NekDouble> &outarray);
123  LOCAL_REGIONS_EXPORT virtual void v_IProductWRTDerivBase_SumFac(
124  const int dir,
125  const Array<OneD, const NekDouble> &inarray,
126  Array<OneD, NekDouble> &outarray);
127  LOCAL_REGIONS_EXPORT virtual void v_IProductWRTDerivBase_MatOp(
128  const int dir,
129  const Array<OneD, const NekDouble> &inarray,
130  Array<OneD, NekDouble> &outarray);
131  LOCAL_REGIONS_EXPORT virtual void v_NormVectorIProductWRTBase(
132  const Array<OneD, const NekDouble> &Fx,
133  const Array<OneD, const NekDouble> &Fy,
134  const Array<OneD, const NekDouble> &Fz,
135  Array<OneD, NekDouble> &outarray);
136 
137  //---------------------------------------
138  // Evaluation functions
139  //---------------------------------------
140  LOCAL_REGIONS_EXPORT virtual void v_GetCoord(
141  const Array<OneD, const NekDouble> &Lcoords,
142  Array<OneD, NekDouble> &coords);
143  LOCAL_REGIONS_EXPORT virtual void v_GetCoords(
144  Array<OneD, NekDouble> &coords_1,
145  Array<OneD, NekDouble> &coords_2,
146  Array<OneD, NekDouble> &coords_3);
147  LOCAL_REGIONS_EXPORT virtual NekDouble v_PhysEvaluate(
148  const Array<OneD, const NekDouble> &coord,
149  const Array<OneD, const NekDouble> &physvals);
150  LOCAL_REGIONS_EXPORT virtual void v_GetEdgePhysVals(
151  const int edge,
152  const Array<OneD, const NekDouble> &inarray,
153  Array<OneD, NekDouble> &outarray);
154  LOCAL_REGIONS_EXPORT virtual void v_GetEdgePhysVals(
155  const int edge,
156  const StdRegions::StdExpansionSharedPtr &EdgeExp,
157  const Array<OneD, const NekDouble> &inarray,
158  Array<OneD, NekDouble> &outarray);
159  LOCAL_REGIONS_EXPORT virtual void v_GetTracePhysVals(
160  const int edge,
161  const StdRegions::StdExpansionSharedPtr &EdgeExp,
162  const Array<OneD, const NekDouble> &inarray,
163  Array<OneD, NekDouble> &outarray,
164  StdRegions::Orientation orient);
165  LOCAL_REGIONS_EXPORT virtual void v_GetEdgeInterpVals(
166  const int edge,
167  const Array<OneD, const NekDouble> &inarray,
168  Array<OneD, NekDouble> &outarray);
169  LOCAL_REGIONS_EXPORT virtual void v_GetEdgeQFactors(
170  const int edge,
171  Array<OneD, NekDouble> &outarray);
172  LOCAL_REGIONS_EXPORT virtual void v_ComputeEdgeNormal(
173  const int edge);
174 
175 
176  //---------------------------------------
177  // Helper functions
178  //---------------------------------------
179  LOCAL_REGIONS_EXPORT virtual const
180  SpatialDomains::GeomFactorsSharedPtr& v_GetMetricInfo() const;
181  LOCAL_REGIONS_EXPORT virtual int v_GetCoordim();
182  LOCAL_REGIONS_EXPORT virtual void v_ExtractDataToCoeffs(
183  const NekDouble *data,
184  const std::vector<unsigned int > &nummodes,
185  const int mode_offset,
186  NekDouble * coeffs);
187  LOCAL_REGIONS_EXPORT virtual
188  StdRegions::Orientation v_GetEorient(int edge);
189  LOCAL_REGIONS_EXPORT virtual
190  StdRegions::Orientation v_GetCartesianEorient(int edge);
191  LOCAL_REGIONS_EXPORT virtual const
192  LibUtilities::BasisSharedPtr& v_GetBasis(int dir) const;
193  LOCAL_REGIONS_EXPORT virtual int v_GetNumPoints(const int dir) const;
194 
195 
196  //---------------------------------------
197  // Matrix creation functions
198  //---------------------------------------
199  LOCAL_REGIONS_EXPORT virtual DNekMatSharedPtr v_GenMatrix(
200  const StdRegions::StdMatrixKey &mkey);
201 
202  LOCAL_REGIONS_EXPORT virtual DNekMatSharedPtr v_CreateStdMatrix(
203  const StdRegions::StdMatrixKey &mkey);
204  LOCAL_REGIONS_EXPORT DNekScalMatSharedPtr CreateMatrix(
205  const MatrixKey &mkey);
206  LOCAL_REGIONS_EXPORT DNekScalBlkMatSharedPtr CreateStaticCondMatrix(
207  const MatrixKey &mkey);
208 
209  LOCAL_REGIONS_EXPORT virtual DNekScalMatSharedPtr v_GetLocMatrix(
210  const MatrixKey &mkey);
211  LOCAL_REGIONS_EXPORT virtual
212  DNekScalBlkMatSharedPtr v_GetLocStaticCondMatrix(
213  const MatrixKey &mkey);
214 
215  LOCAL_REGIONS_EXPORT void v_DropLocStaticCondMatrix(
216  const MatrixKey &mkey);
217 
218 
219  //---------------------------------------
220  // Operators
221  //---------------------------------------
222  LOCAL_REGIONS_EXPORT virtual void v_MassMatrixOp(
223  const Array<OneD, const NekDouble> &inarray,
224  Array<OneD, NekDouble> &outarray,
225  const StdRegions::StdMatrixKey &mkey);
226  LOCAL_REGIONS_EXPORT virtual void v_LaplacianMatrixOp(
227  const Array<OneD, const NekDouble> &inarray,
228  Array<OneD, NekDouble> &outarray,
229  const StdRegions::StdMatrixKey &mkey);
230  LOCAL_REGIONS_EXPORT virtual void v_LaplacianMatrixOp(
231  const int k1,
232  const int k2,
233  const Array<OneD, const NekDouble> &inarray,
234  Array<OneD, NekDouble> &outarray,
235  const StdRegions::StdMatrixKey &mkey);
236  LOCAL_REGIONS_EXPORT virtual void v_WeakDerivMatrixOp(
237  const int i,
238  const Array<OneD, const NekDouble> &inarray,
239  Array<OneD, NekDouble> &outarray,
240  const StdRegions::StdMatrixKey &mkey);
241  LOCAL_REGIONS_EXPORT virtual void v_WeakDirectionalDerivMatrixOp(
242  const Array<OneD, const NekDouble> &inarray,
243  Array<OneD, NekDouble> &outarray,
244  const StdRegions::StdMatrixKey &mkey);
245  LOCAL_REGIONS_EXPORT virtual void v_MassLevelCurvatureMatrixOp(
246  const Array<OneD, const NekDouble> &inarray,
247  Array<OneD, NekDouble> &outarray,
248  const StdRegions::StdMatrixKey &mkey);
249  LOCAL_REGIONS_EXPORT virtual void v_HelmholtzMatrixOp(
250  const Array<OneD, const NekDouble> &inarray,
251  Array<OneD, NekDouble> &outarray,
252  const StdRegions::StdMatrixKey &mkey);
253  LOCAL_REGIONS_EXPORT virtual void v_GeneralMatrixOp_MatOp(
254  const Array<OneD, const NekDouble> &inarray,
255  Array<OneD, NekDouble> &outarray,
256  const StdRegions::StdMatrixKey &mkey);
257  LOCAL_REGIONS_EXPORT virtual void v_LaplacianMatrixOp_MatFree_Kernel(
258  const Array<OneD, const NekDouble> &inarray,
259  Array<OneD, NekDouble> &outarray,
260  Array<OneD, NekDouble> &wsp);
261  LOCAL_REGIONS_EXPORT virtual void v_ReduceOrderCoeffs(
262  int numMin,
263  const Array<OneD, const NekDouble> &inarray,
264  Array<OneD, NekDouble> &outarray);
265  LOCAL_REGIONS_EXPORT virtual void v_ComputeLaplacianMetric();
266 
267  private:
268  LibUtilities::NekManager<MatrixKey, DNekScalMat, MatrixKey::opLess> m_matrixManager;
269  LibUtilities::NekManager<MatrixKey, DNekScalBlkMat, MatrixKey::opLess> m_staticCondMatrixManager;
270 
271  QuadExp();
272 
273  };
274 
275  // type defines for use of QuadExp in a boost vector
276  typedef boost::shared_ptr<QuadExp> QuadExpSharedPtr;
277  typedef std::vector< QuadExpSharedPtr > QuadExpVector;
278  typedef std::vector< QuadExpSharedPtr >::iterator QuadExpVectorIter;
279  }
280 }
281 
282 #endif
Generated on Sun Mar 15 2015 00:11:34 for Nektar++ by   doxygen 1.8.1.2