CoupledLinearNS.h

Go to the documentation of this file.

///////////////////////////////////////////////////////////////////////////////
//
// File: CoupledLinearNS.h
//
// For more information, please see: http://www.nektar.info
//
// The MIT License
//
// Copyright (c) 2006 Division of Applied Mathematics, Brown University (USA),
// Department of Aeronautics, Imperial College London (UK), and Scientific
// Computing and Imaging Institute, University of Utah (USA).
//
// Permission is hereby granted, free of charge, to any person obtaining a
// copy of this software and associated documentation files (the "Software"),
// to deal in the Software without restriction, including without limitation
// the rights to use, copy, modify, merge, publish, distribute, sublicense,
// and/or sell copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included
// in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.
//
// Description: Coupled Stokes solver scheme header
//
///////////////////////////////////////////////////////////////////////////////
 
#ifndef NEKTAR_SOLVERS_COUPLEDSTOKESSCHEME_H
#define NEKTAR_SOLVERS_COUPLEDSTOKESSCHEME_H
 
#include <IncNavierStokesSolver/EquationSystems/CoupledLocalToGlobalC0ContMap.h>
#include <IncNavierStokesSolver/EquationSystems/IncNavierStokes.h>
#include <LibUtilities/LinearAlgebra/NekTypeDefs.hpp>
#include <MultiRegions/ExpList3DHomogeneous1D.h>
#include <MultiRegions/GlobalLinSys.h>
// #include <MultiRegions/GlobalLinSysDirectStaticCond.h>
 
namespace Nektar
{
 
typedef struct coupledSolverMatrices
{
    /**  \brief Boundary-interior Laplacian plus linearised convective
     *             terms pre-multiplying Cinv:
     *             \f$ m\_BCinv[n,m] = (\nabla \phi^b_n, \nu \nabla
     *             \phi^i_j) + (\phi^b_n,{\bf U \cdot \nabla} \phi^i_j) +
     *             (\phi^b_n \nabla^T {\bf U} \phi^i_j)  m_Cinv[j,m]\f$
     */
    DNekScalBlkMatSharedPtr m_BCinv;
 
    /** \brief Interior-boundary Laplacian plus linearised convective terms
     * \f$ m\_Btilde^T[n,m] = (\nabla \phi^i_n, \nu \nabla \phi^b_m) +
     * (\phi^i_n,{\bf U \cdot \nabla} \phi^b_m) + (\phi^i_n \nabla^T
     * {\bf U} \phi^b_m) \f$ */
    DNekScalBlkMatSharedPtr m_Btilde;
 
    /** \brief Interior-Interior Laplaican plus linearised convective
     *   terms inverted, i.e. the inverse of
     *   \f$ m\_C[n,m] = (\nabla \phi^i_n, \nu \nabla
     *   \phi^i_m) + (\phi^i_n,{\bf U \cdot \nabla} \phi^i_m) +
     *   (\phi^i_n \nabla^T {\bf U} \phi^i_m),\f$ */
    DNekScalBlkMatSharedPtr m_Cinv;
 
    /** \brief Inner product of pressure system with divergence of the
     *   boundary velocity space
     *   \f$ m\_D\_{bnd}[n,m] = (\psi_n,\nabla \phi^b_m),\f$
     */
    DNekScalBlkMatSharedPtr m_D_bnd;
 
    /** \brief Inner product of pressure system with divergence of the
     *  interior velocity space
     *  \f$ m\_D\_{int}[n,m] = (\psi_j,\nabla \phi^i_m) \f$
     */
    DNekScalBlkMatSharedPtr m_D_int;
 
    MultiRegions::GlobalLinSysSharedPtr m_CoupledBndSys;
} CoupledSolverMatrices;
 
class CoupledLinearNS : public IncNavierStokes
{
public:
    friend class MemoryManager<CoupledLinearNS>;
 
    /// Creates an instance of this class
    static SolverUtils::EquationSystemSharedPtr create(
        const LibUtilities::SessionReaderSharedPtr &pSession,
        const SpatialDomains::MeshGraphSharedPtr &pGraph)
    {
        SolverUtils::EquationSystemSharedPtr p =
            MemoryManager<CoupledLinearNS>::AllocateSharedPtr(pSession, pGraph);
        p->InitObject();
        return p;
    }
    /// Name of class
    static std::string className;
 
    /**
     *  Generate the linearised Navier Stokes solver based on the
     *  static condensation of the interior velocity space and
     *  pressure modes.
     */
    void SetUpCoupledMatrix(const NekDouble lambda = 0.0,
                            const Array<OneD, Array<OneD, NekDouble>>
                                &Advfield           = NullNekDoubleArrayOfArray,
                            bool IsLinearNSEquation = true);
 
    const SpatialDomains::ExpansionInfoMap &GenPressureExp(
        const SpatialDomains::ExpansionInfoMap &VelExp);
 
    void Solve(void);
 
    /**
     *   Solve the coupled linear Navier-Stokes solve using matrix
     *   systems set up at construction.  The solution is stored
     *   in #m_velocity and #m_pressure.
     */
    void SolveLinearNS(const Array<OneD, Array<OneD, NekDouble>> &forcing);
 
    void SolveLinearNS(Array<OneD, Array<OneD, NekDouble>> &forcing,
                       Array<OneD, MultiRegions::ExpListSharedPtr> &fields,
                       MultiRegions::ExpListSharedPtr &pressure,
                       const int HomogeneousMode = 0);
 
    void SolveUnsteadyStokesSystem(
        const Array<OneD, const Array<OneD, NekDouble>> &inarray,
        Array<OneD, Array<OneD, NekDouble>> &outarray, const NekDouble time,
        const NekDouble a_iixDt);
 
    void EvaluateAdvection(
        const Array<OneD, const Array<OneD, NekDouble>> &inarray,
        Array<OneD, Array<OneD, NekDouble>> &outarray, const NekDouble time);
 
    void SolveSteadyNavierStokes(void);
 
    void Continuation(void);
 
    /*void EvaluateNewtonRHS(Array<OneD, Array<OneD, NekDouble> > &Velocity,
     *                               Array<OneD,
     *Array<OneD, NekDouble> > &PreviousForcing, Array<OneD, Array<OneD,
     *NekDouble> > &outarray);*/
 
    void EvaluateNewtonRHS(Array<OneD, Array<OneD, NekDouble>> &Velocity,
                           Array<OneD, Array<OneD, NekDouble>> &outarray);
 
    void InfNorm(Array<OneD, Array<OneD, NekDouble>> &inarray,
                 Array<OneD, NekDouble> &outarray);
 
    void L2Norm(Array<OneD, Array<OneD, NekDouble>> &inarray,
                Array<OneD, NekDouble> &outarray);
 
    void DefineForcingTerm(void);
    Array<OneD, Array<OneD, NekDouble>> m_ForcingTerm;
    Array<OneD, Array<OneD, NekDouble>> m_ForcingTerm_Coeffs;
 
    Array<OneD, CoupledLocalToGlobalC0ContMapSharedPtr> m_locToGloMap;
 
protected:
    CoupledLinearNS(const LibUtilities::SessionReaderSharedPtr &pSesssion,
                    const SpatialDomains::MeshGraphSharedPtr &pGraph);
 
    void v_InitObject(bool DeclareField = true) override;
 
    static std::string solverTypeLookupId;
 
private:
    /// Id to identify when single mode is mean mode (i.e. beta=0);
    bool m_zeroMode;
 
    int m_counter;
    bool m_initialStep;
    NekDouble m_tol; // Tolerence
    int m_maxIt;     // Max number of iteration
    int m_Restart;   // 0=Stokes solution as init guess; 1=Restart.cont as init
                     // guess
    int m_MatrixSetUpStep;
    NekDouble m_kinvisMin;
    NekDouble m_kinvisStep;
    NekDouble m_KinvisPercentage;
 
    Array<OneD, CoupledSolverMatrices> m_mat;
 
    /**
     *  Generate the linearised Navier Stokes solver based on the
     *  static condensation of the interior velocity space and
     *  pressure modes. This call also allows for a Fourier mode
     *  to be specified, however if HomogeneneousMode= 0 then can
     *  be used for a standared 2D and hopefully 3D (in the
     *  future).
     */
    void SetUpCoupledMatrix(
        const NekDouble lambda,
        const Array<OneD, Array<OneD, NekDouble>> &Advfield,
        bool IsLinearNSEquation, const int HomogeneousMode,
        CoupledSolverMatrices &mat,
        CoupledLocalToGlobalC0ContMapSharedPtr &locToGloMap,
        const NekDouble lambda_imag = NekConstants::kNekUnsetDouble);
 
    void v_GenerateSummary(SolverUtils::SummaryList &s) override;
 
    void v_DoInitialise(bool dumpInitialConditions = true) override;
 
    void v_DoSolve(void) override;
 
    bool v_NegatedOp(void) override;
 
    void v_TransCoeffToPhys(void) override;
 
    void v_TransPhysToCoeff(void) override;
 
    void v_Output(void) override;
 
    int v_GetForceDimension(void) override;
};
 
} // namespace Nektar
 
#endif // COUPLEDSTOKESSCHEME_H