Merge branch 'feature-functionObjects' into 'develop'

Feature function objects

Lots of code migrated from internal development line, code tidying and a few fixes

Updated objects
- corrected Peclet number for compressible cases
- propagated log flag and resultName across objects

New function objects
- new fluxSummary:
  - calculates positive, negative, absolute and net flux across face
    zones
- new runTimeControl
  - abort the calculation when a user-defined metric is achieved.
    Available options include:
    - average value remains unchanged wrt a given threshold
    - equation initial residual exceeds a threshold - useful to abort
      diverging cases
    - equation max iterations exceeds a threshold - useful to abort
      diverging cases
    - min/max of a function object value
    - min time step exceeds a threshold - useful to abort diverging
      cases
- new valueAverage:
  - average singular values from other function objects, e.g. Cd, Cl and
    Cm from the forceCoeffs function object


See merge request !12

src/sampling/sampledSurface/writers/boundaryData/boundaryDataSurfaceWriter.H

@@ -27,30 +27,32 @@ Class
 Description
     A surfaceWriter for outputting to a form useable for the
     timeVaryingMapped boundary condition. This reads the data from
-    constant/boundaryData/<patch>
+    constant/boundaryData/\<patch\> directory
 
     Typical way of working:
     - use a sampledSurface of type 'patch' (to sample a patch):
+    \verbatim
+    surfaces
+    {
+        type            surfaces;
+        surfaceFormat   boundaryData;
+        fields          ( p );
         surfaces
-        {
-            type            surfaces;
-            surfaceFormat   boundaryData;
-            fields          ( p );
-            surfaces
-            (
-                outlet
-                {
-                    type            patch;
-                    patches         (outlet);
-                    interpolate     false;
-                }
-            );
-        }
+        (
+            outlet
+            {
+                type            patch;
+                patches         (outlet);
+                interpolate     false;
+            }
+        );
+    }
+    \endverbatim
 
     - write using this writer.
     - move postProcessing/surfaces/outlet to constant/boundaryData/outlet
       in your destination case.
-    - use a timeVaryingMappedFixedValue bc to read&interpolate
+    - use a timeVaryingMappedFixedValue condition to read and interpolate
       the profile:
         type            timeVaryingMappedFixedValue;
         setAverage      false;  // do not use read average