CDiscAdjMeshBoundVariable.hpp

Go to the documentation of this file.

/*!
 * \file CDiscAdjMeshVariable.hpp
 * \brief Declaration and inlines of the class
 *        to define the adjoint variables of the mesh movement.
 * \author Ruben Sanchez
 * \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 "CVariable.hpp"
#include "../../../Common/include/containers/CVertexMap.hpp"
 
/*!
 * \ingroup DiscAdj
 * \brief Main class for defining the variables on the mesh deformation boundaries for adjoint applications.
 */
class CDiscAdjMeshBoundVariable final : public CVariable {
private:
 
  MatrixType Bound_Disp_Sens;     /*!< \brief Store the reference coordinates of the mesh. */
  MatrixType Bound_Disp_Direct;   /*!< \brief Store the reference boundary displacements of the mesh. */
 
  CVertexMap<unsigned> VertexMap; /*!< \brief Object that controls accesses to the variables of this class. */
 
public:
 
  /*!
   * \brief Constructor of the class.
   * \param[in] npoint - Values of the coordinates (initialization value).
   * \param[in] ndim - Number of dimensions of the problem.
   * \param[in] config - Definition of the particular problem.
   */
  CDiscAdjMeshBoundVariable(unsigned long npoint, unsigned long ndim, CConfig *config);
 
  /*!
   * \brief Destructor of the class.
   */
  ~CDiscAdjMeshBoundVariable() override = default;
 
  /*!
   * \brief Allocate member variables for points marked as vertex (via "Set_isVertex").
   * \param[in] config - Definition of the particular problem.
   */
  void AllocateBoundaryVariables(CConfig *config);
 
  /*!
   * \brief Get the value of the displacement imposed at the boundary.
   * \return Value of the boundary displacement.
   */
  inline const su2double* GetBoundDisp_Direct(unsigned long iPoint) const override {
    if (!VertexMap.GetVertexIndex(iPoint)) return nullptr;
    return Bound_Disp_Direct[iPoint];
  }
 
  /*!
   * \brief Set the solution for the boundary displacements.
   * \param[in] val_BoundDisp - Pointer to the boundary displacements.
   */
  inline void SetBoundDisp_Direct(unsigned long iPoint, const su2double *val_BoundDisp) override {
    if (!VertexMap.GetVertexIndex(iPoint)) return;
    for (unsigned long iDim = 0; iDim < nDim; iDim++)
      Bound_Disp_Direct(iPoint,iDim) = val_BoundDisp[iDim];
  }
 
  /*!
   * \brief Set the value of the sensitivity with respect to the undeformed coordinates.
   * \param[in] val_sens - Pointer to the sensitivities of the boundary displacements.
   */
  inline void SetBoundDisp_Sens(unsigned long iPoint, const su2double *val_sens) override {
    if (!VertexMap.GetVertexIndex(iPoint)) return;
    for (unsigned long iDim = 0; iDim < nDim; iDim++)
      Bound_Disp_Sens(iPoint,iDim) = val_sens[iDim];
  }
 
  /*!
   * \brief Get the value of the sensitivity with respect to the undeformed coordinates.
   * \param[in] iDim - Index of Mesh_Coord_Sens[nDim]
   * \return Value of the original Mesh_Coord_Sens iDim.
   */
  inline su2double GetBoundDisp_Sens(unsigned long iPoint, unsigned long iDim) const override {
    if (!VertexMap.GetVertexIndex(iPoint)) return 0.0;
    return Bound_Disp_Sens(iPoint,iDim);
  }
 
  /*!
   * \brief Get whether a node is on the boundary
   */
  inline bool Get_isVertex(unsigned long iPoint) const override {
    return VertexMap.GetIsVertex(iPoint);
  }
 
  /*!
   * \brief Set whether a node is on the boundary
   */
  inline void Set_isVertex(unsigned long iPoint, bool isVertex) override {
    VertexMap.SetIsVertex(iPoint,isVertex);
  }
 
  /*!
   * \brief Get the value of the BGS solution.
   */
  inline su2double Get_BGSSolution(unsigned long iPoint, unsigned long iDim) const override {
    if (!VertexMap.GetVertexIndex(iPoint)) return 0.0;
    return Bound_Disp_Sens(iPoint,iDim);
  }
 
  /*!
   * \brief Set the value of the solution in the previous BGS subiteration.
   */
  void Set_BGSSolution_k() override;
 
  /*!
   * \brief Restore the previous BGS subiteration to solution.
   */
  void Restore_BGSSolution_k() override;
 
  /*!
   * \brief Get the value of the solution in the previous BGS subiteration.
   * \param[out] val_solution - solution in the previous BGS subiteration.
   */
  inline su2double Get_BGSSolution_k(unsigned long iPoint, unsigned long iDim) const override {
    if (!VertexMap.GetVertexIndex(iPoint)) return 0.0;
    return Solution_BGS_k(iPoint,iDim);
  }
 
  /*!
   * \brief Get the value of the solution in the previous BGS subiteration.
   * \param[out] val_solution - solution in the previous BGS subiteration.
   */
  inline void Set_BGSSolution_k(unsigned long iPoint, unsigned long iDim, su2double val) override {
    if (!VertexMap.GetVertexIndex(iPoint)) return;
    Solution_BGS_k(iPoint,iDim) = val;
  }
 
};