doc/fr/ref_algorithm_QuantileRegression.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: QuantileRegression
  25 .. _section_ref_algorithm_QuantileRegression:
  26
  27 Algorithme de calcul "*QuantileRegression*"
  28 -------------------------------------------
  29
  30 Description
  31 +++++++++++
  32
  33 Cet algorithme permet d'estimer les quantiles conditionnels de la distribution
  34 des paramètres d'état, exprimés à l'aide d'un modèle des variables observées. Ce
  35 sont donc les quantiles sur les variables observées qui vont permettre de
  36 déterminer les paramètres de modèles satisfaisant aux conditions de quantiles.
  37
  38 Commandes requises et optionnelles
  39 ++++++++++++++++++++++++++++++++++
  40
  41 Les commandes requises générales, disponibles dans l'interface en édition, sont
  42 les suivantes:
  43
  44   .. include:: snippets/Background.rst
  45
  46   .. include:: snippets/Observation.rst
  47
  48   .. include:: snippets/ObservationOperator.rst
  49
  50 Les commandes optionnelles générales, disponibles dans l'interface en édition,
  51 sont indiquées dans la :ref:`section_ref_assimilation_keywords`. De plus, les
  52 paramètres de la commande "*AlgorithmParameters*" permettent d'indiquer les
  53 options particulières, décrites ci-après, de l'algorithme. On se reportera à la
  54 :ref:`section_ref_options_Algorithm_Parameters` pour le bon usage de cette
  55 commande.
  56
  57 Les options de l'algorithme sont les suivantes:
  58
  59   .. include:: snippets/Quantile.rst
  60
  61   .. include:: snippets/MaximumNumberOfSteps.rst
  62
  63   .. include:: snippets/CostDecrementTolerance_6.rst
  64
  65   .. include:: snippets/BoundsWithNone.rst
  66
  67   StoreSupplementaryCalculations
  68     .. index:: single: StoreSupplementaryCalculations
  69
  70     Cette liste indique les noms des variables supplémentaires qui peuvent être
  71     disponibles à la fin de l'algorithme. Cela implique potentiellement des
  72     calculs ou du stockage coûteux. La valeur par défaut est une liste vide,
  73     aucune de ces variables n'étant calculée et stockée par défaut. Les noms
  74     possibles sont dans la liste suivante : ["BMA", "CostFunctionJ",
  75     "CostFunctionJb", "CostFunctionJo", "CurrentState", "OMA", "OMB",
  76     "Innovation", "SimulatedObservationAtBackground",
  77     "SimulatedObservationAtCurrentState", "SimulatedObservationAtOptimum"].
  78
  79     Exemple :
  80     ``{"StoreSupplementaryCalculations":["BMA", "Innovation"]}``
  81
  82 *Astuce pour cet algorithme :*
  83
  84     Comme les commandes *"BackgroundError"* et *"ObservationError"* sont
  85     requises pour TOUS les algorithmes de calcul dans l'interface graphique,
  86     vous devez fournir une valeur, malgré le fait que ces commandes ne sont pas
  87     requises pour cet algorithme, et ne seront pas utilisées. La manière la
  88     plus simple est de donner "1" comme un STRING pour les deux.
  89
  90 Informations et variables disponibles à la fin de l'algorithme
  91 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  92
  93 En sortie, après exécution de l'algorithme, on dispose d'informations et de
  94 variables issues du calcul. La description des
  95 :ref:`section_ref_output_variables` indique la manière de les obtenir par la
  96 méthode nommée ``get`` de la variable "*ADD*" du post-processing. Les variables
  97 d'entrée, mises à disposition de l'utilisateur en sortie pour faciliter
  98 l'écriture des procédures de post-processing, sont décrites dans
  99 l':ref:`subsection_r_o_v_Inventaire`.
 100
 101 Les sorties non conditionnelles de l'algorithme sont les suivantes:
 102
 103   .. include:: snippets/Analysis.rst
 104
 105   .. include:: snippets/CostFunctionJ.rst
 106
 107   .. include:: snippets/CostFunctionJb.rst
 108
 109   .. include:: snippets/CostFunctionJo.rst
 110
 111 Les sorties conditionnelles de l'algorithme sont les suivantes:
 112
 113   .. include:: snippets/BMA.rst
 114
 115   .. include:: snippets/CurrentState.rst
 116
 117   .. include:: snippets/Innovation.rst
 118
 119   .. include:: snippets/OMA.rst
 120
 121   .. include:: snippets/OMB.rst
 122
 123   .. include:: snippets/SimulatedObservationAtBackground.rst
 124
 125   .. include:: snippets/SimulatedObservationAtCurrentState.rst
 126
 127   .. include:: snippets/SimulatedObservationAtOptimum.rst
 128
 129 Voir aussi
 130 ++++++++++
 131
 132 Références bibliographiques :
 133   - [Buchinsky98]_
 134   - [Cade03]_
 135   - [Koenker00]_
 136   - [Koenker01]_
 137   - [WikipediaQR]_