[MERGE] (stfident): merge with commit stf

This is a legacy commit from before 2015-03-01.
It may be incomplete as well as inconsistent.
See COPYING.legacy and README.history for details.

  f546a0a [WP][DOC] (stfinv): document data storage names

src/libs/libstfinv/stfinvany.h

@@ -55,6 +55,9 @@ namespace stfinv {
    * abstract base class stfinv::STFBaseEngine except that the first prefix
    * (up to the first colon) in the parameter string is understood to identify
    * the selected engine.
+   *
+   * It serves as a kind of handle to provide user selectable engines to
+   * application programs.
    */
   class STFEngine {
     public:

src/libs/libstfinv/stfinvbase.h

@@ -185,6 +185,21 @@ namespace stfinv {
    * See STFBaseEngine::parameter() and STFBaseEngine::parameterisset()
    * for a description on how parameters are handled within engine classes.
    *
+   * \par Data
+   *  - recordings are understood as recorded waveforms.
+   *    The number of available traces is returned by nreceivers()
+   *  - synthetics are understood as synthetic waveforms generated with a
+   *    generic source time function.
+   *    For each trace of recordings there must be a matching trace of
+   *    synthetics and vice versa.
+   *  - convolvedsynthetics are produced from synthetics as a result of the
+   *    application of the source wavelet correction filter.
+   *  - series are additional synthetic time series, not used to construct the
+   *    source-wavelet correction filter. The number of additional series
+   *    traces is returned by npairs().
+   *  - convolvedseries are produced from series as a result of the
+   *    application of the source wavelet correction filter.
+   *
    * \sa
    * \ref sec_page_design_initialization
    *