doc/fr/ref_algorithm_ExtendedKalmanFilter.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: ExtendedKalmanFilter
  25 .. _section_ref_algorithm_ExtendedKalmanFilter:
  26
  27 Algorithme de calcul "*ExtendedKalmanFilter*"
  28 ---------------------------------------------
  29
  30 Description
  31 +++++++++++
  32
  33 Cet algorithme réalise une estimation de l'état d'un système dynamique par un
  34 filtre de Kalman étendu, utilisant un calcul non linéaire de l'état et de
  35 l'évolution incrémentale (processus).
  36
  37 Dans le cas d'opérateurs réellement non-linéaires, on peut aisément utiliser
  38 l':ref:`section_ref_algorithm_EnsembleKalmanFilter` ou
  39 l':ref:`section_ref_algorithm_UnscentedKalmanFilter`, qui sont souvent
  40 largement plus adaptés aux comportements non-linéaires mais plus coûteux. On
  41 peut vérifier la linéarité des opérateurs à l'aide de
  42 l':ref:`section_ref_algorithm_LinearityTest`.
  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/EvolutionError.rst
  55
  56   .. include:: snippets/EvolutionModel.rst
  57
  58   .. include:: snippets/Observation.rst
  59
  60   .. include:: snippets/ObservationError.rst
  61
  62   .. include:: snippets/ObservationOperator.rst
  63
  64 Les commandes optionnelles générales, disponibles dans l'interface en édition,
  65 sont indiquées dans la :ref:`section_ref_assimilation_keywords`. De plus, les
  66 paramètres de la commande "*AlgorithmParameters*" permettent d'indiquer les
  67 options particulières, décrites ci-après, de l'algorithme. On se reportera à la
  68 :ref:`section_ref_options_Algorithm_Parameters` pour le bon usage de cette
  69 commande.
  70
  71 Les options de l'algorithme sont les suivantes:
  72
  73   .. include:: snippets/BoundsWithExtremes.rst
  74
  75   .. include:: snippets/ConstrainedBy.rst
  76
  77   .. include:: snippets/EstimationOf.rst
  78
  79   StoreSupplementaryCalculations
  80     .. index:: single: StoreSupplementaryCalculations
  81
  82     Cette liste indique les noms des variables supplémentaires qui peuvent être
  83     disponibles à la fin de l'algorithme. Cela implique potentiellement des
  84     calculs ou du stockage coûteux. La valeur par défaut est une liste vide,
  85     aucune de ces variables n'étant calculée et stockée par défaut. Les noms
  86     possibles sont dans la liste suivante : ["APosterioriCorrelations",
  87     "APosterioriCovariance", "APosterioriStandardDeviations",
  88     "APosterioriVariances", "BMA", "CostFunctionJ", "CostFunctionJb",
  89     "CostFunctionJo", "CurrentState", "Innovation"].
  90
  91     Exemple :
  92     ``{"StoreSupplementaryCalculations":["BMA", "Innovation"]}``
  93
  94 Informations et variables disponibles à la fin de l'algorithme
  95 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  96
  97 En sortie, après exécution de l'algorithme, on dispose d'informations et de
  98 variables issues du calcul. La description des
  99 :ref:`section_ref_output_variables` indique la manière de les obtenir par la
 100 méthode nommée ``get`` de la variable "*ADD*" du post-processing. Les variables
 101 d'entrée, mises à disposition de l'utilisateur en sortie pour faciliter
 102 l'écriture des procédures de post-processing, sont décrites dans
 103 l':ref:`subsection_r_o_v_Inventaire`.
 104
 105 Les sorties non conditionnelles de l'algorithme sont les suivantes:
 106
 107   .. include:: snippets/Analysis.rst
 108
 109 Les sorties conditionnelles de l'algorithme sont les suivantes:
 110
 111   .. include:: snippets/APosterioriCorrelations.rst
 112
 113   .. include:: snippets/APosterioriCovariance.rst
 114
 115   .. include:: snippets/APosterioriStandardDeviations.rst
 116
 117   .. include:: snippets/APosterioriVariances.rst
 118
 119   .. include:: snippets/BMA.rst
 120
 121   .. include:: snippets/CostFunctionJ.rst
 122
 123   .. include:: snippets/CostFunctionJb.rst
 124
 125   .. include:: snippets/CostFunctionJo.rst
 126
 127   .. include:: snippets/CurrentState.rst
 128
 129   .. include:: snippets/Innovation.rst
 130
 131 Voir aussi
 132 ++++++++++
 133
 134 Références vers d'autres sections :
 135   - :ref:`section_ref_algorithm_KalmanFilter`
 136   - :ref:`section_ref_algorithm_EnsembleKalmanFilter`
 137   - :ref:`section_ref_algorithm_UnscentedKalmanFilter`