Salome HOME
Documentation corrections and modular evolution (2 FR)
[modules/adao.git] / doc / fr / ref_algorithm_ExtendedBlue.rst
1 ..
2    Copyright (C) 2008-2018 EDF R&D
3
4    This file is part of SALOME ADAO module.
5
6    This library is free software; you can redistribute it and/or
7    modify it under the terms of the GNU Lesser General Public
8    License as published by the Free Software Foundation; either
9    version 2.1 of the License, or (at your option) any later version.
10
11    This library is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14    Lesser General Public License for more details.
15
16    You should have received a copy of the GNU Lesser General Public
17    License along with this library; if not, write to the Free Software
18    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
19
20    See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
21
22    Author: Jean-Philippe Argaud, jean-philippe.argaud@edf.fr, EDF R&D
23
24 .. index:: single: ExtendedBlue
25 .. _section_ref_algorithm_ExtendedBlue:
26
27 Algorithme de calcul "*ExtendedBlue*"
28 -------------------------------------
29
30 Description
31 +++++++++++
32
33 Cet algorithme réalise une estimation de type BLUE étendu (Best Linear Unbiased
34 Estimator, étendu) de l'état d'un système.
35
36 Cet algorithme est une généralisation partiellement non-linéaire de
37 l':ref:`section_ref_algorithm_Blue`. Il lui est équivalent pour un opérateur
38 d'observation linéaire. On peut vérifier la linéarité de l'opérateur
39 d'observation à l'aide de l':ref:`section_ref_algorithm_LinearityTest`.
40
41 En non-linéaire, il se rapproche de l':ref:`section_ref_algorithm_3DVAR`, sans
42 lui être entièrement équivalent.
43
44 Commandes requises et optionnelles
45 ++++++++++++++++++++++++++++++++++
46
47 Les commandes requises générales, disponibles dans l'interface en édition, sont
48 les suivantes:
49
50   .. include:: snippets/Background.rst
51
52   .. include:: snippets/BackgroundError.rst
53
54   .. include:: snippets/Observation.rst
55
56   .. include:: snippets/ObservationError.rst
57
58   .. include:: snippets/ObservationOperator.rst
59
60 Les commandes optionnelles générales, disponibles dans l'interface en édition,
61 sont indiquées dans la :ref:`section_ref_assimilation_keywords`. De plus, les
62 paramètres de la commande "*AlgorithmParameters*" permettent d'indiquer les
63 options particulières, décrites ci-après, de l'algorithme. On se reportera à la
64 :ref:`section_ref_options_Algorithm_Parameters` pour le bon usage de cette
65 commande.
66
67 Les options de l'algorithme sont les suivantes:
68
69   StoreSupplementaryCalculations
70     .. index:: single: StoreSupplementaryCalculations
71
72     Cette liste indique les noms des variables supplémentaires qui peuvent être
73     disponibles à la fin de l'algorithme. Cela implique potentiellement des
74     calculs ou du stockage coûteux. La valeur par défaut est une liste vide,
75     aucune de ces variables n'étant calculée et stockée par défaut. Les noms
76     possibles sont dans la liste suivante : ["APosterioriCorrelations",
77     "APosterioriCovariance", "APosterioriStandardDeviations",
78     "APosterioriVariances", "BMA", "OMA", "OMB", "CurrentState",
79     "CostFunctionJ", "CostFunctionJb", "CostFunctionJo", "Innovation",
80     "SigmaBck2", "SigmaObs2", "MahalanobisConsistency", "SimulationQuantiles",
81     "SimulatedObservationAtBackground", "SimulatedObservationAtCurrentState",
82     "SimulatedObservationAtOptimum"].
83
84     Exemple :
85     ``{"StoreSupplementaryCalculations":["BMA", "Innovation"]}``
86
87   .. include:: snippets/Quantiles.rst
88
89   .. include:: snippets/SetSeed.rst
90
91   .. include:: snippets/NumberOfSamplesForQuantiles.rst
92
93   .. include:: snippets/SimulationForQuantiles.rst
94
95 Informations et variables disponibles à la fin de l'algorithme
96 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
97
98 En sortie, après exécution de l'algorithme, on dispose d'informations et de
99 variables issues du calcul. La description des
100 :ref:`section_ref_output_variables` indique la manière de les obtenir par la
101 méthode nommée ``get`` de la variable "*ADD*" du post-processing. Les variables
102 d'entrée, mises à disposition de l'utilisateur en sortie pour faciliter
103 l'écriture des procédures de post-processing, sont décrites dans
104 l':ref:`subsection_r_o_v_Inventaire`.
105
106 Les sorties non conditionnelles de l'algorithme sont les suivantes:
107
108   .. include:: snippets/Analysis.rst
109
110 Les sorties conditionnelles de l'algorithme sont les suivantes:
111
112   .. include:: snippets/APosterioriCorrelations.rst
113
114   .. include:: snippets/APosterioriCovariance.rst
115
116   .. include:: snippets/APosterioriStandardDeviations.rst
117
118   .. include:: snippets/APosterioriVariances.rst
119
120   .. include:: snippets/BMA.rst
121
122   .. include:: snippets/CostFunctionJ.rst
123
124   .. include:: snippets/CostFunctionJb.rst
125
126   .. include:: snippets/CostFunctionJo.rst
127
128   .. include:: snippets/Innovation.rst
129
130   .. include:: snippets/MahalanobisConsistency.rst
131
132   .. include:: snippets/OMA.rst
133
134   .. include:: snippets/OMB.rst
135
136   .. include:: snippets/SigmaBck2.rst
137
138   .. include:: snippets/SigmaObs2.rst
139
140   .. include:: snippets/SimulatedObservationAtBackground.rst
141
142   .. include:: snippets/SimulatedObservationAtOptimum.rst
143
144   .. include:: snippets/SimulationQuantiles.rst
145
146 Voir aussi
147 ++++++++++
148
149 Références vers d'autres sections :
150   - :ref:`section_ref_algorithm_Blue`
151   - :ref:`section_ref_algorithm_3DVAR`
152   - :ref:`section_ref_algorithm_LinearityTest`