GitLab

- relocate to controlDict, since more than a single function object
  is often used.

- can remove directly from the temporary objectRegistry prior to
  converting by field type. Cannot, however, do the same for volFields
  or areaFields since these reside on their respective mesh objects.

- LINK_LIBRARIES are required for proper try_compile

STYLE: report output directory

- ParaView Catalyst with MPI is advisable (especially for larger
  simulations), but not a requirement

BUG: general patch movement was inconsistent

Feature unified output

Closes #3 and #4

See merge request !1

- previously had separate function objects for each category of source
  (finite volume, finite area, lagrangian). This lead to isolation of
  the individual input sources, which highly restricted the flexibility.

- now have a single catalyst function object with an arbitrary number
  of inputs (sources). The catalyst channel name is that of the
  corresponds dictionary name. For volume mesh sources, it is possible
  to address "mesh" and "patches" sub-channels.

  Eg,
      mesh = coprocessor.CreateProducer(datadescription, 'myregion/mesh')

  This restructuring also aims at integration of other OpenFOAM content
  (eg, surfMesh, sampled probes, sampled surfaces) as a future
  development.

- the output directory (by default "<case>/insitu") is passed onto
  catalyst as its working directory, using the upstream patches that
  now close issue #4

- reflects current change being made to the vtkCPProcessor API to
  include chdir capabilities.

- prevents accidental overwrite of runtime conversions.

- uses the cellCellStencil information to blank holes and the
  interpolated cells.

- needs more detailed attention for handling cases when three or more
  meshes are overlapping.

- this is a convenient means of creating an output directory from within
  the function object without corresponding python or shell script.

  Some pipelines (image generation) balk if the output directory does
  not exist. Others (vtm writer etc) will create their own.

STYLE: use OpenFOAM caseDicts config files, newer string expansion.

- Eg, "<system>/scripts" instead of "$FOAM_CASE/system/scripts"

- OpenFOAM CleanFunctions now include removal of the 'insitu' directory

- Note that stopping the catalyst function object via a `timeEnd` value
  does not actually call the corresponding end() method.

  See: Development/OpenFOAM-plus#791

- note that the timeEnd keyword does stop the execution of the
  function object, but does not close the connection or free up
  resources

- restructured/renamed the various cfg files in anticipation of
  relocating them to the main OpenFOAM etc/caseDicts directory in the
  future.

- was check(), now query()

- emit/suppress information output based on 'log' setting
  (as per other functionObjects)

This integration represents a collective work
  - CINECA (Simone.Bna@cineca.it)
  - OpenCFD
  - with additional input from KitWare (Andy.Bauer@kitware.com)

NB: requires ParaView or ParaView Catalyst with MPI and Python