Courant_impose.cpp

/****************************************************************************
* 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.
*
*****************************************************************************/
 
#include <Courant_impose.h>
#include <Domaine_Cl_dis_base.h>
#include <Equation_base.h>
#include <Cahn_Hilliard.h>
#include <Probleme_base.h>
#include <Milieu_base.h>
#include <Espece_intercalee.h>
#include <EChaine.h>
 
Implemente_instanciable(Courant_impose, "Courant_impose", Neumann_paroi);
// XD Courant_impose condlim_base Courant_impose INHERITS_BRACE Neumann boundary condition for imposed courant
// XD_CONT (multiphase problem)
// XD attr ch front_field_base ch REQ Boundary field type.
 
Sortie& Courant_impose::printOn(Sortie& s) const { return s << que_suis_je() << finl; }
 
Entree& Courant_impose::readOn(Entree& s)
{
  if (app_domains.size() == 0) app_domains = { Motcle("Cahn_Hilliard"), Motcle("indetermine") };
  Cerr << "*** Boundary conditions : Imposed courant for Lithium-ion Batteries case (only Cahn-Hilliard has been added yet) ***" << finl;
 
  if (supp_discs.size() == 0) supp_discs = { Nom("VDF") };
 
  // Lecture de la valeur uniforme du champ de courant imposé
  s >> Iimp_;
 
//  Cerr << "Après lecture : Iimp = " << Iimp_ << finl;
 
  // Dimensionnement du champ de flux à la frontière et initialisation à 0
  // Type : champ variable en espace et en temps
  le_champ_front.typer("Champ_front_fonc");
  le_champ_front->nommer("Courant_impose");
//  Cerr << "Après typer." << finl;
 
//  Cerr << "[Courant_impose] Sortie du readOn." << finl;
  return s;
}
 
void Courant_impose::associer_domaine_cl_dis_base(const Domaine_Cl_dis_base& zcl)
{
  mon_dom_cl_dis = zcl;
 
  Equation_base& eq = mon_dom_cl_dis->equation();
  const int dim_champ = eq.inconnue().nb_comp();
 
//  Cerr << "dim_champ = " << dim_champ << finl;
//  Cerr << "Temps = " << eq.schema_temps().temps_courant() << finl;
  // le_champ_front->set_temps_defaut(eq.schema_temps().temps_courant());
  le_champ_front->fixer_nb_comp(dim_champ);
//  Cerr << "Après avoir fixé le nombre de composantes." << finl;
 
  le_champ_front->verifier(*this);
 
//  Cerr << "PREMIER PRINT = " << le_champ_front << finl;
}
 
void Courant_impose::verifie_ch_init_nb_comp() const
{
  Cerr << "[Courant_impose::verifie_ch_init_nb_comp()] ..." << finl;
 
  if (le_champ_front)
    {
      const Equation_base& eq = domaine_Cl_dis().equation();
      const int nb_comp = le_champ_front->nb_comp();
      eq.verifie_ch_init_nb_comp_cl(eq.inconnue(), nb_comp, *this);
    }
}
 
void Courant_impose::completer()
{
  Equation_base& eq = mon_dom_cl_dis->equation();
  const int dim_champ = eq.inconnue().nb_comp();
 
  Cerr << "[Courant_impose::completer()] ..." << finl;
 
  int i;
  ndeb_ = ref_cast(Front_VF,frontiere_dis()).num_premiere_face();
//  Cerr << "ndeb_ = " << ndeb_ << finl;
  nb_faces_ = ref_cast(Front_VF,frontiere_dis()).nb_faces();
//  Cerr << "nb_faces_ = " << nb_faces_ << finl;
  le_champ_front->valeurs().resize(nb_faces_,dim_champ);
//  Cerr << "Dimension of le_champ_front = " << le_champ_front->valeurs().dimension(0) << " x "
//       << le_champ_front->valeurs().dimension(1) << finl;
 
  le_champ_front->set_instationnaire(true);
 
//  Cerr << "Après set_instationnaire." << finl;
  if (le_champ_front->instationnaire())
    Cerr << "[Courant_impose] : Instationnary field OK." << finl;
  else
    {
      Cerr << "[Courant_impose] : Stationnary field... Not normal." << finl;
      exit();
    }
 
  surfaces_.resize(nb_faces_);
 
  Domaine_VF& zvf = ref_cast(Domaine_VF, mon_dom_cl_dis->domaine_dis());
  for (i = 0; i < nb_faces_; i++)
    {
      surfaces_(i) = zvf.face_surfaces(i + ndeb_);
    }
 
  face_voisins_ = zvf.face_voisins();
 
//  Cerr << "SECOND PRINT = " << le_champ_front->valeurs() << finl;
 
}
 
/*! @brief Met a jour les conditions aux limites sur le courant (spécifique à cette classe)
 *
 */
void Courant_impose::mettre_a_jour_courant(const DoubleTab& c, const DoubleTab& mutilde)
{
  // Potentiel de l'électrolyte
  double mu_el(0.), numer(0.), denom(0.), numer_tot(0.), denom_tot(0.);
 
  DoubleTab& courant(le_champ_front->valeurs());
  int nb_couches = courant.line_size();
 
  Espece_intercalee& mil = ref_cast(Espece_intercalee, mon_dom_cl_dis->equation().milieu());
  double i0 = mil.i0();
  double damkohler = mil.damkohler();
  double T_sur_Tref = mil.T_sur_Tref();
 
  double S(0.), S_tot(0.), ds(0.);
 
//  Cerr << "surfaces = " << surfaces_ << finl;
 
  for (int j=0; j<nb_couches; j++)
    for (int face = 0; face < nb_faces_; face++)
      {
        int facegl = face + ndeb_; // indice de face global
        int elem = face_voisins_(facegl, 0);
        if (elem == -1)
          elem = face_voisins_(facegl, 1);
        ds = surfaces_(face);
//        Cerr << "ds = " << ds << finl;
        S += ds;
        numer += c(elem,j)*(1.-c(elem,j))*mutilde(elem,j)*ds;
        denom += c(elem,j)*(1.-c(elem,j))*ds;
      }
//  Cerr << "S = " << S << finl;
//  Cerr << "numer = " << numer << finl;
//  Cerr << "denom = " << denom << finl;
 
  S_tot = mp_sum(S); // N_couches * L_y (ou L_x)
//  Cerr << "S_tot = " << S_tot << finl;
  numer_tot = mp_sum(numer);
//  Cerr << "numer_tot = " << numer_tot << finl;
  numer_tot /= S_tot; // C'est une moyenne sur la surface d'entrée : N_couches * L_y (ou L_x)
  denom_tot = mp_sum(denom);
//  Cerr << "denom_tot = " << denom_tot << finl;
  denom_tot /= S_tot; // C'est aussi une moyenne sur la surface d'entrée
//  Cerr << "deuxieme terme du numerateur = " << (S_tot * (Iimp_)/i0) << finl;
  // Multiplication par la surface totale (qui comprend aussi l'indice j des couches)
//  if (abs(denom_tot) < 1.E-12)
//    mu_el = 0.;
//  else
  mu_el = ( ((Iimp_/i0) * T_sur_Tref) + numer_tot ) / denom_tot;
 
//  Cerr << "mu_el = " << mu_el << finl;
 
  const double constante = damkohler/(T_sur_Tref);
 
  // Boucle sur les couches
  for (int j=0; j<nb_couches; j++)
    for (int face = 0; face < nb_faces_; face++)
      {
        int facegl = face + ndeb_;
        int elem = face_voisins_(facegl, 0);
        if (elem == -1)
          elem = face_voisins_(facegl, 1);
        courant(face,j) = constante * c(elem,j)*(1.-c(elem,j))*(mu_el - mutilde(elem,j));
      }
 
//  Cerr << "courant imposé = " << courant << finl;
}
 
/*! @brief Renvoie la valeur du flux impose sur la i-eme composante du champ representant le flux a la frontiere.
 *
 *     Le champ a la frontiere est considere constant sur tous
 *     les elements de la frontiere.
 *     La valeur du flux impose a la frontiere est egale
 *     a la valeur du champ (considere constant) a la frontiere divise par d_rho.
 *
 * @param (int i) indice suivant la premiere dimension du champ
 * @return (double) la valeur imposee sur la composante du champ specifiee
 * @throws deuxieme dimension du champ de frontiere superieur a 1
 */
double Courant_impose::flux_impose(int i) const
{
  return Neumann::flux_impose(i);
}
 
/*! @brief Renvoie la valeur du flux impose sur la (i,j)-eme composante du champ representant le flux a la frontiere.
 *
 *     Le champ a la frontiere n'est PAS constant sur tous les elements
 *     la frontiere.
 *
 * @param (int i) indice suivant la premiere dimension du champ
 * @param (int j) indice suivant la deuxieme dimension du champ
 * @return (double) la valeur imposee sur la composante du champ specifiee
 */
double Courant_impose::flux_impose(int i, int j) const
{
  return Neumann::flux_impose(i,j);
}