Salome HOME
Minor documentation and code review corrections (39)
[modules/adao.git] / doc / fr / index.rst
1 ..
2    Copyright (C) 2008-2023 EDF R&D
3
4    This file is part of SALOME ADAO module.
5
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.
10
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.
15
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
19
20    See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
21
22    Author: Jean-Philippe Argaud, jean-philippe.argaud@edf.fr, EDF R&D
23
24 .. _section_home:
25
26 ================================================================================
27 Documentation ADAO
28 ================================================================================
29
30 .. image:: images/ADAO_logo.png
31    :align: center
32    :alt: Logo ADAO
33
34 **Le module ADAO fournit des fonctionnalités d'assimilation de données et
35 d'optimisation** dans un contexte Python [Python]_ ou SALOME [Salome]_.
36
37 En bref, l'assimilation de données est un cadre méthodologique pour calculer
38 l'estimation optimale de la valeur réelle (inaccessible) de l'état d'un
39 système, éventuellement au cours du temps. Il utilise des informations
40 provenant de mesures expérimentales, ou observations, et de modèles numériques
41 *a priori*, y compris des informations sur leurs erreurs. Certaines des
42 méthodes incluses dans ce cadre sont également connues sous les noms de
43 *calage* ou *recalage*, *calibration*, *estimation d'état*, *estimation de
44 paramètres*, *ajustement de paramètres*, *problèmes inverses*, *méthodes
45 inverses*, *inversion*, *estimation bayésienne*, *interpolation optimale*,
46 *régularisation mathématique*, *méta-heuristiques* d'optimisation, *réduction
47 de modèles*, *lissage de données*, etc. De plus amples détails peuvent être
48 trouvés dans la partie proposant :ref:`section_theory`. Le module ADAO offre
49 actuellement plus d'une centaine de méthodes algorithmiques différentes et
50 permet l'étude d'environ 350 problèmes appliqués distincts.
51
52 La documentation de ce module est divisée en plusieurs grandes catégories,
53 relatives à la **documentation théorique** (indiquée dans le titre de section
54 par **[DocT]**), à la **documentation utilisateur** (indiquée dans le titre de
55 section par **[DocU]**), et à la **documentation de référence** (indiquée dans
56 le titre de section par **[DocR]**).
57
58 La première partie est l':ref:`section_intro`. La seconde partie présente
59 :ref:`section_theory`, et à leurs concepts, et la partie suivante décrit la
60 :ref:`section_methodology`. Pour un utilisateur courant, les parties suivantes
61 présentent des :ref:`section_docu_examples`, rapidement accessibles par
62 l'ensemble des pointeurs vers les sous-parties. Des présentations didactiques
63 sont détaillés dans les :ref:`section_tutorials_in_salome` ou les
64 :ref:`section_tutorials_in_python`, et complétées par des indications sur les
65 :ref:`section_advanced`, avec l'obtention de renseignements supplémentaires ou
66 l'usage par scripts de commandes hors interface de contrôle graphique.
67
68 Les utilisateurs intéressés par un accès rapide au module peuvent s'arrêter
69 avant la lecture de la suite, mais un usage utile du module nécessite de lire
70 et de revenir régulièrement à ces parties. Les parties qui suivent expliquent
71 comment utiliser une :ref:`section_gui_in_salome` ou une :ref:`section_tui`. La
72 dernière grande partie détaille la :ref:`section_reference`, avec trois
73 sous-parties essentielles qui la composent et qui décrivent les commandes et
74 des options d'algorithmes. Un :ref:`section_glossary`, des
75 :ref:`section_notations`, une :ref:`section_bibliography` et un index développé
76 complètent le document. Enfin, pour respecter les exigences de licence du
77 module, n'oubliez pas de lire la partie :ref:`section_license`.
78
79 .. toctree::
80    :caption: Table des matières
81    :name: mastertoc
82    :maxdepth: 2
83    :numbered: 2
84
85    intro
86    theory
87    methodology
88    examples
89    tutorials_in_salome
90    tutorials_in_python
91    advanced
92    gui_in_salome
93    tui
94    reference
95    license
96    bibliography
97    notations
98    glossary
99    genindex
100
101 * :ref:`search`