Salome HOME
Updating documentation by systematic review: FR part
[modules/adao.git] / doc / fr / ref_algorithm_AdjointTest.rst
1 ..
2    Copyright (C) 2008-2019 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: AdjointTest
25 .. _section_ref_algorithm_AdjointTest:
26
27 Algorithme de vérification "*AdjointTest*"
28 ------------------------------------------
29
30 .. ------------------------------------ ..
31 .. include:: snippets/Header2Algo01.rst
32
33 Cet algorithme permet de vérifier la qualité de l'opérateur adjoint, en
34 calculant un résidu dont les propriétés théoriques sont connues.
35
36 On observe le résidu suivant, qui est la différence de deux produits scalaires :
37
38 .. math:: R(\alpha) = | < TangentF_x(\mathbf{dx}) , \mathbf{y} > - < \mathbf{dx} , AdjointF_x(\mathbf{y}) > |
39
40 qui doit rester constamment égal à zéro à la précision du calcul. On prend
41 :math:`\mathbf{dx}_0=Normal(0,\mathbf{x})` et
42 :math:`\mathbf{dx}=\alpha*\mathbf{dx}_0`. :math:`F` est le code de calcul.
43 :math:`\mathbf{y}` doit être dans l'image de :math:`F`. S'il n'est pas donné,
44 on prend :math:`\mathbf{y} = F(\mathbf{x})`.
45
46 .. ------------------------------------ ..
47 .. include:: snippets/Header2Algo02.rst
48
49 .. include:: snippets/CheckingPoint.rst
50
51 .. include:: snippets/ObservationOperator.rst
52
53 .. ------------------------------------ ..
54 .. include:: snippets/Header2Algo03Chck.rst
55
56 .. include:: snippets/AmplitudeOfInitialDirection.rst
57
58 .. include:: snippets/EpsilonMinimumExponent.rst
59
60 .. include:: snippets/InitialDirection.rst
61
62 .. include:: snippets/SetSeed.rst
63
64 StoreSupplementaryCalculations
65   .. index:: single: StoreSupplementaryCalculations
66
67   Cette liste indique les noms des variables supplémentaires qui peuvent être
68   disponibles à la fin de l'algorithme, si elles sont initialement demandées par
69   l'utilisateur. Cela implique potentiellement des calculs ou du stockage
70   coûteux. La valeur par défaut est une liste vide, aucune de ces variables
71   n'étant calculée et stockée par défaut sauf les variables inconditionnelles.
72   Les noms possibles sont dans la liste suivante : [
73   "CurrentState",
74   "Residu",
75   "SimulatedObservationAtCurrentState",
76   ].
77
78   Exemple :
79   ``{"StoreSupplementaryCalculations":["BMA", "CurrentState"]}``
80
81 .. ------------------------------------ ..
82 .. include:: snippets/Header2Algo04.rst
83
84 .. include:: snippets/Residu.rst
85
86 .. ------------------------------------ ..
87 .. include:: snippets/Header2Algo05.rst
88
89 .. include:: snippets/CurrentState.rst
90
91 .. include:: snippets/Residu.rst
92
93 .. include:: snippets/SimulatedObservationAtCurrentState.rst
94
95 .. ------------------------------------ ..
96 .. include:: snippets/Header2Algo06.rst
97
98 - :ref:`section_ref_algorithm_FunctionTest`
99 - :ref:`section_ref_algorithm_LinearityTest`
100 - :ref:`section_ref_algorithm_TangentTest`
101 - :ref:`section_ref_algorithm_GradientTest`
102 - :ref:`section_ref_algorithm_LocalSensitivityTest`