Salome HOME
Documentation update with features and review corrections
[modules/adao.git] / doc / fr / ref_algorithm_InterpolationByReducedModelTask.rst
1 ..
2    Copyright (C) 2008-2024 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: InterpolationByReducedModelTask
25 .. index:: single: Interpolation de mesures
26 .. index:: single: Reconstruction de champ
27 .. index:: single: Snapshots (Ensemble)
28 .. index:: single: Reduced Order Model
29 .. index:: single: ROM
30 .. _section_ref_algorithm_InterpolationByReducedModelTask:
31
32 Algorithme de tâche "*InterpolationByReducedModelTask*"
33 -------------------------------------------------------
34
35 .. ------------------------------------ ..
36 .. include:: snippets/Header2Algo99.rst
37
38 .. ------------------------------------ ..
39 .. include:: snippets/Header2Algo00.rst
40
41 .. ------------------------------------ ..
42 .. include:: snippets/Header2Algo01.rst
43
44 Cet algorithme permet de réaliser une interpolation très efficace de mesures
45 physiques à l'aide d'une représentation réduite du modèle pour cette physique.
46 On obtient en sortie, pour chaque jeu de mesures fournies aux positions
47 requises, un champ complet :math:`\mathbf{y}` par interpolation. Dit autrement,
48 c'est une reconstruction de champ physique à l'aide de mesures et d'un modèle
49 numérique réduit.
50
51 Pour interpoler ces mesures, on utilise une méthode de type Empirical
52 Interpolation Method (EIM [Barrault04]_), qui utilise un modèle réduit de type
53 Reduced Order Model (ROM) provenant d'une décomposition EIM or DEIM, avec ou
54 sans contraintes de positionnement de mesures.
55
56 Pour utiliser cet algorithme, il faut disposer des mesures optimalement
57 positionnées et de la base réduite associée pour la représentation du modèle.
58 C'est réalisable selon le schéma suivant, par une analyse préalable à l'aide
59 d'un :ref:`section_ref_algorithm_MeasurementsOptimalPositioningTask`, qui
60 fournit positions et base. Une fois la base construite et les positions
61 déterminées, il peut être réalisé autant d'interpolations que l'on a de jeu de
62 mesures aux positions requises, sans devoir refaire l'analyse préalable.
63
64   .. _irm_determination:
65   .. image:: images/irm_determination.png
66     :align: center
67     :width: 95%
68   .. centered::
69     **Schéma général d'utilisation de l'algorithme**
70
71 .. ------------------------------------ ..
72 .. include:: snippets/Header2Algo12.rst
73
74 .. include:: snippets/FeaturePropDerivativeFree.rst
75
76 .. ------------------------------------ ..
77 .. include:: snippets/Header2Algo02.rst
78
79 .. include:: snippets/Observation.rst
80
81 .. ------------------------------------ ..
82 .. include:: snippets/Header2Algo03Task.rst
83
84 .. include:: snippets/ObservationsAlreadyRestrictedOnOptimalLocations.rst
85
86 .. include:: snippets/OptimalLocations.rst
87
88 .. include:: snippets/ReducedBasis.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   "Analysis",
104   "ReducedCoordinates",
105   ].
106
107   Exemple :
108   ``{"StoreSupplementaryCalculations":["CurrentState", "Residu"]}``
109
110 .. ------------------------------------ ..
111 .. include:: snippets/Header2Algo04.rst
112
113 .. include:: snippets/Analysis.rst
114
115 .. ------------------------------------ ..
116 .. include:: snippets/Header2Algo05.rst
117
118 .. include:: snippets/Analysis.rst
119
120 .. include:: snippets/ReducedCoordinates.rst
121
122 .. ------------------------------------ ..
123 .. _section_ref_algorithm_InterpolationByReducedModelTask_examples:
124
125 .. include:: snippets/Header2Algo09.rst
126
127 .. --------- ..
128 .. include:: scripts/simple_InterpolationByReducedModelTask1.rst
129
130 .. literalinclude:: scripts/simple_InterpolationByReducedModelTask1.py
131
132 .. include:: snippets/Header2Algo10.rst
133
134 .. literalinclude:: scripts/simple_InterpolationByReducedModelTask1.res
135     :language: none
136
137 .. ------------------------------------ ..
138 .. include:: snippets/Header2Algo06.rst
139
140 - :ref:`section_ref_algorithm_MeasurementsOptimalPositioningTask`
141
142 .. ------------------------------------ ..
143 .. include:: snippets/Header2Algo07.rst
144
145 - [Barrault04]_
146 - [Quarteroni16]_