polyMeshMap: New mesh to mesh map for the new mapping update function mapMesh(const polyMeshMap&)

This new mapping structure is designed to support run-time mesh-to-mesh mapping
to allow arbitrary changes to the mesh structure, for example during extreme
motion requiring significant topology change including region disconnection etc.

etc/codeTemplates/dynamicCode/codedFvModelTemplate.C

@@ -179,9 +179,22 @@ void ${typeName}FvModel${SourceType}::addSup
 }
 
 
-void ${typeName}FvModel${SourceType}::updateMesh(const polyTopoChangeMap& map)
+bool ${typeName}FvModel${SourceType}::movePoints()
 {
-    set_.updateMesh(map);
+    set_.movePoints();
+    return true;
+}
+
+
+void ${typeName}FvModel${SourceType}::topoChange(const polyTopoChangeMap& map)
+{
+    set_.topoChange(map);
+}
+
+
+void ${typeName}FvModel${SourceType}::mapMesh(const polyMeshMap& map)
+{
+    set_.mapMesh(map);
 }
 
 
@@ -194,13 +207,6 @@ void ${typeName}FvModel${SourceType}::distribute
 }
 
 
-bool ${typeName}FvModel${SourceType}::movePoints()
-{
-    set_.movePoints();
-    return true;
-}
-
-
 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
 } // End namespace Foam

etc/codeTemplates/dynamicCode/codedFvModelTemplate.H

@@ -114,14 +114,17 @@ public:
 
         // Mesh motion
 
-            //- Update for mesh changes
-            virtual void updateMesh(const polyTopoChangeMap&);
+            //- Update for mesh motion
+            virtual bool movePoints();
+
+            //- Update topology using the given map
+            virtual void topoChange(const polyTopoChangeMap&);
+
+            //- Update from another mesh using the given map
+            virtual void mapMesh(const polyMeshMap&);
 
             //- Redistribute or update using the given distribution map
             virtual void distribute(const polyDistributionMap&);
-
-            //- Update for mesh motion
-            virtual bool movePoints();
 };