Salome HOME
Documentation for sampling update and examples improvement
[modules/adao.git] / doc / fr / ref_algorithm_EnsembleOfSimulationGenerationTask.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: EnsembleOfSimulationGenerationTask
25 .. index:: single: Génération d'ensemble de simulations
26 .. index:: single: Ensemble de simulations
27 .. index:: single: Ensemble de snapshots
28 .. index:: single: Simulations (Ensemble)
29 .. index:: single: Snapshots (Ensemble)
30 .. _section_ref_algorithm_EnsembleOfSimulationGenerationTask:
31
32 Algorithme de tâche "*EnsembleOfSimulationGenerationTask*"
33 ----------------------------------------------------------
34
35 .. ------------------------------------ ..
36 .. include:: snippets/Header2Algo00.rst
37
38 .. ------------------------------------ ..
39 .. include:: snippets/Header2Algo01.rst
40
41 Cet algorithme permet de générer un ensemble de résultats physiques, de type
42 simulation ou observation, à l'aide de l'opérateur :math:`H` pour un plan
43 d'expérience de l'espace des états :math:`\mathbf{x}` paramétriques. Le
44 résultat de cet algorithme est une collection homogène de vecteurs simulés
45 :math:`\mathbf{y}` (disponible à l'aide de la variable stockable
46 "*EnsembleOfSimulations*") correspondants directement à la collection homogène
47 choisie de vecteurs d'états :math:`\mathbf{x}` (disponible à l'aide de la
48 variable stockable "*EnsembleOfStates*").
49
50 L'échantillonnage des états :math:`\mathbf{x}` peut être fourni explicitement
51 ou sous la forme d'hypercubes, explicites ou échantillonnés selon des
52 distributions courantes, ou à l'aide d'un échantillonnage par hypercube latin
53 (LHS). Les calculs sont optimisés selon les ressources informatiques
54 disponibles et les options demandées par l'utilisateur. On pourra se reporter
55 aux :ref:`section_ref_sampling_requirements` pour une illustration de
56 l'échantillonnage. Attention à la taille de l'hypercube (et donc au nombre de
57 calculs) qu'il est possible d'atteindre, elle peut rapidement devenir
58 importante. Lorsqu'un état n'est pas observable, une valeur *"NaN"* est
59 retournée.
60
61 Pour apparaître pour l'utilisateur tout en réduisant les difficultés de
62 stockage, les résultats de l'échantillonnage ou des simulations doivent être
63 demandés **explicitement** à l'aide de la variable requise.
64
65 Les résultats obtenus avec cet algorithme peuvent être utilisés pour alimenter
66 un :ref:`section_ref_algorithm_MeasurementsOptimalPositioningTask`. De manière
67 complémentaire, et si le but est d'évaluer l'erreur calcul-mesure, un
68 :ref:`section_ref_algorithm_SamplingTest` utilise les mêmes commandes
69 d'échantillonnage pour établir un ensemble de valeurs de fonctionnelle d'erreur
70 :math:`J` à partir d'observations :math:`\mathbf{y}^o`.
71
72 .. ------------------------------------ ..
73 .. include:: snippets/Header2Algo02.rst
74
75 .. include:: snippets/CheckingPoint.rst
76
77 .. include:: snippets/ObservationOperator.rst
78
79 .. ------------------------------------ ..
80 .. include:: snippets/Header2Algo03Task.rst
81
82 .. include:: snippets/SampleAsExplicitHyperCube.rst
83
84 .. include:: snippets/SampleAsIndependantRandomVariables.rst
85
86 .. include:: snippets/SampleAsMinMaxLatinHyperCube.rst
87
88 .. include:: snippets/SampleAsMinMaxStepHyperCube.rst
89
90 .. include:: snippets/SampleAsnUplet.rst
91
92 .. include:: snippets/SetDebug.rst
93
94 .. include:: snippets/SetSeed.rst
95
96 StoreSupplementaryCalculations
97   .. index:: single: StoreSupplementaryCalculations
98
99   *Liste de noms*. Cette liste indique les noms des variables supplémentaires,
100   qui peuvent être disponibles au cours du déroulement ou à la fin de
101   l'algorithme, si elles sont initialement demandées par l'utilisateur. Leur
102   disponibilité implique, potentiellement, des calculs ou du stockage coûteux.
103   La valeur par défaut est donc une liste vide, aucune de ces variables n'étant
104   calculée et stockée par défaut (sauf les variables inconditionnelles). Les
105   noms possibles pour les variables supplémentaires sont dans la liste suivante
106   (la description détaillée de chaque variable nommée est donnée dans la suite
107   de cette documentation par algorithme spécifique, dans la sous-partie
108   "*Informations et variables disponibles à la fin de l'algorithme*") : [
109   "EnsembleOfSimulations",
110   "EnsembleOfStates",
111   ].
112
113   Exemple :
114   ``{"StoreSupplementaryCalculations":["CurrentState", "Residu"]}``
115
116 .. ------------------------------------ ..
117 .. include:: snippets/Header2Algo04.rst
118
119 .. include:: snippets/EnsembleOfSimulations.rst
120
121 .. ------------------------------------ ..
122 .. include:: snippets/Header2Algo05.rst
123
124 .. include:: snippets/EnsembleOfSimulations.rst
125
126 .. include:: snippets/EnsembleOfStates.rst
127
128 .. ------------------------------------ ..
129 .. _section_ref_algorithm_EnsembleOfSimulationGenerationTask_examples:
130
131 .. include:: snippets/Header2Algo06.rst
132
133 - :ref:`section_ref_algorithm_FunctionTest`
134 - :ref:`section_ref_algorithm_ParallelFunctionTest`
135 - :ref:`section_ref_algorithm_MeasurementsOptimalPositioningTask`
136