Nektar++
UpwindSolver.cpp
Go to the documentation of this file.
1///////////////////////////////////////////////////////////////////////////////
2//
3// File: UpwindSolver.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// Permission is hereby granted, free of charge, to any person obtaining a
14// copy of this software and associated documentation files (the "Software"),
15// to deal in the Software without restriction, including without limitation
16// the rights to use, copy, modify, merge, publish, distribute, sublicense,
17// and/or sell copies of the Software, and to permit persons to whom the
18// Software is furnished to do so, subject to the following conditions:
19//
20// The above copyright notice and this permission notice shall be included
21// in all copies or substantial portions of the Software.
22//
23// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
24// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
25// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
26// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
27// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
28// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
29// DEALINGS IN THE SOFTWARE.
30//
31// Description: Upwind Riemann solver.
32//
33///////////////////////////////////////////////////////////////////////////////
34
36
37namespace Nektar::SolverUtils
38{
39std::string UpwindSolver::solverName =
41 "Upwind", UpwindSolver::create, "Upwind solver");
42
43/**
44 * @class UpwindSolver
45 *
46 * @brief Upwind scheme Riemann solver.
47 *
48 * The upwind solver determines the flux based upon an advection
49 * velocity \f$\mathbf{V}\f$ and trace normal \f$\mathbf{n}\f$. In
50 * particular, the flux for each component of the velocity field is
51 * deterined by:
52 *
53 * \f[ \mathbf{f}(u^+,u^-) = \begin{cases} \mathbf{V}u^+, &
54 * \mathbf{V}\cdot\mathbf{n} \geq 0,\\ \mathbf{V}u^-, &
55 * \mathbf{V}\cdot\mathbf{n} < 0.\end{cases} \f]
56 *
57 * Here the superscript + and - denotes forwards and backwards spaces
58 * respectively.
59 */
60
61/**
62 * @brief Default constructor.
63 */
65 : RiemannSolver(pSession)
66{
67}
68
69/**
70 * @brief Implementation of the upwind solver.
71 *
72 * The upwind solver assumes that a scalar field Vn is defined, which
73 * corresponds with the dot product \f$\mathbf{V}\cdot\mathbf{n}\f$,
74 * where \f$\mathbf{V}\f$ is the advection velocity and \f$\mathbf{n}\f$
75 * defines the normal of a vertex, edge or face at each quadrature point
76 * of the trace space.
77 *
78 * @param Fwd Forwards trace space.
79 * @param Bwd Backwards trace space.
80 * @param flux Resulting flux.
81 */
82void UpwindSolver::v_Solve([[maybe_unused]] const int nDim,
83 const Array<OneD, const Array<OneD, NekDouble>> &Fwd,
84 const Array<OneD, const Array<OneD, NekDouble>> &Bwd,
86{
87 ASSERTL1(CheckScalars("Vn"), "Vn not defined.");
88 const Array<OneD, NekDouble> &traceVel = m_scalars["Vn"]();
89
90 for (int j = 0; j < traceVel.size(); ++j)
91 {
93 traceVel[j] >= 0 ? Fwd : Bwd;
94 for (int i = 0; i < Fwd.size(); ++i)
95 {
96 flux[i][j] = traceVel[j] * tmp[i][j];
97 }
98 }
99}
100} // namespace Nektar::SolverUtils
#define ASSERTL1(condition, msg)
Assert Level 1 – Debugging which is used whether in FULLDEBUG or DEBUG compilation mode....
Definition: ErrorUtil.hpp:242
tKey RegisterCreatorFunction(tKey idKey, CreatorFunction classCreator, std::string pDesc="")
Register a class with the factory.
The RiemannSolver class provides an abstract interface under which solvers for various Riemann proble...
Definition: RiemannSolver.h:58
SOLVER_UTILS_EXPORT bool CheckScalars(std::string name)
Determine whether a scalar has been defined in m_scalars.
std::map< std::string, RSScalarFuncType > m_scalars
Map of scalar function types.
UpwindSolver(const LibUtilities::SessionReaderSharedPtr &pSession)
Default constructor.
void v_Solve(const int nDim, const Array< OneD, const Array< OneD, NekDouble > > &Fwd, const Array< OneD, const Array< OneD, NekDouble > > &Bwd, Array< OneD, Array< OneD, NekDouble > > &flux) final
Implementation of the upwind solver.
static SOLVER_UTILS_EXPORT RiemannSolverSharedPtr create(const LibUtilities::SessionReaderSharedPtr &pSession)
Definition: UpwindSolver.h:46
std::shared_ptr< SessionReader > SessionReaderSharedPtr
RiemannSolverFactory & GetRiemannSolverFactory()