Champ_Face_PolyMAC_MPFA.h

/****************************************************************************
* Copyright (c) 2025, CEA
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
* 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
* 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
*****************************************************************************/
 
#ifndef Champ_Face_PolyMAC_MPFA_included
#define Champ_Face_PolyMAC_MPFA_included
 
#include <Champ_Face_PolyMAC_HFV.h>
#include <Domaine_PolyMAC_MPFA.h>
#include <SolveurSys.h>
 
/*! @brief : class Champ_Face_PolyMAC_MPFA
 *
 *  @brief Field corresponding to an unknown described by its tangential components on dual faces (upstream-downstream line, e.g. velocity).
 *  Face fluxes are accessible via the valeurs_normales() methods, with automatic synchronization.
 *  Degrees of freedom: tangential components on dual faces.
 *
 *
 */
 
class Champ_Face_PolyMAC_MPFA : public Champ_Face_PolyMAC_HFV
{
  Declare_instanciable(Champ_Face_PolyMAC_MPFA) ;
 
public :
  inline const Domaine_PolyMAC_MPFA& domaine_PolyMAC_MPFA() const { return ref_cast(Domaine_PolyMAC_MPFA, le_dom_VF.valeur()); }
 
  int fixer_nb_valeurs_nodales(int n) override;
  void init_auxiliary_variables() override; /* request addition of auxiliary variables (\vec v at elements) */
  int reprendre(Entree& fich) override;
 
  DoubleTab& valeur_aux_elems(const DoubleTab& positions, const IntVect& polys, DoubleTab& result) const override;
  DoubleTab& valeur_aux_elems_passe(const DoubleTab& positions, const IntVect& polys, DoubleTab& result) const override;
  DoubleVect& valeur_aux_elems_compo(const DoubleTab& positions, const IntVect& polys, DoubleVect& result, int ncomp) const override;
  DoubleTab& trace(const Frontiere_dis_base& , DoubleTab& , double, int distant ) const override;
 
  Champ_base& affecter_(const Champ_base& ) override;
 
  //interpolations of velocity at faces -> velocity at elements
  void update_ve(DoubleTab& val) const; //first-order
 
  void init_ve2() const; //second-order -> using a matrix
  mutable IntTab ve2d, ve2j, ve2bj;
  mutable DoubleTab ve2c, ve2bc;
  void update_ve2(DoubleTab& val, int incr = 0) const;
 
  /* utility for computing source terms: computes the vector v_e + n_f (v_f - v_e . n_f)
     returns: the vector, its norm and its derivatives with respect to v_e and v_f
  */
  inline double v_norm(const DoubleTab& val, const DoubleTab& val_f, int e, int f, int k, int l, double *v_ext, double *dnv) const
  {
    const Domaine_PolyMAC_MPFA& domaine = domaine_PolyMAC_MPFA();
    int d, D = dimension, nf_tot = domaine.nb_faces_tot();
    const DoubleTab& nf = domaine.face_normales();
    const DoubleVect& fs = domaine.face_surfaces();
    double scal = 0, vf = f >= 0 ? val_f(f, k) - (l >= 0 ? val_f(f, l) : 0) : 0, v_temp[3], *v = v_ext ? v_ext : v_temp;
    for (d = 0; d < D; d++) v[d] = val(nf_tot + D * e + d, k) - (l >= 0 ? val(nf_tot + D * e + d, l) : 0);
    if (f >= 0)
      for (d = 0, scal = domaine.dot(v, &nf(f, 0)) / fs(f); d < D; d++) v[d] += (vf - scal) * nf(f, d) / fs(f);
    double nv = sqrt(domaine.dot(v, v));
    if (dnv)
      for (d = 0; d < D; d++) dnv[d] = nv ? (v[d] - (f >= 0 ? vf * nf(f, d) / fs(f) : 0)) / nv : 0;
#ifdef _COMPILE_AVEC_PGCC
    if (dnv) dnv[3] = f >= 0 && nv ? vf / (nv+DMINFLOAT) : 0; // nvc++ sucks
#else
    if (dnv) dnv[3] = f >= 0 && nv ? vf / nv : 0;
#endif
    return nv;
  }
private:
  DoubleTab& valeur_aux_elems_(const DoubleTab& val_face ,const DoubleTab& positions, const IntVect& les_polys, DoubleTab& valeurs) const override;
};
 
#endif /* Champ_Face_PolyMAC_MPFA_included */