Nektar++
SkewSymmetricAdvection.cpp
Go to the documentation of this file.
1 ///////////////////////////////////////////////////////////////////////////////
2 //
3 // File SkewSymmetricAdvection.cpp
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: Evaluation of the Navier Stokes advective term
33 //
34 ///////////////////////////////////////////////////////////////////////////////
35 
37 
38 namespace Nektar
39 {
42  "SkewSymmetric",
44 
45 /**
46  *
47  */
49  Advection()
50 
51 {
52 }
53 
54 
55 /**
56  *
57  */
59 {
60 }
61 
62 
63 /**
64  *
65  */
69 {
70  Advection::v_InitObject(pSession, pFields);
71 
73  m_homogen_dealiasing = pSession->DefinesSolverInfo("dealiasing");
74  pSession->MatchSolverInfo("ModeType","SingleMode",m_SingleMode,false);
75  pSession->MatchSolverInfo("ModeType","HalfMode",m_HalfMode,false);
76 }
77 
78 
79 /**
80  *
81  */
83  const int nConvectiveFields,
85  const Array<OneD, Array<OneD, NekDouble> > &advVel,
86  const Array<OneD, Array<OneD, NekDouble> > &inarray,
87  Array<OneD, Array<OneD, NekDouble> > &outarray,
88  const NekDouble &time)
89 {
90  int nqtot = fields[0]->GetTotPoints();
91  ASSERTL1(nConvectiveFields == inarray.num_elements(),"Number of convective fields and Inarray are not compatible");
92 
93  Array<OneD, NekDouble > Deriv = Array<OneD, NekDouble> (nqtot*nConvectiveFields);
94 
95  for(int n = 0; n < nConvectiveFields; ++n)
96  {
97  // use dimension of Velocity vector to dictate dimension of operation
98  int ndim = advVel.num_elements();
99 
100  // ToDo: here we should add a check that V has right dimension
101 
102  int nPointsTot = fields[0]->GetNpoints();
103  Array<OneD, NekDouble> gradV0,gradV1,gradV2, tmp, Up;
104 
105  gradV0 = Array<OneD, NekDouble> (nPointsTot);
106  tmp = Array<OneD, NekDouble> (nPointsTot);
107 
108  // Evaluate V\cdot Grad(u)
109  switch(ndim)
110  {
111  case 1:
112  fields[0]->PhysDeriv(inarray[n],gradV0);
113  Vmath::Vmul(nPointsTot,gradV0,1,advVel[0],1,outarray[n],1);
114  Vmath::Vmul(nPointsTot,inarray[n],1,advVel[0],1,gradV0,1);
115  fields[0]->PhysDeriv(gradV0,tmp);
116  Vmath::Vadd(nPointsTot,tmp,1,outarray[n],1,outarray[n],1);
117  Vmath::Smul(nPointsTot,0.5,outarray[n],1,outarray[n],1);
118  break;
119  case 2:
120  gradV1 = Array<OneD, NekDouble> (nPointsTot);
121  fields[0]->PhysDeriv(inarray[n],gradV0,gradV1);
122  Vmath::Vmul (nPointsTot,gradV0,1,advVel[0],1,outarray[n],1);
123  Vmath::Vvtvp(nPointsTot,gradV1,1,advVel[1],1,outarray[n],1,outarray[n],1);
124  Vmath::Vmul(nPointsTot,inarray[n],1,advVel[0],1,gradV0,1);
125  Vmath::Vmul(nPointsTot,inarray[n],1,advVel[1],1,gradV1,1);
126  fields[0]->PhysDeriv(MultiRegions::DirCartesianMap[0],gradV0,tmp);
127  Vmath::Vadd(nPointsTot,tmp,1,outarray[n],1,outarray[n],1);
128  fields[0]->PhysDeriv(MultiRegions::DirCartesianMap[1],gradV1,tmp);
129  Vmath::Vadd(nPointsTot,tmp,1,outarray[n],1,outarray[n],1);
130  Vmath::Smul(nPointsTot,0.5,outarray[n],1,outarray[n],1);
131  break;
132  case 3:
133  gradV1 = Array<OneD, NekDouble> (nPointsTot);
134  gradV2 = Array<OneD, NekDouble> (nPointsTot);
135 
136  fields[0]->PhysDeriv(inarray[n],gradV0,gradV1,gradV2);
137 
138  //outarray[n] = 1/2(u*du/dx + v*du/dy + w*du/dz + duu/dx + duv/dy + duw/dz)
139 
140  if(m_homogen_dealiasing == true && fields[0]->GetWaveSpace() == false)
141  {
142  fields[0]->DealiasedProd(advVel[0],gradV0,gradV0,m_CoeffState);
143  fields[0]->DealiasedProd(advVel[1],gradV1,gradV1,m_CoeffState);
144  fields[0]->DealiasedProd(advVel[2],gradV2,gradV2,m_CoeffState);
145  Vmath::Vadd(nPointsTot,gradV0,1,gradV1,1,outarray[n],1);
146  Vmath::Vadd(nPointsTot,gradV2,1,outarray[n],1,outarray[n],1);
147  fields[0]->DealiasedProd(inarray[n],advVel[0],gradV0,m_CoeffState);
148  fields[0]->DealiasedProd(inarray[n],advVel[1],gradV1,m_CoeffState);
149  fields[0]->DealiasedProd(inarray[n],advVel[2],gradV2,m_CoeffState);
150  fields[0]->PhysDeriv(MultiRegions::DirCartesianMap[0],gradV0,tmp);
151  Vmath::Vadd(nPointsTot,tmp,1,outarray[n],1,outarray[n],1);
152  fields[0]->PhysDeriv(MultiRegions::DirCartesianMap[1],gradV1,tmp);
153  Vmath::Vadd(nPointsTot,tmp,1,outarray[n],1,outarray[n],1);
154  fields[0]->PhysDeriv(MultiRegions::DirCartesianMap[2],gradV2,tmp);
155  Vmath::Vadd(nPointsTot,tmp,1,outarray[n],1,outarray[n],1);
156  Vmath::Smul(nPointsTot,0.5,outarray[n],1,outarray[n],1);
157  }
158  else if(fields[0]->GetWaveSpace() == true && m_homogen_dealiasing == false)
159  {
160  Up = Array<OneD, NekDouble> (nPointsTot);
161  //vector reused to avoid even more memory requirements
162  //names may be misleading
163  fields[0]->HomogeneousBwdTrans(gradV0,tmp);
164  Vmath::Vmul(nPointsTot,tmp,1,advVel[0],1,outarray[n],1); // + u*du/dx
165  fields[0]->HomogeneousBwdTrans(gradV1,tmp);
166  Vmath::Vvtvp(nPointsTot,tmp,1,advVel[1],1,outarray[n],1,outarray[n],1);// + v*du/dy
167  fields[0]->HomogeneousBwdTrans(gradV2,tmp);
168  Vmath::Vvtvp(nPointsTot,tmp,1,advVel[2],1,outarray[n],1,outarray[n],1);// + w*du/dz
169 
170  fields[0]->HomogeneousBwdTrans(inarray[n],Up);
171  Vmath::Vmul(nPointsTot,Up,1,advVel[0],1,gradV0,1);
172  Vmath::Vmul(nPointsTot,Up,1,advVel[1],1,gradV1,1);
173  Vmath::Vmul(nPointsTot,Up,1,advVel[2],1,gradV2,1);
174 
175  fields[0]->SetWaveSpace(false);
176  fields[0]->PhysDeriv(MultiRegions::DirCartesianMap[0],gradV0,tmp);//duu/dx
177  Vmath::Vadd(nPointsTot,tmp,1,outarray[n],1,outarray[n],1);
178  fields[0]->PhysDeriv(MultiRegions::DirCartesianMap[1],gradV1,tmp);//duv/dy
179  Vmath::Vadd(nPointsTot,tmp,1,outarray[n],1,outarray[n],1);
180  fields[0]->PhysDeriv(MultiRegions::DirCartesianMap[2],gradV2,tmp);//duw/dz
181  Vmath::Vadd(nPointsTot,tmp,1,outarray[n],1,outarray[n],1);
182  fields[0]->SetWaveSpace(true);
183 
184  Vmath::Smul(nPointsTot,0.5,outarray[n],1,tmp,1);
185  fields[0]->HomogeneousFwdTrans(tmp,outarray[n]);
186  }
187  else if(fields[0]->GetWaveSpace() == false && m_homogen_dealiasing == false)
188  {
189  Vmath::Vmul(nPointsTot,gradV0,1,advVel[0],1,outarray[n],1);
190  Vmath::Vvtvp(nPointsTot,gradV1,1,advVel[1],1,outarray[n],1,outarray[n],1);
191  Vmath::Vvtvp(nPointsTot,gradV2,1,advVel[2],1,outarray[n],1,outarray[n],1);
192  Vmath::Vmul(nPointsTot,inarray[n],1,advVel[0],1,gradV0,1);
193  Vmath::Vmul(nPointsTot,inarray[n],1,advVel[1],1,gradV1,1);
194  Vmath::Vmul(nPointsTot,inarray[n],1,advVel[2],1,gradV2,1);
195  fields[0]->PhysDeriv(MultiRegions::DirCartesianMap[0],gradV0,tmp);
196  Vmath::Vadd(nPointsTot,tmp,1,outarray[n],1,outarray[n],1);
197  fields[0]->PhysDeriv(MultiRegions::DirCartesianMap[1],gradV1,tmp);
198  Vmath::Vadd(nPointsTot,tmp,1,outarray[n],1,outarray[n],1);
199  fields[0]->PhysDeriv(MultiRegions::DirCartesianMap[2],gradV2,tmp);
200  Vmath::Vadd(nPointsTot,tmp,1,outarray[n],1,outarray[n],1);
201  Vmath::Smul(nPointsTot,0.5,outarray[n],1,outarray[n],1);
202  }
203  else
204  {
205  ASSERTL0(false, "Dealiasing is not allowed in combination "
206  "with the Skew-Symmetric advection form for "
207  "efficiency reasons.");
208  }
209  break;
210  default:
211  ASSERTL0(false,"dimension unknown");
212  }
213 
214  Vmath::Neg(nqtot,outarray[n],1);
215  }
216 
217 }
218 
219 } //end of namespace
220 
#define ASSERTL0(condition, msg)
Definition: ErrorUtil.hpp:161
Local coefficients.
MultiRegions::CoeffState m_CoeffState
void Vvtvp(int n, const T *w, const int incw, const T *x, const int incx, const T *y, const int incy, T *z, const int incz)
vvtvp (vector times vector plus vector): z = w*x + y
Definition: Vmath.cpp:428
boost::shared_ptr< SessionReader > SessionReaderSharedPtr
Definition: MeshPartition.h:50
void Smul(int n, const T alpha, const T *x, const int incx, T *y, const int incy)
Scalar multiply y = alpha*y.
Definition: Vmath.cpp:199
AdvectionFactory & GetAdvectionFactory()
Gets the factory for initialising advection objects.
Definition: Advection.cpp:46
void Neg(int n, T *x, const int incx)
Negate x = -x.
Definition: Vmath.cpp:382
double NekDouble
MultiRegions::Direction const DirCartesianMap[]
Definition: ExpList.h:86
static std::string className
Name of class.
#define ASSERTL1(condition, msg)
Assert Level 1 – Debugging which is used whether in FULLDEBUG or DEBUG compilation mode...
Definition: ErrorUtil.hpp:191
static SolverUtils::AdvectionSharedPtr create(std::string)
Creates an instance of this class.
virtual void v_Advect(const int nConvectiveFields, const Array< OneD, MultiRegions::ExpListSharedPtr > &fields, const Array< OneD, Array< OneD, NekDouble > > &advVel, const Array< OneD, Array< OneD, NekDouble > > &inarray, Array< OneD, Array< OneD, NekDouble > > &outarray, const NekDouble &time)
Advects a vector field.
void Vadd(int n, const T *x, const int incx, const T *y, const int incy, T *z, const int incz)
Add vector z = x+y.
Definition: Vmath.cpp:285
void Vmul(int n, const T *x, const int incx, const T *y, const int incy, T *z, const int incz)
Multiply vector z = x*y.
Definition: Vmath.cpp:169
tKey RegisterCreatorFunction(tKey idKey, CreatorFunction classCreator, tDescription pDesc="")
Register a class with the factory.
Definition: NekFactory.hpp:215
virtual void v_InitObject(LibUtilities::SessionReaderSharedPtr pSession, Array< OneD, MultiRegions::ExpListSharedPtr > pFields)
Initialises the advection object.