Lagrangian: Added support for automatic run-time load-balancing

Optional CPU load caching can be switched-on for Lagrangian cloud tracking
and/or chemistry integration using the new cpuLoad switch in the cloudProperties
or chemistryProperties dictionary files respectively and used for
multi-constraint load-balancing by the fvMeshDistributorsLoadBalancer specified
in the dynamicMeshDict file

distributor
{
    type            loadBalancer;

    libs            ("libfvMeshDistributors.so");

    multiConstraint true;
    redistributionInterval  10;
}

which used the distributor specified in the decomposeParDict file, e.g.

numberOfSubdomains 12;

decomposer      simple;
distributor     zoltan;
libs            ("libzoltanDecomp.so");

simpleCoeffs
{
    n           (2 2 3);
}

zoltanCoeffs
{
    lb_method   rcb;
}

The incompressibleDenseParticleFluid/cyclone case has been updated to
demonstrate this new functionality and shows a speedup ~50% using the Zoltan RCB
multi-constraint distributor.  The multicomponentFluid/counterFlowFlame2D_GRI
case has also been updated to use the new cpuLoad switch.

tutorials/incompressibleDenseParticleFluid/cyclone/0/U.air

@@ -20,6 +20,8 @@ internalField   uniform (0 0 0);
 
 boundaryField
 {
+    #includeEtc "caseDicts/setConstraintTypes"
+
     inlet
     {
         type            fixedValue;

tutorials/incompressibleDenseParticleFluid/cyclone/0/k.air

@@ -19,6 +19,8 @@ internalField       uniform 1;
 
 boundaryField
 {
+    #includeEtc "caseDicts/setConstraintTypes"
+
     inlet
     {
         type            fixedValue;

tutorials/incompressibleDenseParticleFluid/cyclone/0/nut.air

@@ -19,6 +19,8 @@ internalField       uniform 0;
 
 boundaryField
 {
+    #includeEtc "caseDicts/setConstraintTypes"
+
     inlet
     {
         type            calculated;

tutorials/incompressibleDenseParticleFluid/cyclone/0/p

@@ -19,6 +19,8 @@ internalField   uniform 0;
 
 boundaryField
 {
+    #includeEtc "caseDicts/setConstraintTypes"
+
     inlet
     {
         type fixedFluxPressure;

tutorials/incompressibleDenseParticleFluid/cyclone/constant/cloudProperties

@@ -16,6 +16,8 @@ FoamFile
 
 type        MPPICCloud;
 
+cpuLoad     true;
+
 solution
 {
     coupled         true;

tutorials/incompressibleDenseParticleFluid/cyclone/constant/dynamicMeshDict

@@ -0,0 +1,27 @@
+/*--------------------------------*- C++ -*----------------------------------*\
+  =========                 |
+  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
+   \\    /   O peration     | Website:  https://openfoam.org
+    \\  /    A nd           | Version:  dev
+     \\/     M anipulation  |
+\*---------------------------------------------------------------------------*/
+FoamFile
+{
+    format      ascii;
+    class       dictionary;
+    object      dynamicMeshDict;
+}
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+distributor
+{
+    type            loadBalancer;
+
+    libs            ("libfvMeshDistributors.so");
+
+    multiConstraint true;
+    redistributionInterval  10;
+}
+
+
+// ************************************************************************* //

tutorials/incompressibleDenseParticleFluid/cyclone/system/blockMeshDict

@@ -58,6 +58,12 @@ boundary
             (4 5 6 7)
         );
     }
+
+    internalFaces
+    {
+        type internal;
+        faces ();
+    }
 );
 
 // ************************************************************************* //

tutorials/incompressibleDenseParticleFluid/cyclone/system/controlDict

@@ -18,7 +18,7 @@ application     foamRun;
 
 solver          incompressibleDenseParticleFluid;
 
-startFrom       latestTime;
+startFrom       startTime;
 
 startTime       0;
 

tutorials/incompressibleDenseParticleFluid/cyclone/system/decomposeParDict

@@ -16,11 +16,25 @@ FoamFile
 
 numberOfSubdomains 12;
 
-method          simple;
+decomposer      simple;
+distributor     zoltan;
+libs            ("libzoltanDecomp.so");
 
 simpleCoeffs
 {
-    n               (2 2 3);
+    n           (2 2 3);
 }
 
+hierarchicalCoeffs
+{
+    n           (2 2 3);
+    order       xyz;
+}
+
+zoltanCoeffs
+{
+    lb_method   rcb;
+}
+
+
 // ************************************************************************* //