Salome HOME
Updating documentation by systematic review: FR part
[modules/adao.git] / doc / fr / ref_algorithm_LinearLeastSquares.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: 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   Cette liste indique les noms des variables supplémentaires qui peuvent être
64   disponibles à la fin de l'algorithme, si elles sont initialement demandées par
65   l'utilisateur. Cela implique potentiellement des calculs ou du stockage
66   coûteux. La valeur par défaut est une liste vide, aucune de ces variables
67   n'étant calculée et stockée par défaut sauf les variables inconditionnelles.
68   Les noms possibles sont dans la liste suivante : [
69   "Analysis",
70   "CostFunctionJ",
71   "CostFunctionJAtCurrentOptimum",
72   "CostFunctionJb",
73   "CostFunctionJbAtCurrentOptimum",
74   "CostFunctionJo",
75   "CostFunctionJoAtCurrentOptimum",
76   "CurrentOptimum",
77   "CurrentState",
78   "OMA",
79   "SimulatedObservationAtCurrentOptimum",
80   "SimulatedObservationAtCurrentState",
81   "SimulatedObservationAtOptimum",
82   ].
83
84   Exemple :
85   ``{"StoreSupplementaryCalculations":["BMA", "CurrentState"]}``
86
87 *Astuce pour cet algorithme :*
88
89     Comme les commandes *"Background"* et *"BackgroundError"* sont requises
90     pour TOUS les algorithmes de calcul dans l'interface graphique, vous devez
91     fournir une valeur, malgré le fait que ces commandes ne soient pas
92     nécessaires pour cet algorithme, et ne sont donc pas utilisées. La manière
93     la plus simple est de donner "1" comme un STRING pour les deux.
94
95 .. ------------------------------------ ..
96 .. include:: snippets/Header2Algo04.rst
97
98 .. include:: snippets/Analysis.rst
99
100 .. include:: snippets/CostFunctionJ.rst
101
102 .. include:: snippets/CostFunctionJb.rst
103
104 .. include:: snippets/CostFunctionJo.rst
105
106 .. ------------------------------------ ..
107 .. include:: snippets/Header2Algo05.rst
108
109 .. include:: snippets/Analysis.rst
110
111 .. include:: snippets/CostFunctionJ.rst
112
113 .. include:: snippets/CostFunctionJAtCurrentOptimum.rst
114
115 .. include:: snippets/CostFunctionJb.rst
116
117 .. include:: snippets/CostFunctionJbAtCurrentOptimum.rst
118
119 .. include:: snippets/CostFunctionJo.rst
120
121 .. include:: snippets/CostFunctionJoAtCurrentOptimum.rst
122
123 .. include:: snippets/CurrentOptimum.rst
124
125 .. include:: snippets/CurrentState.rst
126
127 .. include:: snippets/OMA.rst
128
129 .. include:: snippets/SimulatedObservationAtCurrentOptimum.rst
130
131 .. include:: snippets/SimulatedObservationAtCurrentState.rst
132
133 .. include:: snippets/SimulatedObservationAtOptimum.rst
134
135 .. ------------------------------------ ..
136 .. include:: snippets/Header2Algo06.rst
137
138 - :ref:`section_ref_algorithm_Blue`
139 - :ref:`section_ref_algorithm_ExtendedBlue`
140 - :ref:`section_ref_algorithm_3DVAR`
141 - :ref:`section_ref_algorithm_LinearityTest`