doc/fr/ref_algorithm_Blue.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: Blue
  25 .. _section_ref_algorithm_Blue:
  26
  27 Algorithme de calcul "*Blue*"
  28 -----------------------------
  29
  30 Description
  31 +++++++++++
  32
  33 Cet algorithme réalise une estimation de type BLUE (Best Linear Unbiased
  34 Estimator) de l'état d'un système. De manière précise, c'est un estimateur
  35 d'Aitken.
  36
  37 Cet algorithme est toujours le plus rapide de l'ensemble des algorithmes
  38 d'assimilation d'ADAO. Il est théoriquement réservé aux cas d'opérateurs
  39 d'observation linéaires, même s'il fonctionne parfois dans les cas "faiblement"
  40 non-linéaires. On peut vérifier la linéarité de l'opérateur d'observation à
  41 l'aide de l':ref:`section_ref_algorithm_LinearityTest`.
  42
  43 En cas de non-linéarité, même peu marquée, on lui préférera aisément
  44 l':ref:`section_ref_algorithm_ExtendedBlue` ou
  45 l':ref:`section_ref_algorithm_3DVAR`.
  46
  47 Commandes requises et optionnelles
  48 ++++++++++++++++++++++++++++++++++
  49
  50 Les commandes requises générales, disponibles dans l'interface en édition, sont
  51 les suivantes:
  52
  53   .. include:: snippets/Background.rst
  54
  55   .. include:: snippets/BackgroundError.rst
  56
  57   .. include:: snippets/Observation.rst
  58
  59   .. include:: snippets/ObservationError.rst
  60
  61   .. include:: snippets/ObservationOperator.rst
  62
  63 Les commandes optionnelles générales, disponibles dans l'interface en édition,
  64 sont indiquées dans la :ref:`section_ref_assimilation_keywords`. De plus, les
  65 paramètres de la commande "*AlgorithmParameters*" permettent d'indiquer les
  66 options particulières, décrites ci-après, de l'algorithme. On se reportera à la
  67 :ref:`section_ref_options_Algorithm_Parameters` pour le bon usage de cette
  68 commande.
  69
  70 Les options de l'algorithme sont les suivantes:
  71
  72   StoreSupplementaryCalculations
  73     .. index:: single: StoreSupplementaryCalculations
  74
  75     Cette liste indique les noms des variables supplémentaires qui peuvent être
  76     disponibles à la fin de l'algorithme. Cela implique potentiellement des
  77     calculs ou du stockage coûteux. La valeur par défaut est une liste vide,
  78     aucune de ces variables n'étant calculée et stockée par défaut. Les noms
  79     possibles sont dans la liste suivante : ["APosterioriCorrelations",
  80     "APosterioriCovariance", "APosterioriStandardDeviations",
  81     "APosterioriVariances", "BMA", "OMA", "OMB", "CurrentState",
  82     "CostFunctionJ", "CostFunctionJb", "CostFunctionJo", "Innovation",
  83     "SigmaBck2", "SigmaObs2", "MahalanobisConsistency", "SimulationQuantiles",
  84     "SimulatedObservationAtBackground", "SimulatedObservationAtCurrentState",
  85     "SimulatedObservationAtOptimum"].
  86
  87     Exemple :
  88     ``{"StoreSupplementaryCalculations":["BMA", "Innovation"]}``
  89
  90   .. include:: snippets/Quantiles.rst
  91
  92   .. include:: snippets/SetSeed.rst
  93
  94   .. include:: snippets/NumberOfSamplesForQuantiles.rst
  95
  96   .. include:: snippets/SimulationForQuantiles.rst
  97
  98 Informations et variables disponibles à la fin de l'algorithme
  99 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 100
 101 En sortie, après exécution de l'algorithme, on dispose d'informations et de
 102 variables issues du calcul. La description des
 103 :ref:`section_ref_output_variables` indique la manière de les obtenir par la
 104 méthode nommée ``get`` de la variable "*ADD*" du post-processing. Les variables
 105 d'entrée, mises à disposition de l'utilisateur en sortie pour faciliter
 106 l'écriture des procédures de post-processing, sont décrites dans
 107 l':ref:`subsection_r_o_v_Inventaire`.
 108
 109 Les sorties non conditionnelles de l'algorithme sont les suivantes:
 110
 111   .. include:: snippets/Analysis.rst
 112
 113 Les sorties conditionnelles de l'algorithme sont les suivantes:
 114
 115   .. include:: snippets/APosterioriCorrelations.rst
 116
 117   .. include:: snippets/APosterioriCovariance.rst
 118
 119   .. include:: snippets/APosterioriStandardDeviations.rst
 120
 121   .. include:: snippets/APosterioriVariances.rst
 122
 123   .. include:: snippets/BMA.rst
 124
 125   .. include:: snippets/CostFunctionJ.rst
 126
 127   .. include:: snippets/CostFunctionJb.rst
 128
 129   .. include:: snippets/CostFunctionJo.rst
 130
 131   .. include:: snippets/Innovation.rst
 132
 133   .. include:: snippets/MahalanobisConsistency.rst
 134
 135   .. include:: snippets/OMA.rst
 136
 137   .. include:: snippets/OMB.rst
 138
 139   .. include:: snippets/SigmaBck2.rst
 140
 141   .. include:: snippets/SigmaObs2.rst
 142
 143   .. include:: snippets/SimulatedObservationAtBackground.rst
 144
 145   .. include:: snippets/SimulatedObservationAtOptimum.rst
 146
 147   .. include:: snippets/SimulationQuantiles.rst
 148
 149 Voir aussi
 150 ++++++++++
 151
 152 Références vers d'autres sections :
 153   - :ref:`section_ref_algorithm_ExtendedBlue`
 154   - :ref:`section_ref_algorithm_3DVAR`
 155   - :ref:`section_ref_algorithm_LinearityTest`
 156
 157 Références bibliographiques :
 158   - [Bouttier99]_