doc/fr/ref_algorithm_MeasurementsOptimalPositioningTask.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: MeasurementsOptimalPositioningTask
  25 .. index:: single: Positionnement optimal de mesures
  26 .. index:: single: Positions de mesures
  27 .. index:: single: Mesures (Positionnement optimal)
  28 .. index:: single: Ensemble de simulations
  29 .. index:: single: Ensemble de snapshots
  30 .. index:: single: Simulations (Ensemble)
  31 .. index:: single: Snapshots (Ensemble)
  32 .. _section_ref_algorithm_MeasurementsOptimalPositioningTask:
  33
  34 Algorithme de tâche "*MeasurementsOptimalPositioningTask*"
  35 ----------------------------------------------------------
  36
  37 .. ------------------------------------ ..
  38 .. include:: snippets/Header2Algo00.rst
  39
  40 .. warning::
  41
  42   Cet algorithme n'est utilisable qu'en interface textuelle (TUI) et pas en
  43   interface graphique (GUI).
  44
  45 .. ------------------------------------ ..
  46 .. include:: snippets/Header2Algo01.rst
  47
  48 Cet algorithme permet d'établir la position de points de mesures optimaux par
  49 une analyse EIM (Empirical Interpolation Method). Ces positions sont
  50 déterminées de manière itérative, à partir d'un ensemble de vecteurs d'état
  51 pré-existants (usuellement appelés "*snapshots*" en méthodologie de bases
  52 réduites) ou obtenus par une simulation directe au cours de l'algorithme.
  53 Chacun de ces vecteurs d'état est habituellement (mais pas obligatoirement) le
  54 résultat :math:`\mathbf{y}` d'une simulation ou d'une observation à l'aide de
  55 l'opérateur :math:`H` pour un jeu de paramètres donné :math:`\mathbf{x}`.
  56
  57 Il y a deux manières d'utiliser cet algorithme:
  58
  59 #. Dans son usage le plus simple, si l'ensemble des vecteurs d'état est
  60    pré-existant, il suffit de le fournir par l'option "*EnsembleOfSnapshots*"
  61    d'algorithme. C'est par exemple le cas l'ensemble des états a été généré par
  62    un :ref:`section_ref_algorithm_EnsembleOfSimulationGenerationTask`.
  63 #. Si l'ensemble des vecteurs d'état doit être obtenu par des simulations au
  64    cours de l'algorithme, alors on doit fournir l'opérateur de simulation ou
  65    d'observation :math:`H` et le plan d'expérience de l'espace des états
  66    :math:`\mathbf{x}` paramétriques.
  67
  68 L'échantillonnage des états :math:`\mathbf{x}` peut être fourni explicitement
  69 ou sous la forme d'hyper-cubes, explicites ou échantillonnés selon des
  70 distributions courantes. Attention à la taille de l'hyper-cube (et donc au
  71 nombre de calculs) qu'il est possible d'atteindre, elle peut rapidement devenir
  72 importante.
  73
  74 Il est possible d'exclure a priori des positions potentielles pour les points
  75 de mesures optimaux, en utilisant le variant "*lcEIM*" d'analyse pour une
  76 recherche de positionnement contraint.
  77
  78 .. ------------------------------------ ..
  79 .. include:: snippets/Header2Algo02.rst
  80
  81 *Aucune*
  82
  83 .. ------------------------------------ ..
  84 .. include:: snippets/Header2Algo03Task.rst
  85
  86 .. include:: snippets/EnsembleOfSnapshots.rst
  87
  88 .. include:: snippets/ExcludeLocations.rst
  89
  90 .. include:: snippets/ErrorNorm.rst
  91
  92 .. include:: snippets/ErrorNormTolerance.rst
  93
  94 .. include:: snippets/MaximumNumberOfLocations.rst
  95
  96 .. include:: snippets/SampleAsExplicitHyperCube.rst
  97
  98 .. include:: snippets/SampleAsIndependantRandomVariables.rst
  99
 100 .. include:: snippets/SampleAsMinMaxStepHyperCube.rst
 101
 102 .. include:: snippets/SampleAsnUplet.rst
 103
 104 .. include:: snippets/SetDebug.rst
 105
 106 .. include:: snippets/SetSeed.rst
 107
 108 StoreSupplementaryCalculations
 109   .. index:: single: StoreSupplementaryCalculations
 110
 111   *Liste de noms*. Cette liste indique les noms des variables supplémentaires,
 112   qui peuvent être disponibles au cours du déroulement ou à la fin de
 113   l'algorithme, si elles sont initialement demandées par l'utilisateur. Leur
 114   disponibilité implique, potentiellement, des calculs ou du stockage coûteux.
 115   La valeur par défaut est donc une liste vide, aucune de ces variables n'étant
 116   calculée et stockée par défaut (sauf les variables inconditionnelles). Les
 117   noms possibles pour les variables supplémentaires sont dans la liste suivante
 118   (la description détaillée de chaque variable nommée est donnée dans la suite
 119   de cette documentation par algorithme spécifique, dans la sous-partie
 120   "*Informations et variables disponibles à la fin de l'algorithme*") : [
 121   "EnsembleOfSimulations",
 122   "EnsembleOfStates",
 123   "OptimalPoints",
 124   "ReducedBasis",
 125   "Residus",
 126   ].
 127
 128   Exemple :
 129   ``{"StoreSupplementaryCalculations":["CurrentState", "Residu"]}``
 130
 131 .. include:: snippets/Variant_MOP.rst
 132
 133 .. ------------------------------------ ..
 134 .. include:: snippets/Header2Algo04.rst
 135
 136 .. include:: snippets/OptimalPoints.rst
 137
 138 .. ------------------------------------ ..
 139 .. include:: snippets/Header2Algo05.rst
 140
 141 .. include:: snippets/EnsembleOfSimulations.rst
 142
 143 .. include:: snippets/EnsembleOfStates.rst
 144
 145 .. include:: snippets/OptimalPoints.rst
 146
 147 .. include:: snippets/ReducedBasis.rst
 148
 149 .. include:: snippets/Residus.rst
 150
 151 .. ------------------------------------ ..
 152 .. _section_ref_algorithm_MeasurementsOptimalPositioningTask_examples:
 153 .. include:: snippets/Header2Algo06.rst
 154
 155 - :ref:`section_ref_algorithm_FunctionTest`
 156 - :ref:`section_ref_algorithm_ParallelFunctionTest`
 157 - :ref:`section_ref_algorithm_EnsembleOfSimulationGenerationTask`
 158
 159 .. ------------------------------------ ..
 160 .. include:: snippets/Header2Algo07.rst
 161
 162 - [Barrault04]_
 163 - [Gong18]_
 164 - [Quarteroni16]_