distance_function.h

Go to the documentation of this file.

//-----------------------------------------------------------------------bl-
//--------------------------------------------------------------------------
//
// GRINS - General Reacting Incompressible Navier-Stokes
//
// Copyright (C) 2014-2017 Paul T. Bauman, Roy H. Stogner
// Copyright (C) 2010-2013 The PECOS Development Team
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the Version 2.1 GNU Lesser General
// Public License as published by the Free Software Foundation.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc. 51 Franklin Street, Fifth Floor,
// Boston, MA  02110-1301  USA
//
//-----------------------------------------------------------------------el-

#ifndef GRINS_DISTANCE_FUNCTION_H
#define GRINS_DISTANCE_FUNCTION_H

// system
//#include <limits>

// libmesh
#include "libmesh/libmesh_base.h"
#include "libmesh/libmesh_common.h"
#include "libmesh/auto_ptr.h"
#include "libmesh/dense_vector.h"
#include "libmesh/dense_matrix.h"
#include "libmesh/fe_base.h"
#include "libmesh/system.h"
#include "libmesh/elem.h"

// Forward Declarations
namespace libMesh {
  class EquationSystems;
  class BoundaryMesh;
  class Node;
}


namespace GRINS {

  // This class provides the functionality to compute the distance to
  // the nearest no slip wall boundary.
  class DistanceFunction : public libMesh::System::Initialization
  {
  public:

    DistanceFunction (libMesh::EquationSystems &es_in, const libMesh::UnstructuredMesh &bm_in);

    ~DistanceFunction () {};

    virtual void initialize ();

    libMesh::Real node_to_boundary (const libMesh::Node* node);

    void compute ();

    libMesh::UniquePtr< libMesh::DenseVector<libMesh::Real> > interpolate (const libMesh::Elem* elem, const std::vector<libMesh::Point>& qts) const;



  private:

    libMesh::EquationSystems &_equation_systems;

    const libMesh::UnstructuredMesh &_boundary_mesh;

    libMesh::UniquePtr<libMesh::FEBase> _dist_fe;

  };

  class ComputeDistanceJacobian
  {
  public:

    // ctor
    ComputeDistanceJacobian(){}

    // dtor
    ~ComputeDistanceJacobian(){}

    template <class f>
    void operator()(const libMesh::DenseVector<libMesh::Real> &U,
                    const libMesh::DenseVector<libMesh::Real> & F0,
                    f &F,
                    libMesh::DenseMatrix<libMesh::Real> &dFdU)
    {

      Up = U;
      Fp.resize(U.size());

      dFdU.resize(U.size(),U.size());

      // compute dF_i/dU_j.
      for (unsigned int j=0; j<U.size(); j++)
        {
          // tell the user's function which component we are perturbing
          // at this iteration.  this information may be used to avoid
          // repeated calculations of values which are known to be
          // unaffected for this perturbation.
          //F.set_perturbed_component(j);

          // define the pertubation for this component
          const libMesh::Real
            pert  = 4.e-8*(std::max (std::abs(U(j)), 1.e-3)); // U can be 0, pertubation cannot

          Up(j) += pert;

          const libMesh::Real                     // note this difference may not strictly be pert
            invpert = 1./(Up(j) - U(j)); // due to truncation error in the preceeding sum.

          // evaluate F at the perturbed state
          F(Up,Fp);

          // remove perturbation for next evaluation
          Up(j) = U(j);

          for (unsigned int i=0; i<U.size(); i++)
            dFdU(i,j) = (Fp(i) - F0(i))*invpert;
        }
    }

  private:

    // work vectors
    libMesh::DenseVector<libMesh::Real>    Up, Fp, Um, Fm;
  };



  class ComputeDistanceResidual
  {
  public:

    // ctor
    ComputeDistanceResidual(const libMesh::Elem* belem, const libMesh::Point* point) :
      _belem(*belem),
      _dim(_belem.dim()+1),
      _p(*point),
      _fe (libMesh::FEBase::build(_belem.dim(), libMesh::FEType(libMesh::FIRST, libMesh::LAGRANGE))),
      fe  (_fe.get())
    {
      // only supporting QUAD4 this way for now
      libmesh_assert(_belem.type()==libMesh::QUAD4);
    }

    // dtor
    ~ComputeDistanceResidual(){}

    // Calculate the residual
    void operator()(const libMesh::DenseVector<libMesh::Real> &U,
                    libMesh::DenseVector<libMesh::Real> &F)
    {

      libmesh_assert(U.size()==_dim-1);
      libmesh_assert(F.size()==_dim-1);

      libMesh::DenseVector<libMesh::Real> xx(_dim);
      xx.zero();

      libMesh::DenseMatrix<libMesh::Real> xx_U(_dim, _dim-1);
      xx_U.zero();

      std::vector<libMesh::Point> xi(1);

      xi[0](0) = U(0);
      xi[0](1) = U(1);

      // grab basis functions (evaluated at qpts)
      const std::vector<std::vector<libMesh::Real> > &basis = fe->get_phi();
      const std::vector<std::vector<libMesh::RealGradient> > &dbasis = fe->get_dphi();

      // reinitialize finite element data at xi
      fe->reinit(&_belem, &xi);

      // interpolate location and derivatives
      for (unsigned int inode=0; inode<_belem.n_nodes(); ++inode)
        for (unsigned int idim=0; idim<_dim; ++idim)
          {
            xx(idim) += _belem.point(inode)(idim) * basis[inode][0];

            for (unsigned int jdim=0; jdim<_dim-1; ++jdim)
              xx_U(idim, jdim) += _belem.point(inode)(idim) * dbasis[inode][0](jdim);
          }


      // form the residual
      F.zero();
      for (unsigned int ires=0; ires<_dim-1; ++ires)
        for (unsigned int idim=0; idim<_dim; ++idim)
          F(ires) += ( xx(idim) - _p(idim) ) * xx_U(idim, ires);


    }

  private:

    // Reference to boundary element
    const libMesh::Elem& _belem;
    const unsigned int _dim;
    const libMesh::Point& _p;

    libMesh::UniquePtr<libMesh::FEBase> _fe;
    libMesh::FEBase *fe;

    // work vectors
    libMesh::DenseVector<libMesh::Real>    Up, Fp, Um, Fm;
  };

} // end namespace GRINS

#endif // __distance_function_h__