Salome HOME
Updating documentation by review and snippets (15)
[modules/adao.git] / doc / fr / ref_algorithm_LinearLeastSquares.rst
1 ..
2    Copyright (C) 2008-2020 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: LinearLeastSquares
25 .. _section_ref_algorithm_LinearLeastSquares:
26
27 Algorithme de calcul "*LinearLeastSquares*"
28 -------------------------------------------
29
30 .. ------------------------------------ ..
31 .. include:: snippets/Header2Algo01.rst
32
33 Cet algorithme réalise une estimation linéaire de type "Moindres Carrés"
34 pondérés. Il est similaire à l':ref:`section_ref_algorithm_Blue`
35 amputé de sa partie ébauche.
36
37 Cet algorithme est toujours le plus rapide de l'ensemble des algorithmes
38 d'optimisation d'ADAO. Il est théoriquement réservé aux cas d'opérateurs
39 d'observation explicitement linéaires, même s'il fonctionne parfois dans les
40 cas "faiblement" non-linéaire. On peut vérifier la linéarité de l'opérateur
41 d'observation à l'aide de l':ref:`section_ref_algorithm_LinearityTest`.
42
43 Dans tous les cas, il est recommandé de lui préférer au minimum
44 l':ref:`section_ref_algorithm_Blue`, voire
45 l':ref:`section_ref_algorithm_ExtendedBlue` ou
46 l':ref:`section_ref_algorithm_3DVAR`.
47
48 .. ------------------------------------ ..
49 .. include:: snippets/Header2Algo02.rst
50
51 .. include:: snippets/Observation.rst
52
53 .. include:: snippets/ObservationError.rst
54
55 .. include:: snippets/ObservationOperator.rst
56
57 .. ------------------------------------ ..
58 .. include:: snippets/Header2Algo03AdOp.rst
59
60 StoreSupplementaryCalculations
61   .. index:: single: StoreSupplementaryCalculations
62
63   *Liste de noms*. Cette liste indique les noms des variables supplémentaires
64   qui peuvent être disponibles au cours du déroulement ou à la fin de
65   l'algorithme, si elles sont initialement demandées par l'utilisateur. Cela
66   implique potentiellement des calculs ou du stockage coûteux. La valeur par
67   défaut est une liste vide, aucune de ces variables n'étant calculée et
68   stockée par défaut sauf les variables inconditionnelles. Les noms possibles
69   sont dans la liste suivante : [
70   "Analysis",
71   "CostFunctionJ",
72   "CostFunctionJAtCurrentOptimum",
73   "CostFunctionJb",
74   "CostFunctionJbAtCurrentOptimum",
75   "CostFunctionJo",
76   "CostFunctionJoAtCurrentOptimum",
77   "CurrentOptimum",
78   "CurrentState",
79   "OMA",
80   "SimulatedObservationAtCurrentOptimum",
81   "SimulatedObservationAtCurrentState",
82   "SimulatedObservationAtOptimum",
83   ].
84
85   Exemple :
86   ``{"StoreSupplementaryCalculations":["BMA", "CurrentState"]}``
87
88 *Astuce pour cet algorithme :*
89
90     Comme les commandes *"Background"* et *"BackgroundError"* sont requises
91     pour TOUS les algorithmes de calcul dans l'interface graphique, vous devez
92     fournir une valeur, malgré le fait que ces commandes ne soient pas
93     nécessaires pour cet algorithme, et ne sont donc pas utilisées. La manière
94     la plus simple est de donner "1" comme un STRING pour les deux.
95
96 .. ------------------------------------ ..
97 .. include:: snippets/Header2Algo04.rst
98
99 .. include:: snippets/Analysis.rst
100
101 .. include:: snippets/CostFunctionJ.rst
102
103 .. include:: snippets/CostFunctionJb.rst
104
105 .. include:: snippets/CostFunctionJo.rst
106
107 .. ------------------------------------ ..
108 .. include:: snippets/Header2Algo05.rst
109
110 .. include:: snippets/Analysis.rst
111
112 .. include:: snippets/CostFunctionJ.rst
113
114 .. include:: snippets/CostFunctionJAtCurrentOptimum.rst
115
116 .. include:: snippets/CostFunctionJb.rst
117
118 .. include:: snippets/CostFunctionJbAtCurrentOptimum.rst
119
120 .. include:: snippets/CostFunctionJo.rst
121
122 .. include:: snippets/CostFunctionJoAtCurrentOptimum.rst
123
124 .. include:: snippets/CurrentOptimum.rst
125
126 .. include:: snippets/CurrentState.rst
127
128 .. include:: snippets/OMA.rst
129
130 .. include:: snippets/SimulatedObservationAtCurrentOptimum.rst
131
132 .. include:: snippets/SimulatedObservationAtCurrentState.rst
133
134 .. include:: snippets/SimulatedObservationAtOptimum.rst
135
136 .. ------------------------------------ ..
137 .. include:: snippets/Header2Algo06.rst
138
139 - :ref:`section_ref_algorithm_Blue`
140 - :ref:`section_ref_algorithm_ExtendedBlue`
141 - :ref:`section_ref_algorithm_3DVAR`
142 - :ref:`section_ref_algorithm_LinearityTest`