2 Copyright (C) 2008-2023 EDF R&D
4 This file is part of SALOME ADAO module.
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.
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.
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
20 See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
22 Author: Jean-Philippe Argaud, jean-philippe.argaud@edf.fr, EDF R&D
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:
34 Algorithme de tâche "*MeasurementsOptimalPositioningTask*"
35 ----------------------------------------------------------
37 .. ------------------------------------ ..
38 .. include:: snippets/Header2Algo00.rst
42 Cet algorithme n'est utilisable qu'en interface textuelle (TUI) et pas en
43 interface graphique (GUI).
45 .. ------------------------------------ ..
46 .. include:: snippets/Header2Algo01.rst
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}`.
57 Il y a deux manières d'utiliser cet algorithme:
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.
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
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.
78 .. ------------------------------------ ..
79 .. include:: snippets/Header2Algo02.rst
83 .. ------------------------------------ ..
84 .. include:: snippets/Header2Algo03Task.rst
86 .. include:: snippets/EnsembleOfSnapshots.rst
88 .. include:: snippets/ExcludeLocations.rst
90 .. include:: snippets/ErrorNorm.rst
92 .. include:: snippets/ErrorNormTolerance.rst
94 .. include:: snippets/MaximumNumberOfLocations.rst
96 .. include:: snippets/SampleAsExplicitHyperCube.rst
98 .. include:: snippets/SampleAsIndependantRandomVariables.rst
100 .. include:: snippets/SampleAsMinMaxStepHyperCube.rst
102 .. include:: snippets/SampleAsnUplet.rst
104 .. include:: snippets/SetDebug.rst
106 .. include:: snippets/SetSeed.rst
108 StoreSupplementaryCalculations
109 .. index:: single: StoreSupplementaryCalculations
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",
129 ``{"StoreSupplementaryCalculations":["CurrentState", "Residu"]}``
131 .. include:: snippets/Variant_MOP.rst
133 .. ------------------------------------ ..
134 .. include:: snippets/Header2Algo04.rst
136 .. include:: snippets/OptimalPoints.rst
138 .. ------------------------------------ ..
139 .. include:: snippets/Header2Algo05.rst
141 .. include:: snippets/EnsembleOfSimulations.rst
143 .. include:: snippets/EnsembleOfStates.rst
145 .. include:: snippets/OptimalPoints.rst
147 .. include:: snippets/ReducedBasis.rst
149 .. include:: snippets/Residus.rst
151 .. ------------------------------------ ..
152 .. _section_ref_algorithm_MeasurementsOptimalPositioningTask_examples:
154 .. include:: snippets/Header2Algo06.rst
156 - :ref:`section_ref_algorithm_FunctionTest`
157 - :ref:`section_ref_algorithm_ParallelFunctionTest`
158 - :ref:`section_ref_algorithm_EnsembleOfSimulationGenerationTask`
160 .. ------------------------------------ ..
161 .. include:: snippets/Header2Algo07.rst