LinearisedAdvection.h

Go to the documentation of this file.

///////////////////////////////////////////////////////////////////////////////
//
// File: LinearisedAdvection.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: TBA
//
///////////////////////////////////////////////////////////////////////////////
 
#ifndef NEKTAR_SOLVERS_LINEARISEDADVECTION_H
#define NEKTAR_SOLVERS_LINEARISEDADVECTION_H
 
#include <LibUtilities/FFT/NektarFFT.h>
#include <SolverUtils/Advection/Advection.h>
 
namespace Nektar
{
 
class LinearisedAdvection : public SolverUtils::Advection
{
    enum FloquetMatType
    {
        eForwardsCoeff,
        eForwardsPhys
    };
 
    /// A map between  matrix keys and their associated block
    /// matrices.
    typedef std::map<FloquetMatType, DNekBlkMatSharedPtr> FloquetBlockMatrixMap;
    /// A shared pointer to a BlockMatrixMap.
    typedef std::shared_ptr<FloquetBlockMatrixMap> FloquetBlockMatrixMapShPtr;
 
public:
    friend class MemoryManager<LinearisedAdvection>;
 
    /// Creates an instance of this class
    static SolverUtils::AdvectionSharedPtr create(std::string)
    {
        return MemoryManager<LinearisedAdvection>::AllocateSharedPtr();
    }
 
    /// Name of class
    static std::string className;
 
protected:
    LibUtilities::SessionReaderSharedPtr m_session;
 
    int m_spacedim;
    int m_expdim;
 
    /// Storage for base flow
    Array<OneD, Array<OneD, NekDouble>> m_baseflow;
    Array<OneD, Array<OneD, NekDouble>> m_gradBase;
 
    /// number of slices
    int m_start;
    int m_skip;
    int m_slices;
    /// period length
    NekDouble m_period;
    int m_isperiodic;
    int m_interporder;
    /// interpolation vector
    Array<OneD, Array<OneD, NekDouble>> m_interp;
    /// auxiliary variables
    LibUtilities::NektarFFTSharedPtr m_FFT;
    Array<OneD, NekDouble> m_tmpIN;
    Array<OneD, NekDouble> m_tmpOUT;
    bool m_useFFTW;
    /// flag to determine if use single mode or not
    bool m_singleMode;
    /// flag to determine if use half mode or not
    bool m_halfMode;
    /// flag to determine if use multiple mode or not
    bool m_multipleModes;
 
    FloquetBlockMatrixMapShPtr m_FloquetBlockMat;
 
    LinearisedAdvection();
 
    ~LinearisedAdvection() override = default;
 
    void v_InitObject(
        LibUtilities::SessionReaderSharedPtr pSession,
        Array<OneD, MultiRegions::ExpListSharedPtr> pFields) override;
 
    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,
                  const Array<OneD, Array<OneD, NekDouble>> &pFwd =
                      NullNekDoubleArrayOfArray,
                  const Array<OneD, Array<OneD, NekDouble>> &pBwd =
                      NullNekDoubleArrayOfArray) override;
 
    void v_SetBaseFlow(
        const Array<OneD, Array<OneD, NekDouble>> &inarray,
        const Array<OneD, MultiRegions::ExpListSharedPtr> &fields) override;
 
    void ImportFldBase(std::string pInfile,
                       Array<OneD, MultiRegions::ExpListSharedPtr> &pFields,
                       int slice);
 
    void UpdateBase(const Array<OneD, const NekDouble> &inarray,
                    Array<OneD, NekDouble> &outarray, const NekDouble time);
 
    void UpdateGradBase(const int var,
                        const MultiRegions::ExpListSharedPtr &field);
 
    DNekBlkMatSharedPtr GetFloquetBlockMatrix(FloquetMatType mattype,
                                              bool UseContCoeffs = false) const;
 
    void DFT(const std::string file,
             Array<OneD, MultiRegions::ExpListSharedPtr> &pFields);
 
private:
    /// Parameter for homogeneous expansions
    enum HomogeneousType
    {
        eHomogeneous1D,
        eHomogeneous2D,
        eHomogeneous3D,
        eNotHomogeneous
    };
 
    /// flag to determine if use or not the FFT for transformations
    bool m_useFFT;
 
    enum HomogeneousType m_HomogeneousType;
 
    NekDouble m_LhomX; ///< physical length in X direction (if homogeneous)
    NekDouble m_LhomY; ///< physical length in Y direction (if homogeneous)
    NekDouble m_LhomZ; ///< physical length in Z direction (if homogeneous)
 
    int m_npointsX; ///< number of points in X direction (if homogeneous)
    int m_npointsY; ///< number of points in Y direction (if homogeneous)
    int m_npointsZ; ///< number of points in Z direction (if homogeneous)
 
    int m_HomoDirec; ///< number of homogenous directions
 
    int m_NumMode; ///< Mode to use in case of single mode analysis
 
    SpatialDomains::BoundaryConditionsSharedPtr m_boundaryConditions;
};
 
} // namespace Nektar
 
#endif // NEKTAR_SOLVERS_INCNAVIERSTOKES_H