- remove finiteVolume dependency from libfaDecompose

- additional finite-area support too.

- adds support for retaining local face numbers, to allow direct
  addressing into the corresponding area field

- with the changes in vtkCellArray, the legacy files now have
  OFFSET, CONNECTIVITY information.

- support reading of both versions.

- continue to generate legacy format 2.0, since this is what
  many programs still expect

- corresponds to the more recent VTK convention

support parallel creation of finiteArea meshes with on-the-fly decomposition of fields #2084

See merge request !457

- restrict searching to patch quantities to avoid triggering
  mesh edge calculations

- consider the neighbour polyPatch addressing on the connecting edge,
  even when the neighbouring processor does not have a corresponding
  section of the finiteArea mesh.

  These "dangling" edges now propagate their real connectivity across.

- A bare-bones reconstructor for finiteArea meshes when processor
  meshes are available (in parallel) but an equivalent serial faMesh
  is needed for reconstruction or decomposition.
  In these situations, a serial version of the faMesh is needed,
  but preferably without reconstructing the entire volume mesh.

  It uses the finiteVolume faceProcAddressing in addition to
  the geometric information available from the underlying polyMesh.

  The resulting equivalent faMesh can be used for basic operations,
  but caution should be exercised before attempting large operations.

- new faDecompose and faReconstruct libraries

- provide common readFields in the faDecompose library

- adjust surfactantFoam/planeTransport tutorial to have partial
  coverage of the plate by the finiteArea mesh.

  Depending on the decomposition, the outflow boundary may coincide
  with a processor patch (good for testing purposes).

- additional Allrun-parallel versions for targetted future behaviour

- improved separation of patch creation that is also parallel-aware,
  which now allows creation in parallel

- memory-safe use of PtrList for adding patches, with a more generalized
  faPatchData helper

- use uindirectPrimitivePatch instead of indirectPrimitivePatch
  for internal patch handling.

- align boundary methods with polyMesh equivalents

- system/faMeshDefinition instead of constant/faMesh/faMeshDefinition
  as per blockMesh convention. Easier to manage definitions, easier
  for cleanup.

- drop inheritence from GeoMesh.

STYLE: namespace qualifiers on fa/fv option

- depending on how the finiteArea is split up across processors,
  it is possible that some processors have failed to register
  fields in their object registry.

  Now ensure that the field names are synchronized in parallel before
  attempting a write. Replace locally missing fields with a dummy
  zero-sized field.

- refine definition of patch boundary faces to distinguish between
  boundaryFaces() and uniqBoundaryFaces().

  * boundaryFaces() for edge to face lookup on boundary edges.
  * uniqBoundaryFaces() for accessing quantities such as face areas
    or eroding an outer layer

ENH: LabelledItem container, replaces unused 'Keyed' container

- method names in alignment with objectHit, pointIndexHit etc.
  Top-level name aligns with labelledTri.

- reduces common boilerplate, ensures that label fields are
  more easily handled.

- provide '-clean' option for removing old files

- handle out of order '-decomposeParDict' as per RunFunctions

- implicit no-prompt '-yes' with the shortcuts (eg, -log, -xterm)
  and set -local if not already defined

- accept <return> to select defaults

BUG: normalResidual has the potential to contain uninitialized values

See merge request !455

TUT: compressible: clean up tutorials

See merge request !459

ENH: SpalartAllmaras: add estimation functions for k, epsilon and omega

See merge request !441

TUT: airfoil2D: clean up the tutorial case

ENH: SpalartAllmaras: reduce peak-memory usage

This is a partial fix for #2103. If there are no points
extruded for a stand-alone mesh (so not adding to mesh)
it should still include the original patch points. Not
doing so would generate illegal faces (also copiedPatchPoints
would not get set).

INT: splineEdge: allowing usage in extrudeMesh. See #1983.

See merge request !453

TUT: heatTransfer: clean up tutorials

See merge request !458

Support AMI for multi-world operation

See merge request !456

Mattijs Janssens authored 3 years ago and Andrew Heather committed 3 years ago

Multi-world operation now supports AMI:

    // What to sample:
    sampleMode      nearestPatchFaceAMI;