doc/index.rst

   1 ================================================================================
   2 ADAO module documentation
   3 ================================================================================
   4
   5 .. image:: images/ADAO_logo.png
   6    :align: center
   7    :scale: 10%
   8
   9 The ADAO module provides **data assimilation** features in SALOME context. It is
  10 based on usage of other SALOME modules, namely YACS and EFICAS, and on usage of
  11 a generic underlying data assimilation library.
  12
  13 Briefly stated, Data Assimilation is a methodological framework to compute the
  14 optimal estimate of the inaccessible true value of a system state over time. It
  15 uses information coming from experimental measurements or observations, and from
  16 numerical *a priori* models, including information about their errors. Parts of
  17 the framework are also known as *parameter estimation*, *inverse problems*,
  18 *bayesian estimation*, *optimal interpolation*, etc. More details can be found
  19 in the section :ref:`section_theory`.
  20
  21 The documentation of this module is divided in 5 parts, the first one being an
  22 introduction. The second part briefly introduces data assimilation and concepts.
  23 The third part describes how to use the module ADAO. The fourth part gives
  24 examples on ADAO usage. Users interested in quick use of the module can jump to
  25 this section :ref:`section_examples`, but a valuable use of the module requires
  26 to read and come back regularly to the section :ref:`section_using`. The last
  27 part focuses on advanced usages of the module, how to get more information, or
  28 how to use it without the graphical user interface (GUI).
  29
  30 In all this documentation, we use standard notations of data assimilation, as
  31 described in [Ide97]. Moreover, vectors are written horizontally or vertically
  32 without making difference. Matrices are written either normally, or with a
  33 condensed notation, consisting in the use of a space to separate values and a
  34 "``;``" to separate the rows, in a continuous line.
  35
  36 Table of contents
  37 -----------------
  38
  39 .. toctree::
  40    :maxdepth: 2
  41
  42    intro
  43    theory
  44    using
  45    examples
  46    advanced
  47    bibliography
  48
  49 Indices and tables
  50 ------------------
  51
  52 * :ref:`genindex`
  53 * :ref:`search`
  54 * :ref:`section_glossary`