Salome HOME
Updating documentation by review and snippets (4)
[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. Cela implique potentiellement des
65   calculs ou du stockage coûteux. La valeur par défaut est une liste vide,
66   aucune de ces variables n'étant calculée et stockée par défaut. Les noms
67   possibles sont dans la liste suivante : [
68   "OMA",
69   "CurrentState",
70   "CostFunctionJ",
71   "CostFunctionJb",
72   "CostFunctionJo",
73   "SimulatedObservationAtCurrentState",
74   "SimulatedObservationAtOptimum",
75   ].
76
77   Exemple :
78   ``{"StoreSupplementaryCalculations":["OMA", "CurrentState"]}``
79
80 *Astuce pour cet algorithme :*
81
82     Comme les commandes *"Background"* et *"BackgroundError"* sont requises
83     pour TOUS les algorithmes de calcul dans l'interface graphique, vous devez
84     fournir une valeur, malgré le fait que ces commandes ne soient pas
85     nécessaires pour cet algorithme, et ne sont donc pas utilisées. La manière
86     la plus simple est de donner "1" comme un STRING pour les deux.
87
88 .. ------------------------------------ ..
89 .. include:: snippets/Header2Algo04.rst
90
91 .. include:: snippets/Analysis.rst
92
93 .. include:: snippets/CostFunctionJ.rst
94
95 .. include:: snippets/CostFunctionJb.rst
96
97 .. include:: snippets/CostFunctionJo.rst
98
99 .. ------------------------------------ ..
100 .. include:: snippets/Header2Algo05.rst
101
102 .. include:: snippets/OMA.rst
103
104 .. include:: snippets/SimulatedObservationAtOptimum.rst
105
106 .. ------------------------------------ ..
107 .. include:: snippets/Header2Algo06.rst
108
109 - :ref:`section_ref_algorithm_Blue`
110 - :ref:`section_ref_algorithm_ExtendedBlue`
111 - :ref:`section_ref_algorithm_3DVAR`
112 - :ref:`section_ref_algorithm_LinearityTest`