Skip to content

Commit 9127cfa

Browse files
committed
doxygen
1 parent e205c31 commit 9127cfa

5 files changed

Lines changed: 31 additions & 17 deletions

File tree

Docs/docmain.hpp

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -25,10 +25,10 @@
2525
* License along with SU2. If not, see <http://www.gnu.org/licenses/>.
2626
*/
2727

28-
/*!
28+
/*!
2929
* \mainpage SU2 version 7.5.1 "Blackbird"
3030
* SU2 suite is an open-source collection of C++ based software tools
31-
* to perform PDE analysis and PDE constrained optimization. The toolset is designed with
31+
* to perform PDE analysis and PDE constrained optimization. The toolset is designed with
3232
* computational fluid dynamics and aerodynamic shape optimization in mind, but is extensible to
3333
* include other families of governing equations such as potential flow, electrodynamics, chemically reacting
3434
* flows, and many others. SU2 is released under an open-source license.
@@ -66,43 +66,43 @@
6666

6767
/*!
6868
* \defgroup ConvDiscr Discretization of the convective terms
69-
* \brief Group of classes which define the numerical methods for
70-
* discretizing the convective terms of a Partial Differential Equation.
71-
* There are methods for solving the direct, adjoint and linearized
69+
* \brief Group of classes which define the numerical methods for
70+
* discretizing the convective terms of a Partial Differential Equation.
71+
* There are methods for solving the direct, adjoint and linearized
7272
* systems of equations.
7373
*/
7474

7575
/*!
7676
* \defgroup ViscDiscr Discretization of the viscous terms
77-
* \brief Group of classes which define the numerical methods for
78-
* discretizing the viscous terms of a Partial Differential Equation.
79-
* There are methods for solving the direct, adjoint and linearized
77+
* \brief Group of classes which define the numerical methods for
78+
* discretizing the viscous terms of a Partial Differential Equation.
79+
* There are methods for solving the direct, adjoint and linearized
8080
* systems of equations.
8181
*/
8282

8383
/*!
8484
* \defgroup SourceDiscr Discretization of the source terms
85-
* \brief Group of classes which define the numerical methods for
86-
* discretizing the source terms of a Partial Differential Equation.
87-
* There are methods for solving the direct, adjoint and linearized
85+
* \brief Group of classes which define the numerical methods for
86+
* discretizing the source terms of a Partial Differential Equation.
87+
* There are methods for solving the direct, adjoint and linearized
8888
* systems of equations.
8989
*/
9090

9191
/*!
9292
* \defgroup Euler_Equations Solving the Euler equations
93-
* \brief Group of classes which define the system of Euler equations in
93+
* \brief Group of classes which define the system of Euler equations in
9494
* three formulations: direct, adjoint, and linearized.
9595
*/
9696

9797
/*!
9898
* \defgroup Navier_Stokes_Equations Solving the Navier-Stokes equations
99-
* \brief Group of classes which define the system of Navier-Stokes equations in
99+
* \brief Group of classes which define the system of Navier-Stokes equations in
100100
* three formulations: direct, adjoint, and linearized.
101101
*/
102102

103103
/*!
104104
* \defgroup Turbulence_Model Solving the turbulence model equations
105-
* \brief Group of classes which define the turbulence model in
105+
* \brief Group of classes which define the turbulence model in
106106
* three formulations: direct, adjoint, and linearized.
107107
*/
108108

@@ -130,6 +130,13 @@
130130
* space and time integration. The latter use mostly the "Solvers".
131131
*/
132132

133+
/*!
134+
* \defgroup PySU2 Python Wrapper functions
135+
* \brief Functions of the driver classes (\ref Drivers) that can be used to customize SU2
136+
* via Python. For example, set custom temperature distributions at boundaries,
137+
* deform the mesh, etc.
138+
*/
139+
133140
/*!
134141
* \defgroup Variable Storing solution variables
135142
* \brief Classes used to store and access the solution variables of all types of problems.

SU2_CFD/include/drivers/CDriver.hpp

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -403,6 +403,9 @@ class CDriver : public CDriverBase {
403403
*/
404404
virtual void SetInitialMesh() {}
405405

406+
/// \addtogroup PySU2
407+
/// \{
408+
406409
/*!
407410
* \brief Process the boundary conditions and update the multi-grid structure.
408411
*/
@@ -644,6 +647,8 @@ class CDriver : public CDriverBase {
644647
*/
645648
void SetInlet_Angle(unsigned short iMarker, passivedouble alpha);
646649

650+
/// \}
651+
647652
/*!
648653
* \brief Sum the number of primal or adjoint variables for all solvers in a given zone.
649654
* \param[in] iZone - Index of the zone.

SU2_CFD/include/drivers/CDriverBase.hpp

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,9 @@ class CDriverBase {
121121
*/
122122
virtual void Postprocessing(){}
123123

124+
/// \addtogroup PySU2
125+
/// @{
126+
124127
/*!
125128
* \brief Get the number of design variables.
126129
* \return Number of design variables.
@@ -320,6 +323,7 @@ class CDriverBase {
320323
* \brief Communicate the boundary mesh displacements.
321324
*/
322325
void CommunicateMeshDisplacements(void);
326+
/// \}
323327

324328
protected:
325329
/*!

SU2_DEF/obj/Makefile.am

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,6 @@ ACLOCAL_AMFLAGS = ${ACLOCAL_FLAGS}
3333
bin_PROGRAMS = ../bin/SU2_DEF
3434

3535
___bin_SU2_DEF_SOURCES = \
36-
../include/SU2_DEF.hpp \
3736
../src/SU2_DEF.cpp
3837

3938

SU2_DOT/obj/Makefile.am

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,8 +40,7 @@ if BUILD_REVERSE
4040
bin_PROGRAMS += ../bin/SU2_DOT_AD
4141
endif
4242

43-
su2_dot_sources = ../include/SU2_DOT.hpp \
44-
../src/SU2_DOT.cpp
43+
su2_dot_sources = ../src/SU2_DOT.cpp
4544

4645
su2_dot_ldadd =
4746
su2_dot_cxx_flags = -std=c++11

0 commit comments

Comments
 (0)