GitLab

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

- 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

- 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 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.

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