Public Member Functions | Static Public Member Functions | Protected Attributes | Private Member Functions
decompositionMethod Class Referenceabstract

Abstract base class for decomposition. More...

Inheritance diagram for decompositionMethod:
Inheritance graph
[legend]
Collaboration diagram for decompositionMethod:
Collaboration graph
[legend]

Public Member Functions

 TypeName ("decompositionMethod")
 Runtime type information. More...
 
 declareRunTimeSelectionTable (autoPtr, decompositionMethod, dictionary,(const dictionary &decompositionDict),(decompositionDict))
 
 decompositionMethod (const dictionary &decompositionDict)
 Construct given the decomposition dictionary. More...
 
virtual ~decompositionMethod ()
 Destructor. More...
 
label nDomains () const
 
virtual bool parallelAware () const =0
 Is method parallel aware (i.e. does it synchronize domains across. More...
 
virtual labelList decompose (const pointField &points, const scalarField &pointWeights)
 Return for every coordinate the wanted processor number. More...
 
virtual labelList decompose (const pointField &)
 Like decompose but with uniform weights on the points. More...
 
virtual labelList decompose (const polyMesh &mesh, const pointField &points, const scalarField &pointWeights)=0
 Return for every coordinate the wanted processor number. Use the. More...
 
virtual labelList decompose (const polyMesh &, const pointField &)
 Like decompose but with uniform weights on the points. More...
 
virtual labelList decompose (const polyMesh &mesh, const labelList &cellToRegion, const pointField &regionPoints, const scalarField &regionWeights)
 Return for every coordinate the wanted processor number. Gets. More...
 
virtual labelList decompose (const polyMesh &mesh, const labelList &cellToRegion, const pointField &regionPoints)
 Like decompose but with uniform weights on the regions. More...
 
virtual labelList decompose (const labelListList &globalCellCells, const pointField &cc, const scalarField &cWeights)=0
 Return for every coordinate the wanted processor number. More...
 
virtual labelList decompose (const labelListList &globalCellCells, const pointField &cc)
 Like decompose but with uniform weights on the cells. More...
 
void setConstraints (const polyMesh &mesh, boolList &blockedFace, PtrList< labelList > &specifiedProcessorFaces, labelList &specifiedProcessor, List< labelPair > &explicitConnections)
 Helper: extract constraints: More...
 
void applyConstraints (const polyMesh &mesh, const boolList &blockedFace, const PtrList< labelList > &specifiedProcessorFaces, const labelList &specifiedProcessor, const List< labelPair > &explicitConnections, labelList &finalDecomp)
 Helper: apply constraints to a decomposition. This gives. More...
 
virtual labelList decompose (const polyMesh &mesh, const scalarField &cellWeights, const boolList &blockedFace, const PtrList< labelList > &specifiedProcessorFaces, const labelList &specifiedProcessor, const List< labelPair > &explicitConnections)
 
labelList decompose (const polyMesh &mesh, const scalarField &cWeights)
 Decompose a mesh. Apply all constraints from decomposeParDict. More...
 

Static Public Member Functions

static autoPtr< decompositionMethodNew (const dictionary &decompositionDict)
 Return a reference to the selected decomposition method. More...
 
static void calcCellCells (const polyMesh &mesh, const labelList &agglom, const label nLocalCoarse, const bool global, CompactListList< label > &cellCells)
 Helper: determine (local or global) cellCells from mesh. More...
 
static void calcCellCells (const polyMesh &mesh, const labelList &agglom, const label nLocalCoarse, const bool parallel, CompactListList< label > &cellCells, CompactListList< scalar > &cellCellWeights)
 Helper: determine (local or global) cellCells and face weights. More...
 

Protected Attributes

const dictionarydecompositionDict_
 
label nProcessors_
 
PtrList< decompositionConstraintconstraints_
 Optional constraints. More...
 

Private Member Functions

 decompositionMethod (const decompositionMethod &)
 Disallow default bitwise copy construct and assignment. More...
 
void operator= (const decompositionMethod &)
 

Detailed Description

Abstract base class for decomposition.

Source files

Definition at line 48 of file decompositionMethod.H.

Constructor & Destructor Documentation

◆ decompositionMethod() [1/2]

Disallow default bitwise copy construct and assignment.

◆ decompositionMethod() [2/2]

decompositionMethod ( const dictionary decompositionDict)

Construct given the decomposition dictionary.

Definition at line 55 of file decompositionMethod.C.

References List::append(), dict, Foam::findIndex(), forAllConstIter(), Foam::compressible::New(), and dictionary::subDict().

Here is the call graph for this function:

◆ ~decompositionMethod()

virtual ~decompositionMethod ( )
inlinevirtual

Destructor.

Definition at line 106 of file decompositionMethod.H.

Member Function Documentation

◆ operator=()

void operator= ( const decompositionMethod )
private

◆ TypeName()

TypeName ( "decompositionMethod"  )

Runtime type information.

◆ declareRunTimeSelectionTable()

declareRunTimeSelectionTable ( autoPtr  ,
decompositionMethod  ,
dictionary  ,
(const dictionary &decompositionDict)  ,
(decompositionDict)   
)

◆ New()

Foam::autoPtr< Foam::decompositionMethod > New ( const dictionary decompositionDict)
static

Return a reference to the selected decomposition method.

Definition at line 179 of file decompositionMethod.C.

References Foam::endl(), Foam::exit(), Foam::FatalError, FatalErrorInFunction, Foam::Info, dictionary::lookup(), and Foam::nl.

Referenced by decompositionModel::decomposer(), distributedTriSurfaceMesh::independentlyDistributedBbs(), main(), multiLevelDecomp::multiLevelDecomp(), and structuredDecomp::structuredDecomp().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ nDomains()

label nDomains ( ) const
inline

Definition at line 112 of file decompositionMethod.H.

References decompositionMethod::nProcessors_.

Referenced by determineDecomposition(), multiLevelDecomp::multiLevelDecomp(), and structuredDecomp::structuredDecomp().

Here is the caller graph for this function:

◆ parallelAware()

virtual bool parallelAware ( ) const
pure virtual

Is method parallel aware (i.e. does it synchronize domains across.

proc boundaries)

Implemented in hierarchGeomDecomp, multiLevelDecomp, ptscotchDecomp, scotchDecomp, simpleGeomDecomp, structuredDecomp, metisDecomp, manualDecomp, and noDecomp.

Referenced by determineDecomposition(), and main().

Here is the caller graph for this function:

◆ decompose() [1/10]

virtual labelList decompose ( const pointField points,
const scalarField pointWeights 
)
inlinevirtual

Return for every coordinate the wanted processor number.

Reimplemented in geomDecomp, hierarchGeomDecomp, and simpleGeomDecomp.

Definition at line 126 of file decompositionMethod.H.

References NotImplemented.

Referenced by meshRefinement::balance(), determineDecomposition(), and domainDecomposition::distributeCells().

Here is the caller graph for this function:

◆ decompose() [2/10]

virtual labelList decompose ( const pointField )
inlinevirtual

Like decompose but with uniform weights on the points.

Reimplemented in geomDecomp, hierarchGeomDecomp, and simpleGeomDecomp.

Definition at line 136 of file decompositionMethod.H.

References NotImplemented.

◆ decompose() [3/10]

virtual labelList decompose ( const polyMesh mesh,
const pointField points,
const scalarField pointWeights 
)
pure virtual

Return for every coordinate the wanted processor number. Use the.

mesh connectivity (if needed)

Implemented in ptscotchDecomp, multiLevelDecomp, scotchDecomp, metisDecomp, structuredDecomp, hierarchGeomDecomp, manualDecomp, noDecomp, and simpleGeomDecomp.

◆ decompose() [4/10]

Foam::labelList decompose ( const polyMesh mesh,
const pointField points 
)
virtual

Like decompose but with uniform weights on the points.

Reimplemented in hierarchGeomDecomp, and simpleGeomDecomp.

Definition at line 205 of file decompositionMethod.C.

References mesh, and points.

◆ decompose() [5/10]

Foam::labelList decompose ( const polyMesh mesh,
const labelList cellToRegion,
const pointField regionPoints,
const scalarField regionWeights 
)
virtual

Return for every coordinate the wanted processor number. Gets.

passed agglomeration map (from fine to coarse cells) and coarse cell location. Can be overridden by decomposers that provide this functionality natively. Coarse cells are local to the processor (if in parallel). If you want to have coarse cells spanning processors use the globalCellCells instead.

Reimplemented in ptscotchDecomp, scotchDecomp, and metisDecomp.

Definition at line 217 of file decompositionMethod.C.

References forAll, mesh, and List::size().

Here is the call graph for this function:

◆ decompose() [6/10]

Foam::labelList decompose ( const polyMesh mesh,
const labelList cellToRegion,
const pointField regionPoints 
)
virtual

Like decompose but with uniform weights on the regions.

Definition at line 258 of file decompositionMethod.C.

References mesh.

◆ decompose() [7/10]

virtual labelList decompose ( const labelListList globalCellCells,
const pointField cc,
const scalarField cWeights 
)
pure virtual

Return for every coordinate the wanted processor number.

The connectivity is equal to mesh.cellCells() except for

  • in parallel the cell numbers are global cell numbers (starting from 0 at processor0 and then incrementing all through the processors)
  • the connections are across coupled patches

Implemented in hierarchGeomDecomp, ptscotchDecomp, scotchDecomp, metisDecomp, multiLevelDecomp, simpleGeomDecomp, manualDecomp, noDecomp, and structuredDecomp.

◆ decompose() [8/10]

Foam::labelList decompose ( const labelListList globalCellCells,
const pointField cc 
)
virtual

Like decompose but with uniform weights on the cells.

Reimplemented in hierarchGeomDecomp.

Definition at line 277 of file decompositionMethod.C.

◆ calcCellCells() [1/2]

void calcCellCells ( const polyMesh mesh,
const labelList agglom,
const label  nLocalCoarse,
const bool  global,
CompactListList< label > &  cellCells 
)
static

Helper: determine (local or global) cellCells from mesh.

agglomeration. Agglomeration is local to the processor. local : connections are in local indices. Coupled across cyclics but not processor patches. global : connections are in global indices. Coupled across cyclics and processor patches.

Definition at line 289 of file decompositionMethod.C.

References HashTable::clear(), polyPatch::coupled(), forAll, HashSet< Key, Hash >::insert(), globalIndex::isLocal(), CompactListList::m(), mesh, CompactListList::offsets(), patches, CompactListList::setSize(), List::setSize(), CompactListList::size(), polyPatch::start(), globalIndex::toGlobal(), and globalIndex::toLocal().

Referenced by CuthillMcKeeRenumber::renumber(), and springRenumber::renumber().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ calcCellCells() [2/2]

void calcCellCells ( const polyMesh mesh,
const labelList agglom,
const label  nLocalCoarse,
const bool  parallel,
CompactListList< label > &  cellCells,
CompactListList< scalar > &  cellCellWeights 
)
static

Helper: determine (local or global) cellCells and face weights.

from mesh agglomeration. Uses mag of faceArea as weights

Definition at line 494 of file decompositionMethod.C.

References HashTable::clear(), polyPatch::coupled(), forAll, HashSet< Key, Hash >::insert(), globalIndex::isLocal(), CompactListList::m(), Foam::mag(), mesh, CompactListList::offsets(), patches, CompactListList::setSize(), List::setSize(), CompactListList::size(), polyPatch::start(), globalIndex::toGlobal(), globalIndex::toLocal(), and w().

Here is the call graph for this function:

◆ setConstraints()

void setConstraints ( const polyMesh mesh,
boolList blockedFace,
PtrList< labelList > &  specifiedProcessorFaces,
labelList specifiedProcessor,
List< labelPair > &  explicitConnections 
)

Helper: extract constraints:

blockedface: existing faces where owner and neighbour on same proc explicitConnections: sets of boundary faces ,, ,, specifiedProcessorFaces: groups of faces with all cells on same processor.

Definition at line 1421 of file decompositionMethod.C.

References List::clear(), PtrList::clear(), forAll, mesh, and List::setSize().

Referenced by meshRefinement::balance().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ applyConstraints()

void applyConstraints ( const polyMesh mesh,
const boolList blockedFace,
const PtrList< labelList > &  specifiedProcessorFaces,
const labelList specifiedProcessor,
const List< labelPair > &  explicitConnections,
labelList finalDecomp 
)

Helper: apply constraints to a decomposition. This gives.

constraints opportunity to modify decomposition in case the native decomposition method has not obeyed all constraints

Definition at line 1450 of file decompositionMethod.C.

References forAll, and mesh.

◆ decompose() [9/10]

Foam::labelList decompose ( const polyMesh mesh,
const scalarField cellWeights,
const boolList blockedFace,
const PtrList< labelList > &  specifiedProcessorFaces,
const labelList specifiedProcessor,
const List< labelPair > &  explicitConnections 
)
virtual
Parameters
blockedFaceWhether owner and neighbour should be on same processor (takes priority over explicitConnections)
specifiedProcessorFacesWhether whole sets of faces (and point neighbours) need to be kept on single processor
explicitConnectionsAdditional connections between boundary faces

Definition at line 1073 of file decompositionMethod.C.

References polyPatch::coupled(), FaceCellWave< Type, TrackingData >::data(), Foam::endl(), Foam::exit(), f(), f1, Foam::FatalError, FatalErrorInFunction, Pair::first(), forAll, Foam::Info, Foam::max(), mesh, patchIdentifier::name(), regionSplit::nLocalRegions(), patches, pFaces, Foam::reduce(), Foam::returnReduce(), Pair::second(), List::size(), PtrList::size(), and polyPatch::start().

Here is the call graph for this function:

◆ decompose() [10/10]

Foam::labelList decompose ( const polyMesh mesh,
const scalarField cWeights 
)

Decompose a mesh. Apply all constraints from decomposeParDict.

('preserveFaceZones' etc). Calls either

  • no constraints, empty weights: decompose(mesh, cellCentres())
  • no constraints, set weights: decompose(mesh, cellCentres(), cellWeights)
  • valid constraints: decompose(mesh, cellToRegion, regionPoints, regionWeights)

Definition at line 1475 of file decompositionMethod.C.

References mesh.

Field Documentation

◆ decompositionDict_

const dictionary& decompositionDict_
protected

Definition at line 55 of file decompositionMethod.H.

Referenced by hierarchGeomDecomp::setDecompOrder().

◆ nProcessors_

label nProcessors_
protected

Definition at line 56 of file decompositionMethod.H.

Referenced by decompositionMethod::nDomains().

◆ constraints_

PtrList<decompositionConstraint> constraints_
protected

Optional constraints.

Definition at line 59 of file decompositionMethod.H.


The documentation for this class was generated from the following files: