2 Copyright (C) 2008-2015 EDF R&D
4 This file is part of SALOME ADAO module.
6 This library is free software; you can redistribute it and/or
7 modify it under the terms of the GNU Lesser General Public
8 License as published by the Free Software Foundation; either
9 version 2.1 of the License, or (at your option) any later version.
11 This library is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Lesser General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public
17 License along with this library; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
22 Author: Jean-Philippe Argaud, jean-philippe.argaud@edf.fr, EDF R&D
26 ================================================================================
28 ================================================================================
30 .. image:: images/ADAO_logo.png
34 The ADAO module provides **data assimilation and optimization** features in
35 SALOME context. It is based on usage of other SALOME modules, namely YACS and
36 EFICAS, and on usage of a generic underlying data assimilation library.
38 Briefly stated, Data Assimilation is a methodological framework to compute the
39 optimal estimate of the inaccessible true value of a system state over time. It
40 uses information coming from experimental measurements or observations, and from
41 numerical *a priori* models, including information about their errors. Parts of
42 the framework are also known under the names of *parameter estimation*, *inverse
43 problems*, *Bayesian estimation*, *optimal interpolation*, etc. More details can
44 be found in the section :ref:`section_theory`.
46 The documentation for this module is divided into several major categories,
47 related to the theoretical documentation (indicated in the title by **[DocT]**),
48 to the user documentation (indicated in the title by **[DocU]**), and to the
49 reference documentation (indicated in the title by **[DocR]**). The second part
50 introduces :ref:`section_theory`, and their concepts. The third part describes
51 :ref:`section_using`, and the fourth part gives examples on ADAO usage as
52 :ref:`section_examples`. Users interested in quick use of the module can stop
53 before reading the rest, but a valuable use of the module requires to read and
54 come back regularly to the third and seventh parts. The fifth part indicate
55 :ref:`section_advanced`, with obtaining additional information or the use of
56 non-GUI execution scripting. The next part gives a detailed
57 :ref:`section_reference`, with four main sub-parts following, the last one
58 giving a :ref:`section_tui` of the module. And, to respect the module
59 requirements, be sure to read the part :ref:`section_license`.
61 In all this documentation, we use standard notations of linear algebra, data
62 assimilation (as described in [Ide97]_) and optimization. In particular, vectors
63 are written horizontally or vertically without making difference. Matrices are
64 written either normally, or with a condensed notation, consisting in the use of
65 a space to separate values and a "``;``" to separate the rows, in a continuous
91 .. * :ref:`section_glossary`