bf5f056296
Basic support is now provided for dynamic mesh redistribution, particularly for
load-balancing. The mesh distributor is selected in the optional 'distributor'
entry in dynamicMeshDict, for example in the
multiphase/interFoam/RAS/floatingObject tutorial case when run in parallel using
the new Allrun-parallel script
distributor
{
type decomposer;
libs ("libfvMeshDistributors.so");
redistributionInterval 10;
}
in which the 'decomposer' form of redistribution is selected to call the mesh
decomposition method specified in decomposeParDict to re-decompose the mesh for
redistribution. The redistributionInterval entry specifies how frequently mesh
redistribution takes place, in the above every 10th time-step. An optional
maxImbalance entry is also provided to control redistribution based on the cell
distribution imbalance:
Class
Foam::fvMeshDistributor::decomposer
Description
Dynamic mesh redistribution using the decomposer
Usage
Example of single field based refinement in all cells:
\verbatim
distributor
{
type decomposer;
libs ("libfvMeshDistributors.so");
// How often to redistribute
redistributionInterval 10;
// Maximum fractional cell distribution imbalance
// before rebalancing
maxImbalance 0.1;
}
\endverbatim
Currently mesh refinement/unrefinement and motion with redistribution is
supported but many aspects of OpenFOAM are not yet and will require further
development, in particular fvModels and Lagrangian.
Also only the geometry-based simple and hierarchical decomposition method are
well behaved for redistribution, scotch and ptScotch cause dramatic changes in
mesh distribution with a corresponding heavy communications overhead limiting
their usefulness or at least the frequency with which they should be called to
redistribute the mesh.
149 lines
4.0 KiB
C++
149 lines
4.0 KiB
C++
/*---------------------------------------------------------------------------*\
|
|
========= |
|
|
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
|
|
\\ / O peration | Website: https://openfoam.org
|
|
\\ / A nd | Copyright (C) 2021 OpenFOAM Foundation
|
|
\\/ M anipulation |
|
|
-------------------------------------------------------------------------------
|
|
License
|
|
This file is part of OpenFOAM.
|
|
|
|
OpenFOAM is free software: you can redistribute it and/or modify it
|
|
under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
|
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
Class
|
|
Foam::fvMeshDistributor::decomposer
|
|
|
|
Description
|
|
Dynamic mesh redistribution using the decomposer
|
|
|
|
Usage
|
|
Example of single field based refinement in all cells:
|
|
\verbatim
|
|
distributor
|
|
{
|
|
type decomposer;
|
|
|
|
libs ("libfvMeshDistributors.so");
|
|
|
|
// How often to redistribute
|
|
redistributionInterval 10;
|
|
|
|
// Maximum fractional cell distribution imbalance
|
|
// before rebalancing
|
|
maxImbalance 0.1;
|
|
}
|
|
\endverbatim
|
|
|
|
SourceFiles
|
|
fvMeshDistributorDecomposer.C
|
|
|
|
\*---------------------------------------------------------------------------*/
|
|
|
|
#ifndef fvMeshDistributorDecomposer_H
|
|
#define fvMeshDistributorDecomposer_H
|
|
|
|
#include "fvMeshDistributor.H"
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
namespace Foam
|
|
{
|
|
namespace fvMeshDistributors
|
|
{
|
|
|
|
/*---------------------------------------------------------------------------*\
|
|
Class decomposer Declaration
|
|
\*---------------------------------------------------------------------------*/
|
|
|
|
class decomposer
|
|
:
|
|
public fvMeshDistributor
|
|
{
|
|
// Private Member Data
|
|
|
|
//- Time-step interval between redistribution calls
|
|
label redistributionInterval_;
|
|
|
|
//- Maximum imbalance between the ideal number of cells per processor
|
|
// and the maximum or minimum as a ratio mag(1 - nCells/idealNcells)
|
|
scalar maxImbalance_;
|
|
|
|
//- The time index used for updating
|
|
label timeIndex_;
|
|
|
|
|
|
// Private Member Functions
|
|
|
|
//- Read the projection parameters from dictionary
|
|
void readDict();
|
|
|
|
//- Re-decompose the mesh for redistribution
|
|
void redecompose();
|
|
|
|
|
|
public:
|
|
|
|
//- Runtime type information
|
|
TypeName("decomposer");
|
|
|
|
|
|
// Constructors
|
|
|
|
//- Construct from fvMesh
|
|
explicit decomposer(fvMesh& mesh);
|
|
|
|
//- Disallow default bitwise copy construction
|
|
decomposer(const decomposer&) = delete;
|
|
|
|
|
|
//- Destructor
|
|
virtual ~decomposer();
|
|
|
|
|
|
// Member Functions
|
|
|
|
//- Distribute the mesh
|
|
virtual bool update();
|
|
|
|
//- Update corresponding to the given map
|
|
virtual void updateMesh(const mapPolyMesh&);
|
|
|
|
//- Update corresponding to the given distribution map
|
|
virtual void distribute(const mapDistributePolyMesh&);
|
|
|
|
|
|
// Writing
|
|
|
|
//- Write using given format, version and compression
|
|
virtual bool write(const bool write = true) const;
|
|
|
|
|
|
// Member Operators
|
|
|
|
//- Disallow default bitwise assignment
|
|
void operator=(const decomposer&) = delete;
|
|
};
|
|
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
} // End namespace fvMeshDistributors
|
|
} // End namespace Foam
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
#endif
|
|
|
|
// ************************************************************************* //
|