CVerificationSolution.hpp

Go to the documentation of this file.

/*!
 * \file CVerificationSolution.hpp
 * \brief Header file for the base class CVerificationSolution.
 *        The implementations are in the <i>CVerificationSolution.cpp</i> file.
 * \author T. Economon, E. van der Weide
 * \version 8.5.0 "Harrier"
 *
 * SU2 Project Website: https://su2code.github.io
 *
 * The SU2 Project is maintained by the SU2 Foundation
 * (http://su2foundation.org)
 *
 * Copyright 2012-2026, SU2 Contributors (cf. AUTHORS.md)
 *
 * SU2 is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * SU2 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 SU2. If not, see <http://www.gnu.org/licenses/>.
 */
 
#pragma once
 
#include <cmath>
#include "../../CConfig.hpp"
 
/*!
 * \class CVerificationSolution
 * \brief Class for holding verification PDE solutions, e.g., phi = phi(x,y,z,t),
 *        used for initial conditions, analytic solutions, manufactured solutions.
 * \author T. Economon, E. van der Weide
 */
class CVerificationSolution {
 protected:
  int rank; /*!< \brief MPI Rank. */
  int size; /*!< \brief MPI Size. */
 
  unsigned short nDim; /*!< \brief Number of dimension of the problem. */
  unsigned short nVar; /*!< \brief Number of variables of the problem  */
 
  MAIN_SOLVER Kind_Solver; /*!< \brief The kind of solver we are running. */
 
 private:
  su2double* Error_RMS; /*!< \brief Vector with the global RMS error for each variable in a verification case. */
  su2double* Error_Max; /*!< \brief Vector with the global max error for each variable in a verification case. */
  unsigned long* Error_Point_Max;    /*!< \brief Global index for the node with the max error in a verification case. */
  su2double** Error_Point_Max_Coord; /*!< \brief Coordinates for the node with the max error in a verification case. */
 
 public:
  /*!
   * \brief Constructor of the class.
   */
  CVerificationSolution(void);
 
  /*!
   * \overload
   * \param[in] val_nDim  - Number of dimensions of the problem.
   * \param[in] val_nvar  - Number of variables of the problem.
   * \param[in] val_iMesh - Multigrid level of the solver.
   * \param[in] config    - Definition of the particular problem.
   */
  CVerificationSolution(unsigned short val_nDim, unsigned short val_nvar, unsigned short val_iMesh, CConfig* config);
 
  /*!
   * \brief Destructor of the class.
   */
  virtual ~CVerificationSolution(void);
 
  /*!
   * \brief Get the exact solution at the current position and time.
   * \param[in] val_coords   - Cartesian coordinates of the current position.
   * \param[in] val_t        - Current physical time.
   * \param[in] val_solution - Array where the exact solution is stored.
   */
  virtual void GetSolution(const su2double* val_coords, const su2double val_t, su2double* val_solution) const;
 
  /*!
   * \brief Get the exact solution at the current position and t = 0.
   * \param[in] val_coords   - Cartesian coordinates of the current position.
   * \param[in] val_solution - Array where the exact solution is stored.
   */
  void GetInitialCondition(const su2double* val_coords, su2double* val_solution) const;
 
  /*!
   * \brief Get the boundary conditions state for an exact solution.
   * \param[in] val_coords   - Cartesian coordinates of the current position.
   * \param[in] val_t        - Current physical time.
   * \param[in] val_solution - Array where the exact solution is stored.
   */
  virtual void GetBCState(const su2double* val_coords, const su2double val_t, su2double* val_solution) const;
 
  /*!
   * \brief Get the source term for the manufactured solution (MMS).
   * \param[in] val_coords   - Cartesian coordinates of the current position.
   * \param[in] val_t        - Current physical time.
   * \param[in] val_solution - Array where the exact solution is stored.
   */
  virtual void GetMMSSourceTerm(const su2double* val_coords, const su2double val_t, su2double* val_source) const;
 
  /*!
   * \brief Whether or not this verification solution is a manufactured solution.
   * \return  - False as default value. Overwrite this function for a
                manufactured solution.
   */
  virtual bool IsManufacturedSolution(void) const;
 
  /*!
   * \brief Whether or not the exact solution is known for this verification solution.
   * \return  - True as default value. Overwrite this function if the exact
                solution is not known.
   */
  virtual bool ExactSolutionKnown(void) const;
 
  /*!
   * \brief Get the local error defined as the local solution minus the verification solution.
   * \param[in]  val_coords   - Cartesian coordinates of the current position.
   * \param[in]  val_solution - Array where the exact solution is stored.
   * \param[out] val_error    - Array where the local error is stored.
   */
  void GetLocalError(const su2double* val_coords, const su2double val_t, const su2double* GetLocalErrorval_solution,
                     su2double* val_error) const;
 
  /*!
   * \brief Set the global RMS error for verification cases.
   * \param[in] val_var   - Index of the variable.
   * \param[in] val_error - Value of the RMS error to store in the position <i>val_var</i>.
   */
  void SetError_RMS(unsigned short val_var, su2double val_error) { Error_RMS[val_var] = val_error; }
 
  /*!
   * \brief Increments the global RMS error for verification cases.
   * \param[in] val_var   - Index of the variable.
   * \param[in] val_error - Value of the RMS error to store in the position <i>val_var</i>.
   */
  void AddError_RMS(unsigned short val_var, su2double val_error) { Error_RMS[val_var] += val_error; }
 
  /*!
   * \brief Get the global RMS error for verification cases.
   * \param[in] val_var - Index of the variable.
   * \return Value of global RMS error for the variable in the position <i>val_var</i>.
   */
  su2double GetError_RMS(unsigned short val_var) const { return Error_RMS[val_var]; }
 
  /*!
   * \brief Set the global maximum error for verification cases.
   * \param[in] val_var   - Index of the variable.
   * \param[in] val_error - Value of the maximum error to store in the position <i>val_var</i>.
   */
  void SetError_Max(unsigned short val_var, su2double val_error, unsigned long val_point) {
    Error_Max[val_var] = val_error;
    Error_Point_Max[val_var] = val_point;
  }
 
  /*!
   * \brief Increment the global maximum error for verification cases.
   * \param[in] val_var   - Index of the variable.
   * \param[in] val_error - Value of the maximum error to store in the position <i>val_var</i>.
   * \param[in] val_point - Value of the point index for the max error.
   * \param[in] val_coord - Location (x, y, z) of the max error point.
   */
  void AddError_Max(unsigned short val_var, su2double val_error, unsigned long val_point, const su2double* val_coord) {
    if (val_error > Error_Max[val_var]) {
      Error_Max[val_var] = val_error;
      Error_Point_Max[val_var] = val_point;
      for (unsigned short iDim = 0; iDim < nDim; iDim++) Error_Point_Max_Coord[val_var][iDim] = val_coord[iDim];
    }
  }
 
  /*!
   * \brief Get the global maximum error for verification cases.
   * \param[in] val_var - Index of the variable.
   * \return Value of global maximum error for the variable in the position <i>val_var</i>.
   */
  su2double GetError_Max(unsigned short val_var) const { return Error_Max[val_var]; }
 
  /*!
   * \brief Get the global index of the node with the max error for verification cases.
   * \param[in] val_var - Index of the variable.
   * \return Global index of the point with the max error for the variable in the position <i>val_var</i>.
   */
  unsigned long GetError_Point_Max(unsigned short val_var) const { return Error_Point_Max[val_var]; }
 
  /*!
   * \brief Get the coordinates of the node with the max error for verification cases.
   * \param[in] val_var - Index of the variable.
   * \return Coordinates of the point with the max error for the variable in the position <i>val_var</i>.
   */
  const su2double* GetError_Point_Max_Coord(unsigned short val_var) const { return Error_Point_Max_Coord[val_var]; }
 
  /*!
   * \brief Calculate the global error metrics for verification cases.
   * \param[in] nDOFsGlobal - Global number of degrees of freedom for the current problem.
   * \param[in] config      - Definition of the particular problem.
   */
  void SetVerificationError(unsigned long nDOFsGlobal, CConfig* config);
};