Salome HOME
Code and documentation update for ControledFunctionTest
[modules/adao.git] / doc / fr / ref_algorithm_ExtendedBlue.rst
index 0d766286f5a56e32e55af59408e25c9606abad59..0e47e61b4d5f41be51ad8f49a4155f949e8ae0a9 100644 (file)
@@ -1,5 +1,5 @@
 ..
-   Copyright (C) 2008-2021 EDF R&D
+   Copyright (C) 2008-2023 EDF R&D
 
    This file is part of SALOME ADAO module.
 
@@ -33,13 +33,26 @@ Algorithme de calcul "*ExtendedBlue*"
 Cet algorithme réalise une estimation de type BLUE étendu (Best Linear Unbiased
 Estimator, étendu) de l'état d'un système.
 
-Cet algorithme est une généralisation partiellement non-linéaire de
-l':ref:`section_ref_algorithm_Blue`. Il lui est équivalent pour un opérateur
-d'observation linéaire. On peut vérifier la linéarité de l'opérateur
-d'observation à l'aide de l':ref:`section_ref_algorithm_LinearityTest`.
-
-En non-linéaire, il se rapproche de l':ref:`section_ref_algorithm_3DVAR`, sans
-lui être entièrement équivalent.
+Cet algorithme est une généralisation partiellement non-linéaire d'un
+:ref:`section_ref_algorithm_Blue`. Si l'opérateur d'observation est
+explicitement linéaire, l'algorithme est équivalent à celui du
+:ref:`section_ref_algorithm_Blue`. On peut vérifier la linéarité de l'opérateur
+d'observation à l'aide d'un :ref:`section_ref_algorithm_LinearityTest`.
+
+En non-linéaire, ses résultats se rapprochent d'un
+:ref:`section_ref_algorithm_3DVAR`, sans lui être entièrement équivalent.
+
+Cet algorithme est naturellement écrit pour une estimation unique, sans notion
+dynamique ou itérative (il n'y a donc pas besoin  dans ce cas d'opérateur
+d'évolution incrémentale, ni de covariance d'erreurs d'évolution). Dans ADAO,
+il peut aussi être utilisé sur une succession d'observations, plaçant alors
+l'estimation dans un cadre récursif en partie similaire à un
+:ref:`section_ref_algorithm_KalmanFilter`. Une estimation standard est
+effectuée à chaque pas d'observation sur l'état prévu par le modèle d'évolution
+incrémentale, sachant que la covariance d'erreur d'état reste la covariance
+d'ébauche initialement fournie par l'utilisateur. Pour être explicite,
+contrairement aux filtres de type Kalman, la covariance d'erreurs sur les états
+n'est pas remise à jour.
 
 .. ------------------------------------ ..
 .. include:: snippets/Header2Algo02.rst
@@ -57,6 +70,8 @@ lui être entièrement équivalent.
 .. ------------------------------------ ..
 .. include:: snippets/Header2Algo03AdOp.rst
 
+.. include:: snippets/EstimationOf_Parameters.rst
+
 .. include:: snippets/NumberOfSamplesForQuantiles.rst
 
 .. include:: snippets/Quantiles.rst
@@ -70,13 +85,16 @@ lui être entièrement équivalent.
 StoreSupplementaryCalculations
   .. index:: single: StoreSupplementaryCalculations
 
-  *Liste de noms*. Cette liste indique les noms des variables supplémentaires
+  *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 : [
+  l'algorithme, si elles sont initialement demandées par l'utilisateur. Leur
+  disponibilité implique, potentiellement, des calculs ou du stockage coûteux.
+  La valeur par défaut est donc une liste vide, aucune de ces variables n'étant
+  calculée et stockée par défaut (sauf les variables inconditionnelles). Les
+  noms possibles pour les variables supplémentaires sont dans la liste suivante
+  (la description détaillée de chaque variable nommée est donnée dans la suite
+  de cette documentation par algorithme spécifique, dans la sous-partie
+  "*Informations et variables disponibles à la fin de l'algorithme*") : [
   "Analysis",
   "APosterioriCorrelations",
   "APosterioriCovariance",
@@ -91,7 +109,10 @@ StoreSupplementaryCalculations
   "CostFunctionJoAtCurrentOptimum",
   "CurrentOptimum",
   "CurrentState",
+  "CurrentStepNumber",
+  "ForecastState",
   "Innovation",
+  "InnovationAtCurrentAnalysis",
   "MahalanobisConsistency",
   "OMA",
   "OMB",
@@ -106,7 +127,7 @@ StoreSupplementaryCalculations
   ].
 
   Exemple :
-  ``{"StoreSupplementaryCalculations":["BMA", "CurrentState"]}``
+  ``{"StoreSupplementaryCalculations":["CurrentState", "Residu"]}``
 
 .. ------------------------------------ ..
 .. include:: snippets/Header2Algo04.rst
@@ -144,8 +165,14 @@ StoreSupplementaryCalculations
 
 .. include:: snippets/CurrentState.rst
 
+.. include:: snippets/CurrentStepNumber.rst
+
+.. include:: snippets/ForecastState.rst
+
 .. include:: snippets/Innovation.rst
 
+.. include:: snippets/InnovationAtCurrentAnalysis.rst
+
 .. include:: snippets/MahalanobisConsistency.rst
 
 .. include:: snippets/OMA.rst
@@ -169,6 +196,8 @@ StoreSupplementaryCalculations
 .. include:: snippets/SimulationQuantiles.rst
 
 .. ------------------------------------ ..
+.. _section_ref_algorithm_ExtendedBlue_examples:
+
 .. include:: snippets/Header2Algo09.rst
 
 .. include:: scripts/simple_ExtendedBlue.rst
@@ -178,6 +207,7 @@ StoreSupplementaryCalculations
 .. include:: snippets/Header2Algo10.rst
 
 .. literalinclude:: scripts/simple_ExtendedBlue.res
+    :language: none
 
 .. ------------------------------------ ..
 .. include:: snippets/Header2Algo06.rst