Doxygen: Updated lists in member documentation to conform to Doxygen limitations

This commit is contained in:
Henry
2011-02-08 12:28:13 +00:00
parent 3c56a952bc
commit 67a2effece
25 changed files with 69 additions and 57 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 | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -90,7 +90,8 @@ fileName cwd();
// else return false // else return false
bool chDir(const fileName& dir); bool chDir(const fileName& dir);
//- Search for @em name in the following hierarchy: //- Search for @em name
// in the following hierarchy:
// -# personal settings: // -# personal settings:
// - ~/.OpenFOAM/\<VERSION\>/ // - ~/.OpenFOAM/\<VERSION\>/
// <em>for version-specific files</em> // <em>for version-specific files</em>

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -122,6 +122,7 @@ public:
inline linePointRef line(const pointField&) const; inline linePointRef line(const pointField&) const;
//- compare edges //- compare edges
// Returns:
// - 0: different // - 0: different
// - +1: identical // - +1: identical
// - -1: same edge, but different orientation // - -1: same edge, but different orientation

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -307,6 +307,7 @@ public:
inline edge faceEdge(const label n) const; inline edge faceEdge(const label n) const;
//- Return the edge direction on the face //- Return the edge direction on the face
// Returns:
// - 0: edge not found on the face // - 0: edge not found on the face
// - +1: forward (counter-clockwise) on the face // - +1: forward (counter-clockwise) on the face
// - -1: reverse (clockwise) on the face // - -1: reverse (clockwise) on the face

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -201,12 +201,14 @@ public:
inline edge faceEdge(const label n) const; inline edge faceEdge(const label n) const;
//- Return the edge direction on the face //- Return the edge direction on the face
// Returns:
// - +1: forward (counter-clockwise) on the face // - +1: forward (counter-clockwise) on the face
// - -1: reverse (clockwise) on the face // - -1: reverse (clockwise) on the face
// - 0: edge not found on the face // - 0: edge not found on the face
inline int edgeDirection(const edge&) const; inline int edgeDirection(const edge&) const;
//- compare triFaces //- compare triFaces
// Returns:
// - 0: different // - 0: different
// - +1: identical // - +1: identical
// - -1: same face, but different orientation // - -1: same face, but different orientation

View File

@ -509,7 +509,8 @@ public:
// Other // Other
//- Helper for merging mesh point data. Determines //- Helper for merging mesh point data.
// Determines:
// - my unique indices // - my unique indices
// - global numbering over all unique indices // - global numbering over all unique indices
// - the global number for all local points (so this will // - the global number for all local points (so this will
@ -520,7 +521,8 @@ public:
labelList& uniquePoints labelList& uniquePoints
) const; ) const;
//- Helper for merging patch point data. Takes maps from //- Helper for merging patch point data.
// Takes maps from:
// local points to/from mesh. Determines // local points to/from mesh. Determines
// - my unique points. These are mesh points, not patch points // - my unique points. These are mesh points, not patch points
// since the master might not be on the patch. // since the master might not be on the patch.

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -415,6 +415,7 @@ public:
// Check // Check
//- Calculate surface type formed by patch. //- Calculate surface type formed by patch.
// Types:
// - all edges have two neighbours (manifold) // - all edges have two neighbours (manifold)
// - some edges have more than two neighbours (illegal) // - some edges have more than two neighbours (illegal)
// - other (open) // - other (open)

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -134,7 +134,8 @@ public:
} }
//- compare Pairs //- Compare Pairs
// Returning:
// - 0: different // - 0: different
// - +1: identical // - +1: identical
// - -1: same pair, but reversed order // - -1: same pair, but reversed order

View File

@ -65,9 +65,10 @@ public:
// Public classes // Public classes
//- Less function class used in sorting encoded transforms and indices //- Less function class used in sorting encoded transforms and indices
// - minimum processor // Minimum of:
// - minimum local index // - processor
// - minimum transform // - local index
// - transform
class less class less
{ {
public: public:

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -281,7 +281,8 @@ public:
// Point merging // Point merging
//- Find topologically&geometrically shared points. //- Find topologically and geometrically shared points.
//
// - should only be called for parallel correct mesh // - should only be called for parallel correct mesh
// (since uses mesh.globalData) // (since uses mesh.globalData)
// - returns Map from point to master point (all in mesh point // - returns Map from point to master point (all in mesh point
@ -293,6 +294,7 @@ public:
); );
//- Helper: Merge points. //- Helper: Merge points.
//
// - Gets map from point to destination point // - Gets map from point to destination point
// - Removes all points that don't map to themselves // - Removes all points that don't map to themselves
// - Modifies all faces that use the points to be removed. // - Modifies all faces that use the points to be removed.

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -382,6 +382,7 @@ public:
) const; ) const;
//- Like consistentRefinement but slower: //- Like consistentRefinement but slower:
//
// - specify number of cells between consecutive refinement levels // - specify number of cells between consecutive refinement levels
// (consistentRefinement equivalent to 1) // (consistentRefinement equivalent to 1)
// - specify max level difference between point-connected cells. // - specify max level difference between point-connected cells.

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -36,14 +36,11 @@ License
namespace Foam namespace Foam
{ {
defineTypeNameAndDebug(removeCells, 0); defineTypeNameAndDebug(removeCells, 0);
} }
// * * * * * * * * * * * * * Private Member Functions * * * * * * * * * * * // // * * * * * * * * * * * * * Private Member Functions * * * * * * * * * * * //
// Remove count of elements of f.
void Foam::removeCells::uncount void Foam::removeCells::uncount
( (
const labelList& f, const labelList& f,
@ -59,7 +56,6 @@ void Foam::removeCells::uncount
// * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * // // * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * //
// Construct from mesh
Foam::removeCells::removeCells Foam::removeCells::removeCells
( (
const polyMesh& mesh, const polyMesh& mesh,
@ -73,10 +69,6 @@ Foam::removeCells::removeCells
// * * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * // // * * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * //
//- Get labels of exposed faces. These are
// - internal faces that become boundary faces
// - coupled faces that become uncoupled (since on of the sides
// gets deleted)
Foam::labelList Foam::removeCells::getExposedFaces Foam::labelList Foam::removeCells::getExposedFaces
( (
const labelList& cellLabels const labelList& cellLabels

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -94,7 +94,8 @@ public:
// Topology changes // Topology changes
//- Get labels of exposed faces. These are //- Get labels of exposed faces.
// These are
// - internal faces that become boundary faces // - internal faces that become boundary faces
// - coupled faces that become uncoupled (since one of the sides // - coupled faces that become uncoupled (since one of the sides
// gets deleted) // gets deleted)
@ -114,7 +115,6 @@ public:
//- Force recalculation of locally stored data on topological change //- Force recalculation of locally stored data on topological change
void updateMesh(const mapPolyMesh&) void updateMesh(const mapPolyMesh&)
{} {}
}; };

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -178,7 +178,8 @@ public:
// Member Functions // Member Functions
//- Given set of faces to pierce calculates: //- Find faces including those with cells which have the same mastercell
// Given set of faces to pierce calculates:
// - region for connected cells // - region for connected cells
// - mastercell for each region. This is the lowest numbered cell // - mastercell for each region. This is the lowest numbered cell
// of all cells that get merged. // of all cells that get merged.

View File

@ -26,7 +26,6 @@ Class
Description Description
Cone injection Cone injection
- User specifies - User specifies
- time of start of injection - time of start of injection
- injector position - injector position

View File

@ -26,7 +26,6 @@ Class
Description Description
Cone injection multi-point Cone injection multi-point
- User specifies - User specifies
- time of start of injection - time of start of injection
- injector positions - injector positions

View File

@ -26,7 +26,6 @@ Class
Description Description
Manual injection Manual injection
- User specifies - User specifies
- Total mass to inject - Total mass to inject
- Parcel positions in file @c positionsFile - Parcel positions in file @c positionsFile

View File

@ -26,7 +26,6 @@ Class
Description Description
Patch injection Patch injection
- User specifies - User specifies
- Total mass to inject - Total mass to inject
- Name of patch - Name of patch

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -130,18 +130,21 @@ public:
inline label end() const; inline label end() const;
//- Compare the given start and end points with this curve //- Compare the given start and end points with this curve
// Return:
// - 0: different // - 0: different
// - +1: identical // - +1: identical
// - -1: same edge, but different orientation // - -1: same edge, but different orientation
inline int compare(const curvedEdge&) const; inline int compare(const curvedEdge&) const;
//- Compare the given start and end points with this curve //- Compare the given start and end points with this curve
// Return:
// - 0: different // - 0: different
// - +1: identical // - +1: identical
// - -1: same edge, but different orientation // - -1: same edge, but different orientation
inline int compare(const edge&) const; inline int compare(const edge&) const;
//- Compare the given start and end points with this curve //- Compare the given start and end points with this curve
// Return:
// - 0: different // - 0: different
// - +1: identical // - +1: identical
// - -1: same edge, but different orientation // - -1: same edge, but different orientation
@ -159,6 +162,7 @@ public:
void operator=(const curvedEdge&); void operator=(const curvedEdge&);
// Ostream operator // Ostream operator
friend Ostream& operator<<(Ostream&, const curvedEdge&); friend Ostream& operator<<(Ostream&, const curvedEdge&);

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -107,6 +107,7 @@ public:
//- Helper class for finding nearest //- Helper class for finding nearest
// Nearest:
// - point+local index // - point+local index
// - sqr(distance) // - sqr(distance)
// - processor // - processor

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -511,7 +511,8 @@ public:
// Queries // Queries
//- Calculate nearest point on nearest shape. Returns //- Calculate nearest point on nearest shape.
// Returns
// - bool : any point found nearer than nearestDistSqr // - bool : any point found nearer than nearestDistSqr
// - label: index in shapes // - label: index in shapes
// - point: actual nearest point found // - point: actual nearest point found
@ -532,7 +533,8 @@ public:
point& nearestPoint point& nearestPoint
) const; ) const;
//- Find nearest to line. Returns //- Find nearest to line.
// Returns
// - bool : any point found? // - bool : any point found?
// - label: index in shapes // - label: index in shapes
// - point: actual nearest point found // - point: actual nearest point found
@ -621,10 +623,10 @@ public:
bool write(Ostream& os) const; bool write(Ostream& os) const;
// IOstream Operators // IOstream Operators
friend Ostream& operator<< <Type>(Ostream&, const indexedOctree<Type>&); friend Ostream& operator<< <Type>(Ostream&, const indexedOctree<Type>&);
}; };

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -195,6 +195,7 @@ public:
bool pointInCell(const point& p, const label celli) const; bool pointInCell(const point& p, const label celli) const;
//- Find nearest cell in terms of cell centre. //- Find nearest cell in terms of cell centre.
// Options:
// - use octree // - use octree
// - use linear search // - use linear search
// - if seed is provided walk. (uses findNearestCellWalk; // - if seed is provided walk. (uses findNearestCellWalk;

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -131,7 +131,8 @@ public:
// Single point queries. // Single point queries.
//- Calculate nearest point on surface. Returns //- Calculate nearest point on surface.
// Returns
// - bool : any point found nearer than nearestDistSqr // - bool : any point found nearer than nearestDistSqr
// - label: relevant index in surface (=face 0..5) // - label: relevant index in surface (=face 0..5)
// - point: actual nearest point found // - point: actual nearest point found
@ -141,7 +142,8 @@ public:
const scalar nearestDistSqr const scalar nearestDistSqr
) const; ) const;
//- Calculate nearest point on edge. Returns //- Calculate nearest point on edge.
// Returns
// - bool : any point found nearer than nearestDistSqr // - bool : any point found nearer than nearestDistSqr
// - label: relevant index in surface(=?) // - label: relevant index in surface(=?)
// - point: actual nearest point found // - point: actual nearest point found
@ -151,7 +153,8 @@ public:
const scalar nearestDistSqr const scalar nearestDistSqr
) const; ) const;
//- Find nearest to segment. Returns //- Find nearest to segment.
// Returns
// - bool : any point found? // - bool : any point found?
// - label: relevant index in shapes (=face 0..5) // - label: relevant index in shapes (=face 0..5)
// - point: actual nearest point found // - point: actual nearest point found
@ -241,7 +244,6 @@ public:
notImplemented("searchableBox::writeData(Ostream&) const"); notImplemented("searchableBox::writeData(Ostream&) const");
return false; return false;
} }
}; };

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -26,7 +26,6 @@ Class
Description Description
Contains information about location on a triSurface: Contains information about location on a triSurface:
- pointIndexHit: - pointIndexHit:
- location - location
- bool: hit/miss - bool: hit/miss

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd. \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -518,8 +518,7 @@ public:
// Tracking // Tracking
//- Test point on plane of triangle to see if on edge or point //- Test point on plane of triangle to see if on edge or point or inside
// or inside.
static surfaceLocation classify static surfaceLocation classify
( (
const triSurface&, const triSurface&,
@ -527,7 +526,8 @@ public:
const point& trianglePoint const point& trianglePoint
); );
//- Track on surface to get closer to point. Possible situations: //- Track on surface to get closer to point.
// Possible situations:
// - 1. reached endpoint // - 1. reached endpoint
// - 2. reached edge (normal situation) // - 2. reached edge (normal situation)
// - 3. reached end of surface (edge on single face) // - 3. reached end of surface (edge on single face)

View File

@ -56,6 +56,7 @@ namespace Foam
//- Private class for finding nearest //- Private class for finding nearest
// Comprising:
// - global index // - global index
// - sqr(distance) // - sqr(distance)
typedef Tuple2<scalar, label> nearInfo; typedef Tuple2<scalar, label> nearInfo;