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