flowRateFaceZone: faceZone configuration for the surfaceFieldValue functionObject

etc/caseDicts/postProcessing/flowRate/flowRateFaceZone

+/*--------------------------------*- C++ -*----------------------------------*\
+  =========                 |
+  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
+   \\    /   O peration     |
+    \\  /    A nd           | Web:      www.OpenFOAM.org
+     \\/     M anipulation  |
+-------------------------------------------------------------------------------
+Description
+    Calculates the flow rate through a specified patch by summing the flux on
+    patch faces.  For solvers where the flux is volumetric, the flow rate is
+    volumetric; where flux is mass flux, the flow rate is mass flow rate.
+
+\*---------------------------------------------------------------------------*/
+
+name    <faceZoneName>;
+
+#includeEtc "caseDicts/postProcessing/flowRate/flowRateFaceZone.cfg"
+
+// ************************************************************************* //

etc/caseDicts/postProcessing/flowRate/flowRateFaceZone.cfg

+/*--------------------------------*- C++ -*----------------------------------*\
+| =========                 |                                                 |
+| \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox           |
+|  \\    /   O peration     | Version:  dev                                   |
+|   \\  /    A nd           | Web:      www.OpenFOAM.org                      |
+|    \\/     M anipulation  |                                                 |
+\*---------------------------------------------------------------------------*/
+
+#includeEtc "caseDicts/postProcessing/surfaceFieldValue/faceZone.cfg"
+
+fields          ();
+orientedFields  (phi);
+operation       sum;
+
+// ************************************************************************* //

src/OpenFOAM/db/dictionary/functionEntries/includeFuncEntry/includeFuncEntry.H

@@ -2,7 +2,7 @@
   =========                 |
   \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
    \\    /   O peration     |
-    \\  /    A nd           | Copyright (C) 2016 OpenFOAM Foundation
+    \\  /    A nd           | Copyright (C) 2016-2017 OpenFOAM Foundation
      \\/     M anipulation  |
 -------------------------------------------------------------------------------
 License
@@ -55,6 +55,16 @@ Description
         #includeFunc mag(p)
     \endverbatim
 
+    Other dictionary entries may also be specified using named arguments, for
+    example the \c name of the \c faceZone in the \c flowRateFaceZone \c
+    functionObject configuration set and the \c orientedFields entry which
+    defaults to \c phi may also be overridden as required, e.g.
+
+    \verbatim
+        #includeFunc flowRateFaceZone(name=fZone1)
+        #includeFunc flowRateFaceZone(orientedFields=(phiAlpha),name=fZone1)
+    \endverbatim
+
 See also
     Foam::functionObjectList