ENH: lumped point motion using local linear basic functions (#1341)

- the earlier implementation of externally controlled lumped point
  motion (see merge request !120 and OpenFOAM-v1706 release notes) was
  conceived for the motion of simple structures such as buildings or
  simple beams. The motion controller was simply defined in terms of
  an orientation axis and divisions along that axis.

  To include complex structures, multiple motion controllers are
  defined in terms of support points and connectivity.

  The points can have additional node Ids associated with them, which
  makes it easier to map to/from FEA models.

  OLD system/lumpedPointMovement specification
  --------------------------------------------

      //- Reference axis for the locations
      axis            (0 0 1);

      //- Locations of the lumped points
      locations       (0 0.05 .. 0.5);

  NEW system/lumpedPointMovement specification
  --------------------------------------------

      // Locations of the lumped points
      points
      (
          (0  0  0.00)
          (0  0  0.05)
          ...
          (0  0  0.50)
      );

      //- Connectivity for motion controllers
      controllers
      {
          vertical
          {
              pointLabels (0 1 2 3 4 5 6 7 8 9 10);
          }
      }

  And the controller(s) must be associated with the given
  pointDisplacement patch. Eg,

     somePatch
     {
         type            lumpedPointDisplacement;
         value           uniform (0 0 0);
         controllers     ( vertical );   // <-- NEW
     }

TUT: adjust building motion tutorial

- use new controllor definitions
- replace building response file with executable
- add updateControl in dynamicMeshDict for slowly moving structure

applications/utilities/postProcessing/lumped/lumpedPointForces/lumpedPointForces.C

@@ -5,7 +5,7 @@
     \\  /    A nd           | www.openfoam.com
      \\/     M anipulation  |
 -------------------------------------------------------------------------------
-    Copyright (C) 2016-2017 OpenCFD Ltd.
+    Copyright (C) 2016-2020 OpenCFD Ltd.
 -------------------------------------------------------------------------------
 License
     This file is part of OpenFOAM.
@@ -27,8 +27,8 @@ Application
     lumpedPointForces
 
 Description
-    Extract force/moment information from existing calculations based
-    on the segmentation of the pressure integration zones.
+    Extract force/moment information from simulation results that
+    use the lumped points movement description.
 
 \*---------------------------------------------------------------------------*/
 
@@ -37,7 +37,7 @@ Description
 #include "timeSelector.H"
 #include "volFields.H"
 #include "IOobjectList.H"
-
+#include "foamVtkSeriesWriter.H"
 #include "lumpedPointTools.H"
 #include "lumpedPointIOMovement.H"
 
@@ -83,8 +83,8 @@ int main(int argc, char *argv[])
 {
     argList::addNote
     (
-        "Extract force/moment information from existing calculations based"
-        " on the lumpedPoints pressure zones."
+        "Extract force/moment information from simulation results that"
+        " use the lumped points movement description."
     );
 
     argList::addBoolOption
@@ -102,31 +102,33 @@ int main(int argc, char *argv[])
     const bool withVTK = args.found("vtk");
 
     #include "createTime.H"
+
     instantList timeDirs = timeSelector::select0(runTime, args);
 
     #include "createNamedMesh.H"
 
-    autoPtr<lumpedPointIOMovement> movement = lumpedPointIOMovement::New
-    (
-        runTime
-    );
+    autoPtr<lumpedPointIOMovement> movement = lumpedPointIOMovement::New(mesh);
 
-    if (!movement.valid())
+    if (!movement)
     {
-        Info<< "no valid movement given" << endl;
+        Info<< "No valid movement found" << endl;
         return 1;
     }
 
-    const labelList patchLst = lumpedPointTools::lumpedPointPatchList(mesh);
-    if (patchLst.empty())
+    const label nPatches = lumpedPointTools::setPatchControls(mesh);
+    if (!nPatches)
     {
-        Info<< "no patch list found" << endl;
+        Info<< "No point patches with lumped movement found" << endl;
         return 2;
     }
 
-    movement().setMapping(mesh, patchLst, lumpedPointTools::points0Field(mesh));
+    Info<<"Lumped point patch controls set on " << nPatches
+        << " patches" << nl;
 
+
+    vtk::seriesWriter forceSeries;
     List<vector> forces, moments;
+
     forAll(timeDirs, timei)
     {
         runTime.setTime(timeDirs[timei], timei);
@@ -164,11 +166,21 @@ int main(int argc, char *argv[])
                     forces,
                     moments
                 );
+
+                forceSeries.append(runTime.timeIndex(), outputName);
             }
         }
     }
 
-    Info<< "End\n" << endl;
+
+    // Create file series
+
+    if (forceSeries.size())
+    {
+        forceSeries.write("forces.vtp");
+    }
+
+    Info<< "\nEnd\n" << endl;
 
     return 0;
 }