ENH: (further) Doxygen documentation updates for module support

This commit is contained in:
Andrew Heather
2016-06-17 17:41:04 +01:00
parent b6ad46e139
commit d31adaeb5e
43 changed files with 135 additions and 9 deletions

View File

@ -578,7 +578,7 @@ SORT_MEMBERS_CTORS_1ST = NO
# appear in their defined order.
# The default value is: NO.
SORT_GROUP_NAMES = NO
SORT_GROUP_NAMES = YES
# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be sorted by
# fully-qualified names, including namespaces. If set to NO, the class list will

View File

@ -24,6 +24,9 @@ License
Class
Foam::DICPreconditioner
Group
grpLduMatrixPreconditioners
Description
Simplified diagonal-based incomplete Cholesky preconditioner for symmetric
matrices (symmetric equivalent of DILU). The reciprocal of the

View File

@ -24,6 +24,9 @@ License
Class
Foam::DILUPreconditioner
Group
grpLduMatrixPreconditioners
Description
Simplified diagonal-based incomplete LU preconditioner for asymmetric
matrices. The reciprocal of the preconditioned diagonal is calculated

View File

@ -24,6 +24,9 @@ License
Class
Foam::FDICPreconditioner
Group
grpLduMatrixPreconditioners
Description
Faster version of the DICPreconditioner diagonal-based incomplete
Cholesky preconditioner for symmetric matrices

View File

@ -24,6 +24,9 @@ License
Class
Foam::GAMGPreconditioner
Group
grpLduMatrixPreconditioners
Description
Geometric agglomerated algebraic multigrid preconditioner.

View File

@ -24,6 +24,9 @@ License
Class
Foam::diagonalPreconditioner
Group
grpLduMatrixPreconditioners
Description
Diagonal preconditioner for both symmetric and asymmetric matrices.

View File

@ -24,6 +24,9 @@ License
Class
Foam::noPreconditioner
Group
grpLduMatrixPreconditioners
Description
Null preconditioner for both symmetric and asymmetric matrices.

View File

@ -24,6 +24,9 @@ License
Class
Foam::DICSmoother
Group
grpLduMatrixSmoothers
Description
Simplified diagonal-based incomplete Cholesky smoother for symmetric
matrices.

View File

@ -24,6 +24,9 @@ License
Class
Foam::DICGaussSeidelSmoother
Group
grpLduMatrixSmoothers
Description
Combined DIC/GaussSeidel smoother for symmetric matrices in which DIC
smoothing is followed by GaussSeidel to ensure that any "spikes" created

View File

@ -24,6 +24,9 @@ License
Class
Foam::DILUSmoother
Group
grpLduMatrixSmoothers
Description
Simplified diagonal-based incomplete LU smoother for asymmetric matrices.

View File

@ -24,6 +24,9 @@ License
Class
Foam::GaussSeidelSmoother
Group
grpLduMatrixSmoothers
Description
A lduMatrix::smoother for Gauss-Seidel

View File

@ -24,6 +24,9 @@ License
Class
Foam::nonBlockingGaussSeidelSmoother
Group
grpLduMatrixSmoothers
Description
Variant of gaussSeidelSmoother that expects processor boundary
cells to be sorted last and so can block later. Only when the

View File

@ -24,6 +24,9 @@ License
Class
Foam::symGaussSeidelSmoother
Group
grpLduMatrixSmoothers
Description
A lduMatrix::smoother for symmetric Gauss-Seidel

View File

@ -24,6 +24,9 @@ License
Class
Foam::BICCG
Group
grpLduMatrixSolvers
Description
Diagonal incomplete LU preconditioned BiCG solver derived from the general
preconditioned BiCG solver PBiCG but with the choice of preconditioner
@ -49,7 +52,7 @@ namespace Foam
{
/*---------------------------------------------------------------------------*\
Class BICCG Declaration
Class BICCG Declaration
\*---------------------------------------------------------------------------*/
class BICCG
@ -64,6 +67,7 @@ class BICCG
//- Disallow default bitwise assignment
void operator=(const BICCG&);
public:
//- Return the dictionary constructed from the components.
@ -112,7 +116,6 @@ public:
//- Destructor
virtual ~BICCG()
{}
};

View File

@ -24,10 +24,13 @@ License
Class
Foam::GAMGSolver
Group
grpLduMatrixSolvers
Description
Geometric agglomerated algebraic multigrid solver.
Characteristics:
Characteristics:
- Requires positive definite, diagonally dominant matrix.
- Agglomeration algorithm: selectable and optionally cached.
- Restriction operator: summation.
@ -65,7 +68,7 @@ namespace Foam
{
/*---------------------------------------------------------------------------*\
Class GAMGSolver Declaration
Class GAMGSolver Declaration
\*---------------------------------------------------------------------------*/
class GAMGSolver

View File

@ -24,6 +24,9 @@ License
Class
Foam::ICCG
Group
grpLduMatrixSolvers
Description
Incomplete Cholesky preconditioned CG solver derived from the general
preconditioned CG solver PCG but with the choice of preconditioner
@ -64,6 +67,7 @@ class ICCG
//- Disallow default bitwise assignment
void operator=(const ICCG&);
public:
//- Return the dictionary constructed from the components.
@ -111,7 +115,6 @@ public:
//- Destructor
virtual ~ICCG()
{}
};

View File

@ -24,6 +24,9 @@ License
Class
Foam::PCG
Group
grpLduMatrixSolvers
Description
Preconditioned conjugate gradient solver for symmetric lduMatrices
using a run-time selectable preconditioner.
@ -44,7 +47,7 @@ namespace Foam
{
/*---------------------------------------------------------------------------*\
Class PCG Declaration
Class PCG Declaration
\*---------------------------------------------------------------------------*/
class PCG

View File

@ -24,6 +24,9 @@ License
Class
Foam::diagonalSolver
Group
grpLduMatrixSolvers
Description
Foam::diagonalSolver
@ -43,7 +46,7 @@ namespace Foam
{
/*---------------------------------------------------------------------------*\
Class diagonalSolver Declaration
Class diagonalSolver Declaration
\*---------------------------------------------------------------------------*/
class diagonalSolver

View File

@ -24,6 +24,9 @@ License
Class
Foam::smoothSolver
Group
grpLduMatrixSolvers
Description
Iterative solver for symmetric and asymetric matrices which uses a
run-time selected smoother e.g. GaussSeidel to converge the solution to
@ -65,6 +68,7 @@ protected:
//- Read the control parameters from the controlDict_
virtual void readControls();
public:
//- Runtime type information

View File

@ -25,6 +25,7 @@ License
\defgroup grpFvSchemes Finite volume numerical schemes
@{
\ingroup grpNumerics
This group contains finite volume numerical schemes
@}

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::fixedTemperatureConstraint
Group
grpFvOptionsConstraints
Description
Fixed temperature equation constraint

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::velocityDampingConstraint
Group
grpFvOptionsConstraints
Description
Constraint for velocity to dampen velocity fluctuations in
steady simulations

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::explicitSetValue
Group
grpFvOptionsConstraints
Description
Set values field values explicity.

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::limitTemperature
Group
grpFvOptionsCorrections
Description
Correction for temperature to apply limits between minimum and maximum
values

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::actuationDiskSource
Group
grpFvOptionsSources
Description
Actuation disk source

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::buoyancyEnergy
Group
grpFvOptionsSources
Description
Calculates and applies the buoyancy energy source rho*(U&g) to the energy
equation.

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::buoyancyForce
Group
grpFvOptionsSources
Description
Calculates and applies the buoyancy force rho*g to the momentum equation
corresponding to the specified velocity field.

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::directionalPressureGradientExplicitSource
Group
grpFvOptionsSources
Description
Creates an explicit pressure gradient source in such a way to deflect the
flow towards an specific direction (flowDir). Alternatively add an extra

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::effectivenessHeatExchangerSource
Group
grpFvOptionsSources
Description
Heat exchanger source model, in which the heat exchanger is defined as a
selection of cells.

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::explicitPorositySource
Group
grpFvOptionsSources
Description
Explicit porosity source

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::meanVelocityForce
Group
grpFvOptionsSources
Description
Calculates and applies the force necessary to maintain the specified mean
velocity.

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::radialActuationDiskSource
Group
grpFvOptionsSources
Description
Actuation disk source including radial thrust

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::rotorDiskSource
Group
grpFvOptionsSources
Description
Rotor disk source

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::solidificationMeltingSource
Group
grpFvOptionsSources
Description
This source is designed to model the effect of solidification and melting
processes, e.g. windhield defrosting. The phase change occurs at the

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::tabulatedAccelerationSource
Group
grpFvOptionsSources
Description
Solid-body 6-DoF acceleration source
@ -64,7 +67,7 @@ namespace fv
{
/*---------------------------------------------------------------------------*\
Class tabulatedAccelerationSource Declaration
Class tabulatedAccelerationSource Declaration
\*---------------------------------------------------------------------------*/
class tabulatedAccelerationSource
@ -84,6 +87,7 @@ protected:
dimensionedVector g0_;
private:
// Private Member Functions

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::codedSource
Group
grpFvOptionsSources
Description
Constructs on-the-fly fvOption source

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::SemiImplicitSource
Group
grpFvOptionsSources
Description
Semi-implicit source, described using an input dictionary. The injection
rate coefficients are specified as pairs of Su-Sp coefficients, i.e.

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::interRegionExplicitPorositySource
Group
grpFvOptionsSources
Description
Inter-region explicit porosity source.

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::constantHeatTransfer
Group
grpFvOptionsSources
Description
Constant heat transfer model. htcConst [W/m2/K] and area/volume [1/m]
must be provided.

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::interRegionHeatTransferModel
Group
grpFvOptionsSources
Description
Base class for inter region heat exchange. The derived classes must
provide the heat transfer coeffisine (htc) which is used as follows

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::tabulatedHeatTransfer
Group
grpFvOptionsSources
Description
Tabulated heat transfer model. The heat exchange area per unit volume
must be provided. The 2D table returns the heat transfer coefficient

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::tabulatedNTUHeatTransfer
Group
grpFvOptionsSources
Description
Tabulated heat transfer model.

View File

@ -24,6 +24,9 @@ License
Class
Foam::fv::variableHeatTransfer
Group
grpFvOptionsSources
Description
Variable heat transfer model depending on local values. The area of contact
between regions (area) must be provided. The Nu number is calculated as: