Salome HOME
Documentation improvements and post analysis
[modules/adao.git] / doc / fr / index.rst
index a6fd06c5eb9168b58a0b3ce15d88216b26f6ce9b..8b7ee086ffc5a288098112f12ac6d6d13a1705b4 100644 (file)
@@ -1,5 +1,5 @@
 ..
-   Copyright (C) 2008-2018 EDF R&D
+   Copyright (C) 2008-2021 EDF R&D
 
    This file is part of SALOME ADAO module.
 
@@ -32,71 +32,65 @@ Documentation ADAO
    :alt: Logo ADAO
 
 **Le module ADAO fournit des fonctionnalités d'assimilation de données et
-d'optimisation** dans un contexte SALOME [Salome]_. Il est basé sur
-l'utilisation d'autres modules, à savoir YACS et EFICAS, et sur l'utilisation
-d'une bibliothèque et d'outils génériques sous-jacents d'assimilation de
-données.
+d'optimisation** dans un contexte Python [Python]_ ou SALOME [Salome]_.
 
 En bref, l'assimilation de données est un cadre méthodologique pour calculer
-l'estimation optimale de la valeur réelle (inaccessible) de l'état d'un système
-au cours du temps. Il utilise des informations provenant de mesures
-expérimentales, ou observations, et de modèles numériques *a priori*, y compris
-des informations sur leurs erreurs. Certaines des méthodes incluses dans ce
-cadre sont également connues sous les noms  d'*estimation des paramètres*, de
-*problèmes inverses*, d'*estimation bayésienne*, d'*interpolation optimale*,
-etc. De plus amples détails peuvent être trouvés dans la partie proposant
+l'estimation optimale de la valeur réelle (inaccessible) de l'état d'un
+système, éventuellement au cours du temps. Il utilise des informations
+provenant de mesures expérimentales, ou observations, et de modèles numériques
+*a priori*, y compris des informations sur leurs erreurs. Certaines des
+méthodes incluses dans ce cadre sont également connues sous les noms
+d'*estimation de paramètres*, de *problèmes inverses*, d'*estimation
+bayésienne*, d'*interpolation optimale*, de *reconstruction de champs*, etc. Le
+module ADAO offre actuellement plus d'une centaine de méthodes algorithmiques
+différentes et permet l'étude d'environ 350 problèmes appliqués distincts. De
+plus amples détails peuvent être trouvés dans la partie proposant
 :ref:`section_theory`.
 
 La documentation de ce module est divisée en plusieurs grandes catégories,
-relatives à la documentation théorique (indiquée dans le titre par **[DocT]**),
-à la documentation utilisateur (indiquée dans le titre par **[DocU]**), et à la
-documentation de référence (indiquée dans le titre par **[DocR]**).
+relatives à la documentation théorique (indiquée dans le titre de section par
+**[DocT]**), à la documentation utilisateur (indiquée dans le titre de section
+par **[DocU]**), et à la documentation de référence (indiquée dans le titre de
+section par **[DocR]**).
 
 La première partie est l':ref:`section_intro`. La seconde partie présente
 :ref:`section_theory`, et à leurs concepts, et la partie suivante décrit la
-:ref:`section_methodology`. Pour un utilisateur courant, la quatrième partie
-explique comment :ref:`section_using`, et la cinquième partie présente des
-exemples d'utilisation sous la forme de :ref:`section_examples`. Les
-utilisateurs intéressés par un accès rapide au module peuvent s'arrêter avant la
-lecture de la suite, mais un usage utile du module nécessite de lire et de
-revenir régulièrement aux quatrième et septième parties. La sixième partie
-indique les :ref:`section_advanced`, avec l'obtention de renseignements
-supplémentaires ou l'usage par scripts d'exécution sans interface utilisateur
-graphique (GUI). La septième partie détaille la :ref:`section_reference`, avec
-quatre sous-parties principales qui suivent, la dernière décrivant une
-:ref:`section_tui` du module. Enfin, pour respecter les exigences de licence du
-module, n'oubliez pas de lire la partie :ref:`section_license`.
-
-Dans cette documentation, on utilise les notations standards de l'algèbre
-linéaire, de l'assimilation de données (comme décrit dans [Ide97]_) et de
-l'optimisation. En particulier, les vecteurs sont écrits horizontalement ou
-verticalement sans faire la différence. Les matrices sont écrites soit
-normalement, ou avec une notation condensée, consistant à utiliser un espace
-pour séparer les valeurs, et un "``;``" pour séparer les lignes de la matrice,
-de façon continue sur une ligne.
-
-Table des matières
-------------------
+:ref:`section_methodology`. Pour un utilisateur courant, les parties suivantes
+présentent des exemples didactiques d'utilisation sous la forme de
+:ref:`section_tutorials_in_salome` ou de :ref:`section_tutorials_in_python`,
+puis indique les :ref:`section_advanced`, avec l'obtention de renseignements
+supplémentaires ou l'usage par scripts de commandes hors interface de contrôle
+graphique. Les utilisateurs intéressés par un accès rapide au module peuvent
+s'arrêter avant la lecture de la suite, mais un usage utile du module nécessite
+de lire et de revenir régulièrement à ces parties. Les parties qui suivent
+expliquent comment utiliser une :ref:`section_gui_in_salome` ou une
+:ref:`section_tui`. La dernière grande partie détaille la
+:ref:`section_reference`, avec trois sous-parties essentielles qui la composent
+et qui décrivent les commandes et des options d'algorithmes. Un
+:ref:`section_glossary`, des :ref:`section_notations`, une
+:ref:`section_bibliography` et un index développé complètent le document.
+Enfin, pour respecter les exigences de licence du module, n'oubliez pas de lire
+la partie :ref:`section_license`.
 
 .. toctree::
+   :caption: Table des matières
+   :name: mastertoc
    :maxdepth: 2
+   :numbered: 2
 
    intro
    theory
    methodology
-   using
-   examples
+   tutorials_in_salome
+   tutorials_in_python
    advanced
-   reference
+   gui_in_salome
    tui
+   reference
    license
-   glossary
    bibliography
+   notations
+   glossary
+   genindex
 
-Index et tables
----------------
-
-* :ref:`genindex`
 * :ref:`search`
-
-.. * :ref:`section_glossary`