OpenFOAM-4.x/etc/caseDicts/postProcessing
Henry Weller 1d7e1a7ad5 functionObjects: renamed faceSource -> surfaceRegion, cellSource -> volRegion
The use of the term 'source' in the context of post-processing is
confusing and does not properly describe the process of region
selection.  The new names 'surfaceRegion' and 'volRegion' better
describe the purpose of the functionObjects which is to provide field
processing functionality limited to a specified region of space, either
a surface or volume.

The keyword 'source' is renamed 'regionType' which better describes the
purpose which is to specify the method by which the surface or volume
region is selected.

The keyword to select the name of the surface or volume region is
renamed from 'sourceName' to 'name' consistent with the other
name-changes above.
2016-06-12 20:56:51 +01:00
..
fields Packaged function objects: added a Description entry 2016-06-11 08:53:04 +01:00
flowRate functionObjects: renamed faceSource -> surfaceRegion, cellSource -> volRegion 2016-06-12 20:56:51 +01:00
forces Packaged function objects: added a Description entry 2016-06-11 08:53:04 +01:00
graphs Packaged function objects: added a Description entry 2016-06-11 08:53:04 +01:00
minMax functionObjects: renamed faceSource -> surfaceRegion, cellSource -> volRegion 2016-06-12 20:56:51 +01:00
numerical Packaged function objects: added a Description entry 2016-06-11 08:53:04 +01:00
pressure functionObjects: renamed faceSource -> surfaceRegion, cellSource -> volRegion 2016-06-12 20:56:51 +01:00
probes Packaged function objects: added a Description entry 2016-06-11 08:53:04 +01:00
solvers/scalarTransport Packaged function objects: added a Description entry 2016-06-11 08:53:04 +01:00
surfaceRegion functionObjects: renamed faceSource -> surfaceRegion, cellSource -> volRegion 2016-06-12 20:56:51 +01:00
visualization Packaged function objects: added a Description entry 2016-06-11 08:53:04 +01:00
README functionObjects: renamed faceSource -> surfaceRegion, cellSource -> volRegion 2016-06-12 20:56:51 +01:00

Overview
========
- This directory contains files to help post-processing of OpenFOAM cases
- It primariy "packages" functionObject functionality in a convenient form for
  users to plug into their OpenFOAM cases
- While some tools are quite generic, e.g. minMax, others are more application-
  oriented, e.g. flowRate.

How the tools work
==================
- The configuration of functionObjects includes both required input data and
  control parameters for the functionObject
- This creates a lot of input that can be confusing to users
- The tools here are packaged so that the user input is separated from control
  parameters
- Control parameters are pre-configured in .cfg files - users can ignore these
  files
- For each tool, required user input is all in one file, for the users to copy
  into their case and set accordingly

Example of how to use the tools
===============================
Task: monitor flow rate at an outlet patch named "outlet" for a case
Solution:
- locate the flowRatePatch tool in the flowRate directory
- copy the flowRatePatch file into the case system directory (not
  flowRatePatch.cfg)
- edit system/flowRatePatch to set the patch name
  replace "patch <patchName>;"
  with    "patch outlet;"
- activate the function object by including the flowRatePatch file in functions
  sub-dictionary in the case controlDict file, e.g.
  functions
  {
      #includeEtc "caseDicts/postProcessing/flowRate/flowRatePatch"
      ... other function objects here ...
  }

Current tools
=============
- fields          calculate specific fields, e.g. Q
- flowRate        tools to calculate flow rate
- forces          forces and forceCoeffs for incompressible/compressible flows
- graphs          simple sampling for graph plotting, e.g. singleGraph
- minMax          range of minimum and maximum field monitoring, e.g. cellMax
- numerical       outputs information relating to numerics, e.g. residuals
- pressure        calculates different forms of pressure, pressure drop, etc
- probes          options for probing data
- scalarTransport for plugin scalar transport calculations
- visualization   post-processing VTK files for cutting planes, streamlines,...

- surfaceRegion      configuration for some of the tools above