Skip to main content

fluxSummary

Description

The fluxSummary function object computes the volumetric- or mass-flux information across selections of face zones.

Statistics include:

  • positive flux:

ϕ+=ϕ>0\phi_{+} = \sum \phi_{>0}

  • negative flux:

ϕ=ϕ<0\phi_{-} = \sum \phi_{<0}

  • net flux:

ϕnet=ϕ\phi_{\mathrm{net}} = \sum \phi

  • absolute flux:

ϕabs=ϕ\phi_{\mathrm{abs}} = \sum |{\phi}|

Operands

OperandTypeLocation
input--
output filedat$FOAM_CASE/postProcessing/<FO>/<time>/<faceN>
output field--

Usage

Example of the fluxSummary function object by using functions sub-dictionary in system/controlDict file:

fluxSummary1
{
// Mandatory entries (unmodifiable)
type fluxSummary;
libs (fieldFunctionObjects);

// Mandatory entries (runtime modifiable)
mode cellZoneAndDirection;
cellZoneAndDirection
(
(porosity (1 0 0))
);

// Optional entries (runtime modifiable)
phi phi;
scaleFactor 1.0;
tolerance 0.8;

// Optional (inherited) entries
writePrecision 8;
writeToFile true;
useUserTime true;
region region0;
enabled true;
log true;
timeStart 0;
timeEnd 1000;
executeControl timeStep;
executeInterval 1;
writeControl timeStep;
writeInterval 1;
}

where the entries mean:

PropertyDescriptionTypeRequiredDefault
typeType name: fluxSummarywordyes-
libsLibrary name: fieldFunctionObjectswordyes-
modeMode to generate faces to testwordyes-
phiName of surface flux fieldwordnophi
scaleFactorFactor to scale resultsscalarno1.0
toleranceTolerance for reference directionscalarno0.8

Options for the mode entry:

faceZone
faceZoneAndDirection | faceZone with prescribed positive direction
cellZoneAndDirection | cellZone with prescribed positive direction
surface
surfaceAndDirection

The inherited entries are elaborated in:

Usage by the postProcess utility is not available.

Notes on entries

  • For surface and direction, phi=U can be used for determining the fluxes.
  • In case of mode=cellZoneAndDirection, faces bounding the cellZone are extracted and processed.

Further information

Tutorial:

Source code:

API:

History: Introduced in version v1612+