Documentation improvements and post analysis

[modules/adao.git] / doc / fr / ref_algorithm_3DVAR.rst

diff --git a/doc/fr/ref_algorithm_3DVAR.rst b/doc/fr/ref_algorithm_3DVAR.rst
index 6fadb6f08c58af958d7091799c0da8d6dd908322..faf5b493b2255d340d762745be747b09048297ec 100644 (file)
--- a/doc/fr/ref_algorithm_3DVAR.rst
+++ b/doc/fr/ref_algorithm_3DVAR.rst
@@ -41,7 +41,8 @@ qui est usuellement désignée comme la fonctionnelle "*3D-Var*" (voir par
 exemple [Talagrand97]_). Les dénominations "*3D-Var*", "*3D-VAR*" et "*3DVAR*"
 sont équivalentes.
 
-Il existe diverses variantes de cet algorithme. On propose ici des formulations stables et robustes suivantes :
+Il existe diverses variantes de cet algorithme. On propose ici les formulations
+stables et robustes suivantes :
 
 .. index::
     pair: Variant ; 3DVAR
@@ -49,12 +50,14 @@ Il existe diverses variantes de cet algorithme. On propose ici des formulations
     pair: Variant ; 3DVAR-Incr
     pair: Variant ; 3DVAR-PSAS
 
-- "3DVAR" (3D Variational analysis, voir [Lorenc86]_, [LeDimet86]_, [Talagrand97]_), algorithme d'origine et très robuste,
-- "3DVAR-VAN" (3D Variational Analysis with No inversion of B, voir [Lorenc88]_), algorithme similaire mais permettant d'éviter l'inversion de la matrice de covariance B,
-- "3DVAR-Incr" (Incremental 3DVAR, voir [Courtier94]_), algorithme plus économique mais impliquant une approximation des opérateurs non-linéaires,
-- "3DVAR-PSAS" (Physical-space Statistical Analysis Scheme for 3DVAR, voir [Courtier97]_, [Cohn98]_), algorithme parfois plus économique car opérant dans un autre espace, mais impliquant une approximation des opérateurs non-linéaires.
+- "3DVAR" (3D Variational analysis, voir [Lorenc86]_, [LeDimet86]_, [Talagrand97]_), algorithme classique d'origine, très robuste, opérant dans l'espace du modèle,
+- "3DVAR-VAN" (3D Variational Analysis with No inversion of B, voir [Lorenc88]_), algorithme similaire, opérant dans l'espace du modèle, mais permettant d'éviter l'inversion de la matrice de covariance B,
+- "3DVAR-Incr" (Incremental 3DVAR, voir [Courtier94]_), algorithme plus économique que les précédents, mais impliquant une approximation des opérateurs non-linéaires,
+- "3DVAR-PSAS" (Physical-space Statistical Analysis Scheme for 3DVAR, voir [Courtier97]_, [Cohn98]_), algorithme parfois plus économique car opérant dans l'espace des observations, mais impliquant une approximation des opérateurs non-linéaires.
 
-On recommande d'utiliser le 3DVAR d'origine.
+On recommande fortement d'utiliser le "3DVAR" d'origine. Les algorithmes
+"3DVAR" et "3DVAR-Incr" (et pas les autres) permettent la modification du point
+initial de leur minimisation, mais ce n'est pas recommandé.
 
 .. ------------------------------------ ..
 .. include:: snippets/Header2Algo02.rst
@@ -94,6 +97,8 @@ On recommande d'utiliser le 3DVAR d'origine.
 
 .. include:: snippets/SimulationForQuantiles.rst
 
+.. include:: snippets/StateBoundsForQuantilesWithNone.rst
+
 StoreSupplementaryCalculations
   .. index:: single: StoreSupplementaryCalculations
 
@@ -119,6 +124,7 @@ StoreSupplementaryCalculations
   "CurrentIterationNumber",
   "CurrentOptimum",
   "CurrentState",
+  "ForecastState",
   "IndexOfOptimum",
   "Innovation",
   "InnovationAtCurrentState",
@@ -128,6 +134,7 @@ StoreSupplementaryCalculations
   "MahalanobisConsistency",
   "OMA",
   "OMB",
+  "SampledStateForQuantiles",
   "SigmaObs2",
   "SimulatedObservationAtBackground",
   "SimulatedObservationAtCurrentOptimum",
@@ -185,6 +192,8 @@ StoreSupplementaryCalculations
 
 .. include:: snippets/CurrentState.rst
 
+.. include:: snippets/ForecastState.rst
+
 .. include:: snippets/IndexOfOptimum.rst
 
 .. include:: snippets/Innovation.rst
@@ -203,6 +212,8 @@ StoreSupplementaryCalculations
 
 .. include:: snippets/OMB.rst
 
+.. include:: snippets/SampledStateForQuantiles.rst
+
 .. include:: snippets/SigmaObs2.rst
 
 .. include:: snippets/SimulatedObservationAtBackground.rst