Resolves bug-report http://www.openfoam.org/mantisbt/view.php?id=1918
Patch provided by Richard Jones

maxIters could be made an option input if 20 is not sufficient for
difficult cases.

The resetAMI in the cyclicAMI would go up to cyclicACMI and do the
initPatchFaceAreas again - but with already masked areas

The old version of regionSplit would hand out regions one by one. This
is a big problem when there are lots of regions - the extreme being
in the decompositionMethods, where it is used to cluster cells and most clusters
being only one cell. This rewrite uses a mesh wave to determine disconnected
regions in one go. This produced non-compact numbering which is then compacted
in a second phase.
On a 14M cell case with cyclic constraints this reduced decompose
time from 40 mins down to 5.

Before was zeroing displacement on all coupled points before
applying the displacement. This meant that we could not modify the
internal displacement on coupled points before setting the patch displacement.
Fixes #10.

Feature external coupled

- externalCoupled moved from BC to FO
- Multi-region support
- tutorial heatTransfer/chtMultiRegionFoam/externalCoupledMultiRegionHeater/

See merge request !16

Merge branch 'feature-externalCoupled' of develop.openfoam.com:Development/OpenFOAM-dev-OpenCFD into feature-externalCoupled

Conflicts:

- moved control to functionObject (from bc)
- this allows multi-region support
- see heatTransfer/chtMultiRegionFoam/externalCoupledMultiRegionHeater tut
- generalisation of streamed reading/writing of specialised bcs

- moved control to functionObject (from bc)
- this allows multi-region support
- see heatTransfer/chtMultiRegionFoam/externalCoupledMultiRegionHeater tut
- generalisation of streamed reading/writing of specialised bcs

ENH: potentialFoam updates migrated from internal development line

Added:
- header documentation
- pressure reference cell and value for -writep option
- removed unused createControls.H file - now uses pisoControl control structure

See merge request !14

Feature sampled surfaces

Bounds handling for sampledSurfaces only (so not for streamlines)

See merge request !13

ENH: Foam abort - reading from env(FOAM_ABORT) instead of caching value on construction

As discussed - no longer caching value of FOAM_ABORT on construction of error class; instead, always read from FOAM_ABORT.  Should be no perceived performance impact since this is only triggered on exit/abort.

See merge request !15

- read nastran (NAS) surfaces in comma-separated free format

etc/caseDicts/setConstraintTypes: Initialize the value for processor BCs to the uniform internalField value Resolves bug-report http://www.openfoam.org/mantisbt/view.php?id=1883

- bounds option (see $FOAM_UTILITIES/postProcessing/sampling/sample/sampleDict)
- fixes memory error http://www.openfoam.org/mantisbt/view.php?id=1487
- cleans up iso surface normal orientation

moveDynamicMesh: Iterate over mesh.update() according to the PIMPLE settings Resolves bug-report http://www.openfoam.org/mantisbt/view.php?id=1926

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

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

Feature decompose par dict

Merging remaining functionality to do with -decomposeParDict parallel argList option.

See merge request !10

ENH: patchProbes: allow wildcards for patches

Also write out snapped location.

Probe location output kept as in Foundation

See merge request !11

Feature wind tunnel bc

pressurePIDControlInletVelocity bc

See merge request !9

Also write out snapped location.