Updated documentation for foamInfo: The "Note" entry is now part of "Description" or "Usage"

so that it is printed by foamInfo.
This commit is contained in:
Henry Weller
2022-05-11 21:27:27 +01:00
parent 7a8f59e2b9
commit 48d9c77085
28 changed files with 147 additions and 147 deletions

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2011-2020 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -60,7 +60,7 @@ Usage
} }
\endverbatim \endverbatim
Note Note:
In the event of reverse flow, a zero-gradient condition is applied In the event of reverse flow, a zero-gradient condition is applied
See also See also

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2011-2020 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -60,13 +60,12 @@ Usage
} }
\endverbatim \endverbatim
Note Note:
In the event of reverse flow, a zero-gradient condition is applied In the event of reverse flow, a zero-gradient condition is applied
See also See also
Foam::inletOutletFvPatchField Foam::inletOutletFvPatchField
SourceFiles SourceFiles
turbulentMixingLengthFrequencyInletFvPatchScalarField.C turbulentMixingLengthFrequencyInletFvPatchScalarField.C

View File

@ -78,10 +78,10 @@ Description
} }
\endverbatim \endverbatim
Note Note:
If the kLowReWallFunction is employed, a velocity variant of the turbulent If the kLowReWallFunction is employed, a velocity variant of the
viscosity wall function should be used, e.g. nutUWallFunction. Turbulence turbulent viscosity wall function should be used, e.g. nutUWallFunction.
k variants (nutk...) for this case will not behave correctly. Turbulence k variants (nutk...) for this case will not behave correctly.
See also See also
Foam::RASModels::v2fBase Foam::RASModels::v2fBase

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2011-2020 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -71,7 +71,7 @@ Usage
} }
\endverbatim \endverbatim
Note Note:
The underlying \c patchType should be set to \c cyclic The underlying \c patchType should be set to \c cyclic
SourceFiles SourceFiles

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2014-2020 OpenFOAM Foundation \\ / A nd | Copyright (C) 2014-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -101,7 +101,7 @@ Usage
} }
\endverbatim \endverbatim
Note Note:
D.M. Hargreaves and N.G. Wright recommend Gamma epsilon in the D.M. Hargreaves and N.G. Wright recommend Gamma epsilon in the
k-epsilon model should be changed from 1.3 to 1.11 for consistency. k-epsilon model should be changed from 1.3 to 1.11 for consistency.
The roughness height (Er) is given by Er = 20 z0 following the same The roughness height (Er) is given by Er = 20 z0 following the same

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2011-2021 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -90,7 +90,7 @@ Usage
fields | list of fields and averaging options | yes | fields | list of fields and averaging options | yes |
\endtable \endtable
Note Note:
To employ the \c prime2Mean option, the \c mean option must be selected. To employ the \c prime2Mean option, the \c mean option must be selected.
See also See also

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2011-2021 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -128,11 +128,11 @@ Usage
areaNormalIntegrate | area weighted integral in face normal direction areaNormalIntegrate | area weighted integral in face normal direction
\endplaintable \endplaintable
Note Note:
- Faces on empty patches get ignored. - Faces on empty patches get ignored.
- The `oriented' operations will flip the sign of the field so that all the - The `oriented' operations will flip the sign of the field so that all
normals point in a consistent direction. This is only of relevance when the normals point in a consistent direction. This is only of relevance
summing mesh-oriented fields, such as the flux, on faceZones. when summing mesh-oriented fields, such as the flux, on faceZones.
- If the field is a volField then a \c faceZone can only consist of - If the field is a volField then a \c faceZone can only consist of
boundary faces, because only these faces have a value associated with boundary faces, because only these faces have a value associated with
them. No cell-to-face interpolation is performed. them. No cell-to-face interpolation is performed.

View File

@ -87,7 +87,7 @@ Usage
points | a specified set of locations points | a specified set of locations
\endplaintable \endplaintable
Note Note:
When specifying the track resolution, the \c trackLength OR \c nSubCycle When specifying the track resolution, the \c trackLength OR \c nSubCycle
option should be used option should be used

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2016-2021 OpenFOAM Foundation \\ / A nd | Copyright (C) 2016-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -51,9 +51,10 @@ Usage
region | region to be evaluated | no | default region region | region to be evaluated | no | default region
\endtable \endtable
Note Note:
Writing field 'wallHeatFlux' is done by default, but it can be overridden by Writing field 'wallHeatFlux' is done by default, but it can be
defining an empty \c objects list. For details see writeLocalObjects. overridden by defining an empty \c objects list. For details see
writeLocalObjects.
See also See also
Foam::functionObject Foam::functionObject

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2020-2021 OpenFOAM Foundation \\ / A nd | Copyright (C) 2020-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -84,7 +84,7 @@ Description
} }
\endverbatim \endverbatim
Note Note:
Writing field 'wallHeatTransferCoeff' is done by default, but it can be Writing field 'wallHeatTransferCoeff' is done by default, but it can be
overridden by defining an empty \c objects list. For details see overridden by defining an empty \c objects list. For details see
writeLocalObjects. writeLocalObjects.

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2020 OpenFOAM Foundation \\ / A nd | Copyright (C) 2020-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -75,7 +75,7 @@ Usage
Uref | Reference velocity magnitude | yes | no Uref | Reference velocity magnitude | yes | no
\endtable \endtable
Note Note:
Cp and rho are required only for incompressible flow calclulations. Cp and rho are required only for incompressible flow calclulations.
SourceFiles SourceFiles

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2020-2021 OpenFOAM Foundation \\ / A nd | Copyright (C) 2020-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -98,7 +98,7 @@ Usage
Lchar | Characteristic length | no | no Lchar | Characteristic length | no | no
\endtable \endtable
Note Note:
Cp and rho are required only for incompressible flow calclulations. Cp and rho are required only for incompressible flow calclulations.
SourceFiles SourceFiles

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2013-2021 OpenFOAM Foundation \\ / A nd | Copyright (C) 2013-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -61,9 +61,10 @@ Usage
phase | phase name | no | phase | phase name | no |
\endtable \endtable
Note Note:
Writing field 'wallShearStress' is done by default, but it can be overridden Writing field 'wallShearStress' is done by default, but it can be
by defining an empty \c objects list. For details see writeLocalObjects. overridden by defining an empty \c objects list. For details see
writeLocalObjects.
See also See also
Foam::functionObject Foam::functionObject

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2013-2021 OpenFOAM Foundation \\ / A nd | Copyright (C) 2013-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -45,7 +45,7 @@ Usage
phase | phase name | no | phase | phase name | no |
\endtable \endtable
Note Note:
Writing field 'yPlus' is done by default, but it can be overridden by Writing field 'yPlus' is done by default, but it can be overridden by
defining an empty \c objects list. For details see writeLocalObjects. defining an empty \c objects list. For details see writeLocalObjects.

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2011-2021 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License

View File

@ -68,11 +68,11 @@ Usage
endCalls | list of calls on end | yes | endCalls | list of calls on end | yes |
\endtable \endtable
Note Note:
Since this function object executes system calls, there is a potential Since this function object executes system calls, there is a potential
security risk. In order to use the \c systemCall function object, the security risk. In order to use the \c systemCall function object, the
\c allowSystemOperations must be set to '1'; otherwise, system calls will \c allowSystemOperations must be set to '1'; otherwise, system calls
not be allowed. will not be allowed.
See also See also
Foam::functionObject Foam::functionObject

View File

@ -46,9 +46,9 @@ Usage
} }
\endverbatim \endverbatim
Note Note:
The 'uniform' option allows the use of a time-varying uniform temperature The 'uniform' option allows the use of a time-varying uniform
by means of the Function1 type. temperature by means of the Function1 type.
SourceFiles SourceFiles
fixedTemperatureConstraint.C fixedTemperatureConstraint.C

View File

@ -44,7 +44,7 @@ Usage
} }
\endverbatim \endverbatim
Note Note:
Currently only handles kinematic pressure (incompressible solvers). Currently only handles kinematic pressure (incompressible solvers).
SourceFiles SourceFiles

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2015-2021 OpenFOAM Foundation \\ / A nd | Copyright (C) 2015-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -46,7 +46,7 @@ Usage
} }
\endverbatim \endverbatim
Note Note:
Currently only handles kinematic pressure (incompressible solvers). Currently only handles kinematic pressure (incompressible solvers).
SourceFiles SourceFiles

View File

@ -79,7 +79,7 @@ Usage
} }
\endverbatim \endverbatim
Note Note:
- The effectiveness Function2 is described in terms of the primary and - The effectiveness Function2 is described in terms of the primary and
secondary mass flow rates and has the same units as the secondary mass secondary mass flow rates and has the same units as the secondary mass
flow rate and kg/s for phi. flow rate and kg/s for phi.

View File

@ -54,7 +54,7 @@ Usage
} }
\endverbatim \endverbatim
Note Note:
The porous region must be selected as a cellZone. The porous region must be selected as a cellZone.
SourceFiles SourceFiles

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2011-2021 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -195,11 +195,10 @@ Description
</ol> </ol>
Note Note:
\c gpart can be found in the current search path by adding the respective \c gpart can be found in the current search path by adding the
\c bin folder from the Scotch installation, namely by running the following respective \c bin folder from the Scotch installation, namely by running
commands: the following commands:
\verbatim \verbatim
source $(foamEtcFile config.sh/scotch) source $(foamEtcFile config.sh/scotch)
export PATH=$PATH:$SCOTCH_ARCH_PATH/bin export PATH=$PATH:$SCOTCH_ARCH_PATH/bin

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2011-2020 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -28,7 +28,7 @@ Description
A list of lists. Interpolates based on the first dimension. A list of lists. Interpolates based on the first dimension.
The values must be positive and monotonically increasing in each dimension The values must be positive and monotonically increasing in each dimension
Note Note:
- Accessing an empty list results in an error. - Accessing an empty list results in an error.
- Accessing a list with a single element always returns the same value. - Accessing a list with a single element always returns the same value.

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2011-2020 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -30,7 +30,7 @@ Description
No attempt at resolving degenerate cases. Since the cut faces are No attempt at resolving degenerate cases. Since the cut faces are
usually quite ugly, they will always be triangulated. usually quite ugly, they will always be triangulated.
Note Note:
When the cutting plane coincides with a mesh face, the cell edge on the When the cutting plane coincides with a mesh face, the cell edge on the
positive side of the plane is taken. positive side of the plane is taken.

View File

@ -48,9 +48,9 @@ Usage
\kappa = 1000 - 0.05 T + 0.003 T^2 \kappa = 1000 - 0.05 T + 0.003 T^2
\f] \f]
Note Note:
Thermal conductivity polynomial coefficients evaluate to an expression in Thermal conductivity polynomial coefficients evaluate to an expression
[W/m/K]. in [W/m/K].
SourceFiles SourceFiles
polynomialSolidTransportI.H polynomialSolidTransportI.H

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2021 OpenFOAM Foundation \\ / A nd | Copyright (C) 2021-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -56,7 +56,7 @@ Usage
} }
\endverbatim \endverbatim
Note Note:
Specific heat at constant volume polynomial coefficients evaluate to an Specific heat at constant volume polynomial coefficients evaluate to an
expression in [J/kg/K]. expression in [J/kg/K].

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2011-2021 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -54,9 +54,9 @@ Usage
} }
\endverbatim \endverbatim
Note Note:
Specific heat at constant pressure polynomial coefficients evaluate to an Specific heat at constant pressure polynomial coefficients evaluate to
expression in [J/kg/K]. an expression in [J/kg/K].
SourceFiles SourceFiles
hPolynomialThermoI.H hPolynomialThermoI.H

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org \\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2011-2018 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2022 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -28,7 +28,7 @@ Description
A HashTable for two labels to another label. A HashTable for two labels to another label.
Used for e.g. for face1, face2 to shared edge. Used for e.g. for face1, face2 to shared edge.
Note Note:
The hash table is based on a FixedList and not edge, since an edge The hash table is based on a FixedList and not edge, since an edge
hashes commutatively! hashes commutatively!