Salome HOME
Documentation improvements and post analysis
[modules/adao.git] / doc / fr / ref_algorithm_DerivativeFreeOptimization.rst
index 490f0824df568a5f6deec5c96eec40e043110ebe..682ac4eeadb62bb0dc837a7a02491a59355a450d 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.
 
 Algorithme de calcul "*DerivativeFreeOptimization*"
 ---------------------------------------------------
 
-Description
-+++++++++++
+.. ------------------------------------ ..
+.. include:: snippets/Header2Algo01.rst
 
 Cet algorithme réalise une estimation d'état d'un système par minimisation
 d'une fonctionnelle d'écart :math:`J` sans gradient. C'est une méthode qui
 n'utilise pas les dérivées de la fonctionnelle d'écart. Elle entre, par
 exemple, dans la même catégorie que
-l':ref:`section_ref_algorithm_ParticleSwarmOptimization` ou
-l':ref:`section_ref_algorithm_DifferentialEvolution`.
+l':ref:`section_ref_algorithm_ParticleSwarmOptimization`,
+l':ref:`section_ref_algorithm_DifferentialEvolution` ou
+l':ref:`section_ref_algorithm_TabuSearch`.
 
 C'est une méthode d'optimisation permettant la recherche du minimum global d'une
 fonctionnelle d'erreur :math:`J` quelconque de type :math:`L^1`, :math:`L^2` ou
@@ -43,130 +44,143 @@ fonctionnelle d'erreur :math:`J` quelconque de type :math:`L^1`, :math:`L^2` ou
 défaut est celle de moindres carrés pondérés augmentés, classiquement utilisée
 en assimilation de données.
 
-Commandes requises et optionnelles
-++++++++++++++++++++++++++++++++++
+.. ------------------------------------ ..
+.. include:: snippets/Header2Algo02.rst
 
-Les commandes requises générales, disponibles dans l'interface en édition, sont
-les suivantes:
+.. include:: snippets/Background.rst
 
-  .. include:: snippets/Background.rst
+.. include:: snippets/BackgroundError.rst
 
-  .. include:: snippets/BackgroundError.rst
+.. include:: snippets/Observation.rst
 
-  .. include:: snippets/Observation.rst
+.. include:: snippets/ObservationError.rst
 
-  .. include:: snippets/ObservationError.rst
+.. include:: snippets/ObservationOperator.rst
 
-  .. include:: snippets/ObservationOperator.rst
+.. ------------------------------------ ..
+.. include:: snippets/Header2Algo03AdOp.rst
 
-Les commandes optionnelles générales, disponibles dans l'interface en édition,
-sont indiquées dans la :ref:`section_ref_assimilation_keywords`. De plus, les
-paramètres de la commande "*AlgorithmParameters*" permettent d'indiquer les
-options particulières, décrites ci-après, de l'algorithme. On se reportera à la
-:ref:`section_ref_options_Algorithm_Parameters` pour le bon usage de cette
-commande.
+.. include:: snippets/Minimizer_DFO.rst
 
-Les options de l'algorithme sont les suivantes:
+.. include:: snippets/BoundsWithNone.rst
 
-  .. include:: snippets/Minimizer_DFO.rst
+.. include:: snippets/MaximumNumberOfSteps.rst
 
-  .. include:: snippets/BoundsWithNone.rst
+.. include:: snippets/MaximumNumberOfFunctionEvaluations.rst
 
-  .. include:: snippets/MaximumNumberOfSteps.rst
+.. include:: snippets/StateVariationTolerance.rst
 
-  .. include:: snippets/MaximumNumberOfFunctionEvaluations.rst
+.. include:: snippets/CostDecrementTolerance.rst
 
-  .. include:: snippets/StateVariationTolerance.rst
+.. include:: snippets/QualityCriterion.rst
 
-  .. include:: snippets/CostDecrementTolerance.rst
+StoreSupplementaryCalculations
+  .. index:: single: StoreSupplementaryCalculations
 
-  .. include:: snippets/QualityCriterion.rst
+  *Liste de noms*. Cette liste indique les noms des variables supplémentaires
+  qui peuvent être disponibles au cours du déroulement ou à la fin de
+  l'algorithme, si elles sont initialement demandées par l'utilisateur. Cela
+  implique potentiellement des calculs ou du stockage coûteux. La valeur par
+  défaut est une liste vide, aucune de ces variables n'étant calculée et
+  stockée par défaut sauf les variables inconditionnelles. Les noms possibles
+  sont dans la liste suivante : [
+  "Analysis",
+  "BMA",
+  "CostFunctionJ",
+  "CostFunctionJb",
+  "CostFunctionJo",
+  "CostFunctionJAtCurrentOptimum",
+  "CostFunctionJbAtCurrentOptimum",
+  "CostFunctionJoAtCurrentOptimum",
+  "CurrentIterationNumber",
+  "CurrentOptimum",
+  "CurrentState",
+  "IndexOfOptimum",
+  "Innovation",
+  "InnovationAtCurrentState",
+  "OMA",
+  "OMB",
+  "SimulatedObservationAtBackground",
+  "SimulatedObservationAtCurrentOptimum",
+  "SimulatedObservationAtCurrentState",
+  "SimulatedObservationAtOptimum",
+  ].
 
-  StoreSupplementaryCalculations
-    .. index:: single: StoreSupplementaryCalculations
+  Exemple :
+  ``{"StoreSupplementaryCalculations":["BMA", "CurrentState"]}``
 
-    Cette liste indique les noms des variables supplémentaires qui peuvent être
-    disponibles à la fin de l'algorithme. Cela implique potentiellement des
-    calculs ou du stockage coûteux. La valeur par défaut est une liste vide,
-    aucune de ces variables n'étant calculée et stockée par défaut. Les noms
-    possibles sont dans la liste suivante : ["BMA", "CostFunctionJ",
-    "CostFunctionJAtCurrentOptimum", "CostFunctionJb",
-    "CostFunctionJbAtCurrentOptimum", "CostFunctionJo",
-    "CostFunctionJoAtCurrentOptimum", "CurrentOptimum", "CurrentState",
-    "IndexOfOptimum", "Innovation", "InnovationAtCurrentState", "OMA", "OMB",
-    "SimulatedObservationAtBackground", "SimulatedObservationAtCurrentOptimum",
-    "SimulatedObservationAtCurrentState", "SimulatedObservationAtOptimum"].
+.. ------------------------------------ ..
+.. include:: snippets/Header2Algo04.rst
 
-    Exemple :
-    ``{"StoreSupplementaryCalculations":["BMA", "Innovation"]}``
+.. include:: snippets/Analysis.rst
 
-Informations et variables disponibles à la fin de l'algorithme
-++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+.. include:: snippets/CostFunctionJ.rst
 
-En sortie, après exécution de l'algorithme, on dispose d'informations et de
-variables issues du calcul. La description des
-:ref:`section_ref_output_variables` indique la manière de les obtenir par la
-méthode nommée ``get`` de la variable "*ADD*" du post-processing. Les variables
-d'entrée, mises à disposition de l'utilisateur en sortie pour faciliter
-l'écriture des procédures de post-processing, sont décrites dans
-l':ref:`subsection_r_o_v_Inventaire`.
+.. include:: snippets/CostFunctionJb.rst
 
-Les sorties non conditionnelles de l'algorithme sont les suivantes:
+.. include:: snippets/CostFunctionJo.rst
 
-  .. include:: snippets/Analysis.rst
+.. include:: snippets/CurrentState.rst
 
-  .. include:: snippets/CostFunctionJ.rst
+.. ------------------------------------ ..
+.. include:: snippets/Header2Algo05.rst
 
-  .. include:: snippets/CostFunctionJb.rst
+.. include:: snippets/Analysis.rst
 
-  .. include:: snippets/CostFunctionJo.rst
+.. include:: snippets/BMA.rst
 
-  .. include:: snippets/CurrentState.rst
+.. include:: snippets/CostFunctionJ.rst
 
-Les sorties conditionnelles de l'algorithme sont les suivantes:
+.. include:: snippets/CostFunctionJb.rst
 
-  .. include:: snippets/BMA.rst
+.. include:: snippets/CostFunctionJo.rst
 
-  .. include:: snippets/CostFunctionJAtCurrentOptimum.rst
+.. include:: snippets/CostFunctionJAtCurrentOptimum.rst
 
-  .. include:: snippets/CostFunctionJbAtCurrentOptimum.rst
+.. include:: snippets/CostFunctionJbAtCurrentOptimum.rst
 
-  .. include:: snippets/CostFunctionJoAtCurrentOptimum.rst
+.. include:: snippets/CostFunctionJoAtCurrentOptimum.rst
 
-  .. include:: snippets/CurrentOptimum.rst
+.. include:: snippets/CurrentIterationNumber.rst
 
-  .. include:: snippets/IndexOfOptimum.rst
+.. include:: snippets/CurrentOptimum.rst
 
-  .. include:: snippets/Innovation.rst
+.. include:: snippets/CurrentState.rst
 
-  .. include:: snippets/InnovationAtCurrentState.rst
+.. include:: snippets/IndexOfOptimum.rst
 
-  .. include:: snippets/OMA.rst
+.. include:: snippets/Innovation.rst
 
-  .. include:: snippets/OMB.rst
+.. include:: snippets/InnovationAtCurrentState.rst
 
-  .. include:: snippets/SimulatedObservationAtBackground.rst
+.. include:: snippets/OMA.rst
 
-  .. include:: snippets/SimulatedObservationAtCurrentOptimum.rst
+.. include:: snippets/OMB.rst
 
-  .. include:: snippets/SimulatedObservationAtCurrentState.rst
+.. include:: snippets/SimulatedObservationAtBackground.rst
 
-  .. include:: snippets/SimulatedObservationAtOptimum.rst
+.. include:: snippets/SimulatedObservationAtCurrentOptimum.rst
 
-Voir aussi
-++++++++++
+.. include:: snippets/SimulatedObservationAtCurrentState.rst
 
-Références vers d'autres sections :
-  - :ref:`section_ref_algorithm_ParticleSwarmOptimization`
-  - :ref:`section_ref_algorithm_DifferentialEvolution`
+.. include:: snippets/SimulatedObservationAtOptimum.rst
 
-Références bibliographiques :
-  - [Johnson08]_
-  - [Nelder65]_
-  - [Powell64]_
-  - [Powell94]_
-  - [Powell98]_
-  - [Powell04]_
-  - [Powell07]_
-  - [Powell09]_
-  - [Rowan90]_
+.. ------------------------------------ ..
+.. include:: snippets/Header2Algo06.rst
+
+- :ref:`section_ref_algorithm_ParticleSwarmOptimization`
+- :ref:`section_ref_algorithm_DifferentialEvolution`
+- :ref:`section_ref_algorithm_TabuSearch`
+
+.. ------------------------------------ ..
+.. include:: snippets/Header2Algo07.rst
+
+- [Johnson08]_
+- [Nelder65]_
+- [Powell64]_
+- [Powell94]_
+- [Powell98]_
+- [Powell04]_
+- [Powell07]_
+- [Powell09]_
+- [Rowan90]_