doc/fr/ref_algorithm_SamplingTest.rst

   1 ..
   2    Copyright (C) 2008-2023 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: SamplingTest
  25 .. _section_ref_algorithm_SamplingTest:
  26
  27 Algorithme de vérification "*SamplingTest*"
  28 -------------------------------------------
  29
  30 .. ------------------------------------ ..
  31 .. include:: snippets/Header2Algo01.rst
  32
  33 Cet algorithme permet d'établir les valeurs, liées à un état
  34 :math:`\mathbf{x}`, d'une fonctionnelle d'erreur :math:`J` quelconque de type
  35 :math:`L^1`, :math:`L^2` ou :math:`L^{\infty}`, avec ou sans pondérations, et
  36 de l'opérateur d'observation, pour un échantillon d'états :math:`\mathbf{x}`
  37 donné a priori. La fonctionnelle d'erreur par défaut est celle de moindres
  38 carrés pondérés augmentés, classiquement utilisée en assimilation de données,
  39 utilisant des observations :math:`\mathbf{y}^o`.
  40
  41 Il est utile pour tester la sensibilité, de la fonctionnelle :math:`J`, en
  42 particulier, aux variations de l'état :math:`\mathbf{x}`. Lorsque un état n'est
  43 pas observable, une valeur *"NaN"* est retournée.
  44
  45 L'échantillonnage des états :math:`\mathbf{x}` peut être fourni explicitement
  46 ou sous la forme d'hyper-cubes, explicites ou échantillonnés selon des
  47 distributions courantes. Attention à la taille de l'hyper-cube (et donc au
  48 nombre de calculs) qu'il est possible d'atteindre, elle peut rapidement devenir
  49 importante.
  50
  51 Pour apparaître pour l'utilisateur tout en réduisant les difficultés de
  52 stockage, les résultats de l'échantillonnage ou des simulations doivent être
  53 demandés **explicitement**. On utilise pour cela, sur la variable désirée, la
  54 sauvegarde finale à l'aide du mot-clé "*UserPostAnalysis*" ou le traitement en
  55 cours de calcul à l'aide des "*observer*" adaptés.
  56
  57 Pour effectuer un échantillonnage distribué ou plus complexe, voir le module
  58 OPENTURNS disponible dans SALOME.
  59
  60 .. ------------------------------------ ..
  61 .. include:: snippets/Header2Algo02.rst
  62
  63 .. include:: snippets/CheckingPoint.rst
  64
  65 .. include:: snippets/BackgroundError.rst
  66
  67 .. include:: snippets/Observation.rst
  68
  69 .. include:: snippets/ObservationError.rst
  70
  71 .. include:: snippets/ObservationOperator.rst
  72
  73 .. ------------------------------------ ..
  74 .. include:: snippets/Header2Algo03Chck.rst
  75
  76 .. include:: snippets/QualityCriterion.rst
  77
  78 .. include:: snippets/SampleAsExplicitHyperCube.rst
  79
  80 .. include:: snippets/SampleAsIndependantRandomVariables.rst
  81
  82 .. include:: snippets/SampleAsMinMaxStepHyperCube.rst
  83
  84 .. include:: snippets/SampleAsnUplet.rst
  85
  86 .. include:: snippets/SetDebug.rst
  87
  88 .. include:: snippets/SetSeed.rst
  89
  90 StoreSupplementaryCalculations
  91   .. index:: single: StoreSupplementaryCalculations
  92
  93   *Liste de noms*. Cette liste indique les noms des variables supplémentaires,
  94   qui peuvent être disponibles au cours du déroulement ou à la fin de
  95   l'algorithme, si elles sont initialement demandées par l'utilisateur. Leur
  96   disponibilité implique, potentiellement, des calculs ou du stockage coûteux.
  97   La valeur par défaut est donc une liste vide, aucune de ces variables n'étant
  98   calculée et stockée par défaut (sauf les variables inconditionnelles). Les
  99   noms possibles pour les variables supplémentaires sont dans la liste suivante
 100   (la description détaillée de chaque variable nommée est donnée dans la suite
 101   de cette documentation par algorithme spécifique, dans la sous-partie
 102   "*Informations et variables disponibles à la fin de l'algorithme*") : [
 103   "CostFunctionJ",
 104   "CostFunctionJb",
 105   "CostFunctionJo",
 106   "CurrentState",
 107   "EnsembleOfSimulations",
 108   "EnsembleOfStates",
 109   "Innovation",
 110   "InnovationAtCurrentState",
 111   "SimulatedObservationAtCurrentState",
 112   ].
 113
 114   Exemple :
 115   ``{"StoreSupplementaryCalculations":["CurrentState", "Residu"]}``
 116
 117 .. ------------------------------------ ..
 118 .. include:: snippets/Header2Algo04.rst
 119
 120 .. include:: snippets/CostFunctionJ.rst
 121
 122 .. include:: snippets/CostFunctionJb.rst
 123
 124 .. include:: snippets/CostFunctionJo.rst
 125
 126 .. ------------------------------------ ..
 127 .. include:: snippets/Header2Algo05.rst
 128
 129 .. include:: snippets/CostFunctionJ.rst
 130
 131 .. include:: snippets/CostFunctionJb.rst
 132
 133 .. include:: snippets/CostFunctionJo.rst
 134
 135 .. include:: snippets/CurrentState.rst
 136
 137 .. include:: snippets/EnsembleOfSimulations.rst
 138
 139 .. include:: snippets/EnsembleOfStates.rst
 140
 141 .. include:: snippets/Innovation.rst
 142
 143 .. include:: snippets/InnovationAtCurrentState.rst
 144
 145 .. include:: snippets/SimulatedObservationAtCurrentState.rst
 146
 147 .. ------------------------------------ ..
 148 .. _section_ref_algorithm_SamplingTest_examples:
 149
 150 .. include:: snippets/Header2Algo06.rst
 151
 152 - :ref:`section_ref_algorithm_FunctionTest`
 153 - :ref:`section_ref_algorithm_LocalSensitivityTest`
 154
 155 .. ------------------------------------ ..
 156 .. include:: snippets/Header2Algo08.rst
 157
 158 - OPENTURNS, voir le *Guide utilisateur du module OPENTURNS* dans le menu principal *Aide* de l'environnement SALOME