Code and documentation update for ControledFunctionTest

[modules/adao.git] / doc / fr / ref_algorithm_ExtendedBlue.rst

diff --git a/doc/fr/ref_algorithm_ExtendedBlue.rst b/doc/fr/ref_algorithm_ExtendedBlue.rst
index 7495c73f3c36cb04d5fce07308cb298533f44ebf..0e47e61b4d5f41be51ad8f49a4155f949e8ae0a9 100644 (file)
--- a/doc/fr/ref_algorithm_ExtendedBlue.rst
+++ b/doc/fr/ref_algorithm_ExtendedBlue.rst
@@ -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
@@ -94,7 +109,10 @@ StoreSupplementaryCalculations
   "CostFunctionJoAtCurrentOptimum",
   "CurrentOptimum",
   "CurrentState",
+  "CurrentStepNumber",
+  "ForecastState",
   "Innovation",
+  "InnovationAtCurrentAnalysis",
   "MahalanobisConsistency",
   "OMA",
   "OMB",
@@ -109,7 +127,7 @@ StoreSupplementaryCalculations
   ].
 
   Exemple :
-  ``{"StoreSupplementaryCalculations":["BMA", "CurrentState"]}``
+  ``{"StoreSupplementaryCalculations":["CurrentState", "Residu"]}``
 
 .. ------------------------------------ ..
 .. include:: snippets/Header2Algo04.rst
@@ -147,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
@@ -172,6 +196,8 @@ StoreSupplementaryCalculations
 .. include:: snippets/SimulationQuantiles.rst
 
 .. ------------------------------------ ..
+.. _section_ref_algorithm_ExtendedBlue_examples:
+
 .. include:: snippets/Header2Algo09.rst
 
 .. include:: scripts/simple_ExtendedBlue.rst
@@ -181,6 +207,7 @@ StoreSupplementaryCalculations
 .. include:: snippets/Header2Algo10.rst
 
 .. literalinclude:: scripts/simple_ExtendedBlue.res
+    :language: none
 
 .. ------------------------------------ ..
 .. include:: snippets/Header2Algo06.rst