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