doc/fr/ref_algorithm_KalmanFilter.rst

   1 ..
   2    Copyright (C) 2008-2019 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: KalmanFilter
  25 .. _section_ref_algorithm_KalmanFilter:
  26
  27 Algorithme de calcul "*KalmanFilter*"
  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.
  35
  36 Il est théoriquement réservé aux cas d'opérateurs d'observation et d'évolution
  37 incrémentale (processus) linéaires, même s'il fonctionne parfois dans les cas
  38 "faiblement" non-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 cas de non-linéarité, même peu marquée, on lui préférera
  42 l':ref:`section_ref_algorithm_ExtendedKalmanFilter`, ou
  43 l':ref:`section_ref_algorithm_EnsembleKalmanFilter` et
  44 l':ref:`section_ref_algorithm_UnscentedKalmanFilter` qui sont plus puissants.
  45
  46 Commandes requises et optionnelles
  47 ++++++++++++++++++++++++++++++++++
  48
  49 Les commandes requises générales, disponibles dans l'interface en édition, sont
  50 les suivantes:
  51
  52   .. include:: snippets/Background.rst
  53
  54   .. include:: snippets/BackgroundError.rst
  55
  56   .. include:: snippets/EvolutionError.rst
  57
  58   .. include:: snippets/EvolutionModel.rst
  59
  60   .. include:: snippets/Observation.rst
  61
  62   .. include:: snippets/ObservationError.rst
  63
  64   .. include:: snippets/ObservationOperator.rst
  65
  66 Les commandes optionnelles générales, disponibles dans l'interface en édition,
  67 sont indiquées dans la :ref:`section_ref_assimilation_keywords`. De plus, les
  68 paramètres de la commande "*AlgorithmParameters*" permettent d'indiquer les
  69 options particulières, décrites ci-après, de l'algorithme. On se reportera à la
  70 :ref:`section_ref_options_Algorithm_Parameters` pour le bon usage de cette
  71 commande.
  72
  73 Les options de l'algorithme sont les suivantes:
  74
  75   .. include:: snippets/EstimationOf.rst
  76
  77   StoreSupplementaryCalculations
  78     .. index:: single: StoreSupplementaryCalculations
  79
  80     Cette liste indique les noms des variables supplémentaires qui peuvent être
  81     disponibles à la fin de l'algorithme. Cela implique potentiellement des
  82     calculs ou du stockage coûteux. La valeur par défaut est une liste vide,
  83     aucune de ces variables n'étant calculée et stockée par défaut. Les noms
  84     possibles sont dans la liste suivante : ["APosterioriCorrelations",
  85     "APosterioriCovariance", "APosterioriStandardDeviations",
  86     "APosterioriVariances", "BMA", "CostFunctionJ", "CostFunctionJb",
  87     "CostFunctionJo", "CurrentState", "Innovation"].
  88
  89     Exemple : ``{"StoreSupplementaryCalculations":["BMA", "Innovation"]}``
  90
  91 Informations et variables disponibles à la fin de l'algorithme
  92 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  93
  94 En sortie, après exécution de l'algorithme, on dispose d'informations et de
  95 variables issues du calcul. La description des
  96 :ref:`section_ref_output_variables` indique la manière de les obtenir par la
  97 méthode nommée ``get`` de la variable "*ADD*" du post-processing. Les variables
  98 d'entrée, mises à disposition de l'utilisateur en sortie pour faciliter
  99 l'écriture des procédures de post-processing, sont décrites dans
 100 l':ref:`subsection_r_o_v_Inventaire`.
 101
 102 Les sorties non conditionnelles de l'algorithme sont les suivantes:
 103
 104   .. include:: snippets/Analysis.rst
 105
 106 Les sorties conditionnelles de l'algorithme sont les suivantes:
 107
 108   .. include:: snippets/APosterioriCorrelations.rst
 109
 110   .. include:: snippets/APosterioriCovariance.rst
 111
 112   .. include:: snippets/APosterioriStandardDeviations.rst
 113
 114   .. include:: snippets/APosterioriVariances.rst
 115
 116   .. include:: snippets/BMA.rst
 117
 118   .. include:: snippets/CostFunctionJ.rst
 119
 120   .. include:: snippets/CostFunctionJb.rst
 121
 122   .. include:: snippets/CostFunctionJo.rst
 123
 124   .. include:: snippets/CurrentState.rst
 125
 126   .. include:: snippets/Innovation.rst
 127
 128 Voir aussi
 129 ++++++++++
 130
 131 Références vers d'autres sections :
 132   - :ref:`section_ref_algorithm_ExtendedKalmanFilter`
 133   - :ref:`section_ref_algorithm_EnsembleKalmanFilter`
 134   - :ref:`section_ref_algorithm_UnscentedKalmanFilter`