Salome HOME
Minor documentation improvements
[modules/adao.git] / doc / fr / reference.rst
index e04151fec0f1ae936d13282a58267735cead8033..68d4f3e61a83770604b035984f778698ee150e67 100644 (file)
@@ -1,5 +1,5 @@
 ..
-   Copyright (C) 2008-2015 EDF R&D
+   Copyright (C) 2008-2021 EDF R&D
 
    This file is part of SALOME ADAO module.
 
 .. _section_reference:
 
 ================================================================================
-**[DocR]** Description de référence des commandes et mots-clés ADAO
+**[DocR]** Description de référence des commandes et mots-clés ADAO
 ================================================================================
 
-Les sections suivantes présentent la description de référence des commandes et
-mots-clés ADAO disponibles à travers l'interface graphique (GUI) ou à travers
-des scripts. Les deux premières sections communes présentent les
-:ref:`section_reference_entry` et les :ref:`section_reference_special_entry`.
-Ensuite, on décrit successivement les :ref:`section_reference_assimilation` et
-les :ref:`section_reference_checking`.
-
-Chaque commande ou mot-clé à définir par l'interface graphique (GUI) a des
-propriétés particulières. La première propriété est d'être *requise*,
-*optionnelle* ou simplement utile, décrivant un type d'entrée. La seconde
-propriété est d'être une variable "ouverte" avec un type fixé mais avec
-n'importe quelle valeur autorisée par le type, ou une variable "fermée", limitée
-à des valeurs spécifiées. L'éditeur graphique intégré disposant de capacités
-intrinsèques de validation, les propriétés des commandes ou mots-clés données à
-l'aide de l'interface graphique sont automatiquement correctes.
+Les sections suivantes présentent la description de référence des commandes et
+mots-clés ADAO disponibles à travers l'interface textuelle (TUI), graphique
+(GUI) ou à travers des scripts. Les deux premières sections communes présentent
+les :ref:`section_reference_entry` et les
+:ref:`section_reference_special_entry`. Ensuite, on décrit successivement les
+:ref:`section_reference_assimilation` et les :ref:`section_reference_checking`.
+
+Chaque commande ou mot-clé à définir par la TUI ou la GUI a des propriétés
+particulières. La première propriété est d'être *requise*, *optionnelle* ou
+simplement utile, décrivant un type d'entrée. La seconde propriété est d'être
+une variable "ouverte" avec un type fixé mais avec n'importe quelle valeur
+autorisée par le type, ou une variable "fermée", limitée à des valeurs
+spécifiées. L'éditeur graphique GUI intégré disposant de capacités intrinsèques
+de validation, les propriétés des commandes ou mots-clés données à l'aide de
+l'interface graphique sont automatiquement correctes.
 
 .. _section_reference_entry:
 
 ========================================================================================
-**[DocR]** Entrées et sorties générales
+**[DocR]** Entrées et sorties générales
 ========================================================================================
 
-Cette section décrit de manière générale les différentes possibilités de types
-d'entrées et de variables de sortie que l'on peut utiliser. Les notations
-mathématiques utilisées sont expliquées dans la section :ref:`section_theory`.
+Cette section décrit de manière générale les différentes possibilités de types
+d'entrées et de variables de sortie que l'on peut utiliser. Les notations
+mathématiques utilisées sont expliquées dans la section :ref:`section_theory`.
 
 .. toctree::
    :maxdepth: 1
-   
+
    ref_entry_types
    ref_options_AlgorithmParameters
    ref_output_variables
@@ -63,16 +63,16 @@ math
 .. _section_reference_special_entry:
 
 ========================================================================================
-**[DocR]** Entrées spéciales : fonctions, matrices, "*observer*"
+**[DocR]** Entrées spéciales : fonctions, matrices, "*observer*"
 ========================================================================================
 
-Cette section décrit les entrées spéciales, comme les formes fonctionnelles ou
-matricielles, que l'on peut utiliser. Les notations mathématiques utilisées
-sont expliquées dans la section :ref:`section_theory`.
+Cette section décrit les entrées spéciales, comme les formes fonctionnelles ou
+matricielles, que l'on peut utiliser. Les notations mathématiques utilisées
+sont expliquées dans la section :ref:`section_theory`.
 
 .. toctree::
    :maxdepth: 1
-   
+
    ref_operator_requirements
    ref_covariance_requirements
    ref_observers_requirements
@@ -80,27 +80,30 @@ sont expliqu
 .. _section_reference_assimilation:
 
 ============================================================================================
-**[DocR]** Cas d'assimilation de données ou d'optimisation
+**[DocR]** Cas d'assimilation de données ou d'optimisation
 ============================================================================================
 
-Cette section décrit les algorithmes d'assimilation de données ou d'optimisation
-disponibles dans ADAO, détaillant leurs caractéristiques d'utilisation et leurs
-options.
+Cette section décrit les choix algorithmiques pour utiliser des méthodes
+d'assimilation de données, des méthodes d'optimisation ou des méthodes avec
+réduction, disponibles dans ADAO, détaillant leurs caractéristiques
+d'utilisation et leurs options.
 
 Des exemples sur l'usage de ces commandes sont disponibles dans la section
-:ref:`section_examples` et dans les fichiers d'exemple installés avec le module
-ADAO. Les notations mathématiques utilisées sont expliquées dans la section
-:ref:`section_theory`.
+:ref:`section_tutorials_in_salome`, dans la section
+:ref:`section_tutorials_in_python` et dans les fichiers d'exemple installés
+avec ADAO. Les notations mathématiques utilisées sont expliquées dans la
+section :ref:`section_theory`.
 
 .. toctree::
    :maxdepth: 1
-   
-   ref_assimilation_keywords
+
    ref_algorithm_3DVAR
    ref_algorithm_4DVAR
    ref_algorithm_Blue
    ref_algorithm_DerivativeFreeOptimization
+   ref_algorithm_DifferentialEvolution
    ref_algorithm_EnsembleBlue
+   ref_algorithm_EnsembleKalmanFilter
    ref_algorithm_ExtendedBlue
    ref_algorithm_ExtendedKalmanFilter
    ref_algorithm_KalmanFilter
@@ -108,30 +111,36 @@ ADAO. Les notations math
    ref_algorithm_NonLinearLeastSquares
    ref_algorithm_ParticleSwarmOptimization
    ref_algorithm_QuantileRegression
+   ref_algorithm_TabuSearch
    ref_algorithm_UnscentedKalmanFilter
+   ref_assimilation_keywords
 
 .. _section_reference_checking:
 
 ================================================================================
-**[DocR]** Cas de vérification
+**[DocR]** Cas de vérification
 ================================================================================
 
-Cette section décrit les algorithmes de vérification disponibles dans ADAO,
-détaillant leurs caractéristiques d'utilisation et leurs options.
+Cette section décrit les algorithmes de vérification disponibles dans ADAO,
+détaillant leurs caractéristiques d'utilisation et leurs options.
 
 Des exemples sur l'usage de ces commandes sont disponibles dans la section
-:ref:`section_examples` et dans les fichiers d'exemple installés avec le module
-ADAO. Les notations mathématiques utilisées sont expliquées dans la section
-:ref:`section_theory`.
+:ref:`section_tutorials_in_salome`, dans la section
+:ref:`section_tutorials_in_python` et dans les fichiers d'exemple installés
+avec ADAO. Les notations mathématiques utilisées sont expliquées dans la
+section :ref:`section_theory`.
 
 .. toctree::
    :maxdepth: 1
-   
-   ref_checking_keywords
+
    ref_algorithm_AdjointTest
    ref_algorithm_FunctionTest
    ref_algorithm_GradientTest
+   ref_algorithm_InputValuesTest
    ref_algorithm_LinearityTest
+   ref_algorithm_LocalSensitivityTest
    ref_algorithm_ObserverTest
+   ref_algorithm_ParallelFunctionTest
    ref_algorithm_SamplingTest
    ref_algorithm_TangentTest
+   ref_checking_keywords