Expansion2D.h

Go to the documentation of this file.

///////////////////////////////////////////////////////////////////////////////
//
// File Expansion2D.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: Header file for Expansion2D routines
//
///////////////////////////////////////////////////////////////////////////////
 
#ifndef EXPANSION2D_H
#define EXPANSION2D_H
 
#include <boost/core/ignore_unused.hpp>
 
#include <LocalRegions/Expansion1D.h>
#include <StdRegions/StdExpansion2D.h>
#include <LocalRegions/LocalRegionsDeclspec.h>
#include <SpatialDomains/Geometry2D.h>
 
namespace Nektar
{
    namespace LocalRegions
    {
        class Expansion3D;
        typedef std::shared_ptr<Expansion3D> Expansion3DSharedPtr;
        typedef std::weak_ptr<Expansion3D>   Expansion3DWeakPtr;
 
        class Expansion2D;
        typedef std::shared_ptr<Expansion2D> Expansion2DSharedPtr;
        typedef std::weak_ptr<Expansion2D>   Expansion2DWeakPtr;
        typedef std::vector< Expansion2DSharedPtr > Expansion2DVector;
 
        class Expansion2D: virtual public Expansion,
            virtual public StdRegions::StdExpansion2D
        {
        public:
            LOCAL_REGIONS_EXPORT Expansion2D(SpatialDomains::
                                             Geometry2DSharedPtr pGeom);
            
            LOCAL_REGIONS_EXPORT virtual ~Expansion2D() {}
            
            LOCAL_REGIONS_EXPORT void SetTraceToGeomOrientation(
                Array<OneD, ExpansionSharedPtr> &EdgeExp,
                Array<OneD, NekDouble>          &inout);
 
            LOCAL_REGIONS_EXPORT Array<OneD, unsigned int>
                              GetTraceInverseBoundaryMap(int eid);
 
            inline void AddNormTraceInt(
                const int                             dir,
                Array<OneD, ExpansionSharedPtr>      &EdgeExp,
                Array<OneD, Array<OneD, NekDouble> > &edgeCoeffs,
                Array<OneD,             NekDouble>   &outarray);
 
            inline void AddNormTraceInt(
                const int                        dir,
                Array<OneD, const NekDouble>    &inarray,
                Array<OneD, ExpansionSharedPtr> &EdgeExp,
                Array<OneD, NekDouble>          &outarray,
                const StdRegions::VarCoeffMap   &varcoeffs);
 
            inline void AddEdgeBoundaryInt(
                const int                        edge,
                ExpansionSharedPtr              &EdgeExp,
                Array<OneD, NekDouble>          &edgePhys,
                Array<OneD, NekDouble>          &outarray,
                const StdRegions::VarCoeffMap   &varcoeffs = StdRegions::
                                                    NullVarCoeffMap);
 
            inline void AddHDGHelmholtzEdgeTerms(
                const NekDouble                  tau,
                const int                        edge,
                Array<OneD, ExpansionSharedPtr> &EdgeExp,
                Array<OneD, NekDouble>          &edgePhys,
                const StdRegions::VarCoeffMap   &dirForcing,
                Array<OneD, NekDouble>          &outarray);
 
            inline void AddHDGHelmholtzTraceTerms(
                const NekDouble                     tau,
                const Array<OneD, const NekDouble> &inarray,
                Array<OneD, ExpansionSharedPtr>    &EdgeExp,
                const StdRegions::VarCoeffMap      &dirForcing,
                Array<OneD, NekDouble>             &outarray);
 
            inline SpatialDomains::Geometry2DSharedPtr GetGeom2D() const;
 
            LOCAL_REGIONS_EXPORT void ReOrientEdgePhysMap(
                const int                        nvert,
                const StdRegions::Orientation    orient,
                const int                        nq0,
                Array<OneD, int>                &idmap);
 
        protected:
            std::vector<Expansion1DWeakPtr>    m_edgeExp;
            std::vector<bool>                  m_requireNeg;
            std::map<int, NormalVector>        m_edgeNormals;
            Expansion3DWeakPtr                 m_elementLeft;
            Expansion3DWeakPtr                 m_elementRight;
            int                                m_elementFaceLeft;
            int                                m_elementFaceRight;
 
            LOCAL_REGIONS_EXPORT virtual Array<OneD, NekDouble> v_GetMF(
                                                                        const int dir,
                                                                        const int shapedim,
                                                                        const StdRegions::VarCoeffMap   &varcoeffs);
 
            LOCAL_REGIONS_EXPORT virtual Array<OneD, NekDouble> v_GetMFDiv(
                                                                           const int dir,
                                                                           const StdRegions::VarCoeffMap   &varcoeffs);
 
            LOCAL_REGIONS_EXPORT virtual Array<OneD, NekDouble> v_GetMFMag(
                                                                           const int dir,
                                                                           const StdRegions::VarCoeffMap   &varcoeffs);
 
            virtual DNekMatSharedPtr v_GenMatrix(
                                                 const StdRegions::StdMatrixKey &mkey);
 
            // Hybridized DG routines
            virtual void v_DGDeriv(
                                   const int                             dir,
                                   const Array<OneD, const NekDouble>   &incoeffs,
                                   Array<OneD, ExpansionSharedPtr>      &EdgeExp,
                                   Array<OneD, Array<OneD, NekDouble> > &edgeCoeffs,
                                   Array<OneD, NekDouble>               &out_d);
 
            virtual void v_AddEdgeNormBoundaryInt(
                                                  const int                            edge,
                                                  const ExpansionSharedPtr            &EdgeExp,
                                                  const Array<OneD, const NekDouble>  &Fx,
                                                  const Array<OneD, const NekDouble>  &Fy,
                                                  Array<OneD,       NekDouble>  &outarray);
 
            virtual void v_AddEdgeNormBoundaryInt(
                                                  const int                            edge,
                                                  const ExpansionSharedPtr            &EdgeExp,
                                                  const Array<OneD, const NekDouble>  &Fn,
                                                  Array<OneD,       NekDouble>  &outarray);
 
            virtual void v_AddRobinMassMatrix(
                                              const int                            edgeid,
                                              const Array<OneD, const NekDouble > &primCoeffs,
                                              DNekMatSharedPtr                    &inoutmat);
 
            virtual void v_AddRobinTraceContribution(
                                                     const int traceid,
                                                     const Array<OneD, const NekDouble> &primCoeffs,
                                                     const Array<OneD, NekDouble> &incoeffs,
                                                     Array<OneD, NekDouble> &coeffs);
 
            virtual DNekMatSharedPtr v_BuildVertexMatrix(
                                                         const DNekScalMatSharedPtr &r_bnd); 
 
            void GetPhysEdgeVarCoeffsFromElement(
                                                 const int edge,
                                                 ExpansionSharedPtr &EdgeExp,
                                                 const Array<OneD, const NekDouble>  &varcoeff,
                                                 Array<OneD,NekDouble> &outarray);
 
            Array<OneD, NekDouble> v_GetnEdgecdotMF(
                                                    const int dir,
                                                    const int edge,
                                                    ExpansionSharedPtr &EdgeExp_e, 
                                                    const Array<OneD, const Array<OneD, NekDouble> > &normals,
                                                    const StdRegions::VarCoeffMap   &varcoeffs);
 
            void  v_ReOrientTracePhysMap
            (const StdRegions::Orientation orient,
             Array<OneD, int> &idmap,
             const int nq0,  const int nq1);
 
            virtual void v_SetUpPhysNormals (const int edge);
            virtual const NormalVector &v_GetTraceNormal(const int edge) const;
            virtual NekDouble v_VectorFlux(
                                           const Array<OneD, Array<OneD, NekDouble > > &vec);
        };
 
 
        inline SpatialDomains::Geometry2DSharedPtr
            Expansion2D::GetGeom2D() const
        {
            return std::dynamic_pointer_cast<SpatialDomains::
                Geometry2D>(m_geom);
        }
    } //end of namespace
} //end of namespace
 
#endif