..
- Copyright (C) 2008-2019 EDF R&D
+ Copyright (C) 2008-2023 EDF R&D
This file is part of SALOME ADAO module.
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
.. ------------------------------------ ..
.. include:: snippets/Header2Algo03AdOp.rst
+.. include:: snippets/EstimationOf_Parameters.rst
+
.. include:: snippets/NumberOfSamplesForQuantiles.rst
.. include:: snippets/Quantiles.rst
.. include:: snippets/SimulationForQuantiles.rst
+.. include:: snippets/StateBoundsForQuantilesWithNone.rst
+
StoreSupplementaryCalculations
.. index:: single: StoreSupplementaryCalculations
- 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 : [
+ *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. 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",
"APosterioriStandardDeviations",
"APosterioriVariances",
"BMA",
- "OMA",
- "OMB",
- "CurrentState",
"CostFunctionJ",
+ "CostFunctionJAtCurrentOptimum",
"CostFunctionJb",
+ "CostFunctionJbAtCurrentOptimum",
"CostFunctionJo",
+ "CostFunctionJoAtCurrentOptimum",
+ "CurrentOptimum",
+ "CurrentState",
+ "CurrentStepNumber",
+ "ForecastState",
"Innovation",
+ "InnovationAtCurrentAnalysis",
+ "MahalanobisConsistency",
+ "OMA",
+ "OMB",
+ "SampledStateForQuantiles",
"SigmaBck2",
"SigmaObs2",
- "MahalanobisConsistency",
- "SimulationQuantiles",
"SimulatedObservationAtBackground",
+ "SimulatedObservationAtCurrentOptimum",
"SimulatedObservationAtCurrentState",
- "SimulatedObservationAtOptimum",
+ "SimulatedObservationAtOptimum",
+ "SimulationQuantiles",
].
Exemple :
- ``{"StoreSupplementaryCalculations":["BMA", "Innovation"]}``
+ ``{"StoreSupplementaryCalculations":["CurrentState", "Residu"]}``
.. ------------------------------------ ..
.. include:: snippets/Header2Algo04.rst
.. ------------------------------------ ..
.. include:: snippets/Header2Algo05.rst
+.. include:: snippets/Analysis.rst
+
.. include:: snippets/APosterioriCorrelations.rst
.. include:: snippets/APosterioriCovariance.rst
.. include:: snippets/CostFunctionJ.rst
+.. include:: snippets/CostFunctionJAtCurrentOptimum.rst
+
.. include:: snippets/CostFunctionJb.rst
+.. include:: snippets/CostFunctionJbAtCurrentOptimum.rst
+
.. include:: snippets/CostFunctionJo.rst
+.. include:: snippets/CostFunctionJoAtCurrentOptimum.rst
+
+.. include:: snippets/CurrentOptimum.rst
+
+.. 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
.. include:: snippets/OMB.rst
+.. include:: snippets/SampledStateForQuantiles.rst
+
.. include:: snippets/SigmaBck2.rst
.. include:: snippets/SigmaObs2.rst
.. include:: snippets/SimulatedObservationAtBackground.rst
+.. include:: snippets/SimulatedObservationAtCurrentOptimum.rst
+
+.. include:: snippets/SimulatedObservationAtCurrentState.rst
+
.. include:: snippets/SimulatedObservationAtOptimum.rst
.. include:: snippets/SimulationQuantiles.rst
+.. ------------------------------------ ..
+.. _section_ref_algorithm_ExtendedBlue_examples:
+
+.. include:: snippets/Header2Algo09.rst
+
+.. include:: scripts/simple_ExtendedBlue.rst
+
+.. literalinclude:: scripts/simple_ExtendedBlue.py
+
+.. include:: snippets/Header2Algo10.rst
+
+.. literalinclude:: scripts/simple_ExtendedBlue.res
+ :language: none
+
.. ------------------------------------ ..
.. include:: snippets/Header2Algo06.rst