]> SALOME platform Git repositories - modules/adao.git/commitdiff
Salome HOME
Minor documentation update and corrections
authorJean-Philippe ARGAUD <jean-philippe.argaud@edf.fr>
Mon, 20 Sep 2021 12:45:56 +0000 (14:45 +0200)
committerJean-Philippe ARGAUD <jean-philippe.argaud@edf.fr>
Mon, 20 Sep 2021 12:45:56 +0000 (14:45 +0200)
doc/en/ref_algorithm_EnsembleKalmanFilter.rst
doc/en/ref_userpostanalysis_requirements.rst
doc/en/snippets/SmootherLagL.rst [new file with mode: 0644]
doc/en/snippets/Variant_EnKF.rst
doc/fr/ref_algorithm_EnsembleKalmanFilter.rst
doc/fr/ref_userpostanalysis_requirements.rst
doc/fr/snippets/SmootherLagL.rst [new file with mode: 0644]
doc/fr/snippets/Variant_EnKF.rst

index baef1744e893e7fb7970667d27e76f4a2d710f16..c4cedefc0f1de06219fcd96169a6fff360cbb4f6 100644 (file)
@@ -68,8 +68,9 @@ robust formulations are proposed here:
 - "EnKF" (Ensemble Kalman Filter, see [Evensen94]_), original stochastic algorithm, allowing consistent treatment of non-linear evolution operator,
 - "ETKF" (Ensemble-Transform Kalman Filter), deterministic EnKF algorithm, allowing treatment of non-linear evolution operator with a lot less members (one recommends to use a number of members on the order of 10 or even sometimes less),
 - "ETKF-N" (Ensemble-Transform Kalman Filter of finite size N), ETKF algorithm of "finite size N", yhat doesn't need inflation that is often required with the other algorithms,
-- "MLEF" (Maximum Likelihood Kalman Filter, see [Zupanski05]_), deterministic EnKF scheme, allowing in addition the consistent treament of non-linear observation operator,
-- "IEnKF" (Iterative EnKF), deterministic EnKF scheme, improving treament of operators non-linearities.
+- "MLEF" (Maximum Likelihood Kalman Filter, see [Zupanski05]_), deterministic EnKF algorithm, allowing in addition the consistent treament of non-linear observation operator,
+- "IEnKF" (Iterative EnKF), deterministic EnKF algorithm, improving treament of operators non-linearities
+- "EnKS" (Ensemble Kalman Smoother), smoothing algorithm with a fixed time lag L.
 
 Without being a universal recommandation, one recommend to use "EnKF" as a
 reference algorithm, and the other algorithms (in this order) as means to
@@ -105,6 +106,8 @@ obtain less costly data assimilation with hopefully the same quality.
 
 .. include:: snippets/SetSeed.rst
 
+.. include:: snippets/SmootherLagL.rst
+
 StoreSupplementaryCalculations
   .. index:: single: StoreSupplementaryCalculations
 
index c37943b416bfeed084bc5300f1a44318142f3979..1aa4f0b46a905609622a765cb2453a26289614ce 100644 (file)
@@ -91,7 +91,8 @@ A set of post-processing commands is a special Python script, which is
 automatically activated at the end of the estimation calculations in ADAO. Any
 Python commands, which a user can add after a TUI calculation in ADAO, can be
 part of this post-processing. Several command set templates are available by
-default.
+default,essentially to give the simplest possible example of recording these
+series.
 
 To be usable in an automatic way, it is required that any call of the ADAO
 calculation case, to recover a variable, is done only with the reserved name
diff --git a/doc/en/snippets/SmootherLagL.rst b/doc/en/snippets/SmootherLagL.rst
new file mode 100644 (file)
index 0000000..8ed6bfb
--- /dev/null
@@ -0,0 +1,9 @@
+.. index:: single: SmootherLagL
+
+SmootherLagL
+  *Integer value*. This key indicates the number of smoothing time intervals in
+  the past for the EnKS. This is a number of intervals, not a fixed duration.
+  The default value is 0, which leads to no smoothing.
+
+  Example :
+  ``{"SmootherLagL":0}``
index 82a6473d4d6527e9c0b65792b6b60b355bb935a2..0b1fccc79b765a3c71574294c0c777d7cbe988f4 100644 (file)
@@ -5,6 +5,7 @@
     pair: Variant ; ETKF-N
     pair: Variant ; MLEF
     pair: Variant ; IEnKF
+    pair: Variant ; EnKS
 
 Variant
   *Predifined name*.  This key allows to choose one of the possible variants
@@ -14,7 +15,8 @@ Variant
   "ETKF" (Ensemble-Transform Kalman Filter),
   "ETKF-N" (Ensemble-Transform Kalman Filter),
   "MLEF" (Maximum Likelihood Kalman Filter),
-  "IEnKF" (Iterative_EnKF).
+  "IEnKF" (Iterative_EnKF),
+  "EnKS" (Ensemble Kalman Smoother).
   One recommends to try the "ETKF-N" or "IEnKF" variants, and to reduce the
   number of members to about 10 or less for all variants other then the
   original "EnKF".
index 42fd995bc928785ad46a2242c0590bc49dda767d..29e3a3d3f5c15393dfce24f8fbaf41896a306031 100644 (file)
@@ -69,8 +69,9 @@ formulations stables et robustes suivantes :
 - "EnKF" (Ensemble Kalman Filter, voir [Evensen94]_), algorithme stochastique original, permettant de traiter de manière consistante un opérateur d'évolution non-linéaire,
 - "ETKF" (Ensemble-Transform Kalman Filter), algorithme déterministe d'EnKF, permettant de traiter un opérateur d'évolution non-linéaire avec beaucoup moins de membres (on recommande d'utiliser un nombre de membres de l'ordre de 10 ou même parfois moins),
 - "ETKF-N" (Ensemble-Transform Kalman Filter of finite size N), algorithme d'ETKF dit de "taille finie N", évitant de recourir à une inflation souvent nécessaire avec les autres algorithmes,
-- "MLEF" (Maximum Likelihood Kalman Filter, voir [Zupanski05]_), schéma déterministe d'EnKF, permettant en plus de traiter de manière consistante un opérateur d'observation non-linéaire),
-- "IEnKF" (Iterative EnKF), schéma déterministe d'EnKF, améliorant le traitement des non-linéarités des opérateurs.
+- "MLEF" (Maximum Likelihood Kalman Filter, voir [Zupanski05]_), algorithme déterministe d'EnKF, permettant en plus de traiter de manière consistante un opérateur d'observation non-linéaire),
+- "IEnKF" (Iterative EnKF), algorithme déterministe d'EnKF, améliorant le traitement des non-linéarités des opérateurs,
+- "EnKS" (Ensemble Kalman Smoother), algorithme de lissage avec un décalage fixe.
 
 Sans pouvoir prétendre à l'universalité, on recommande d'utiliser l'"EnKF"
 comme référence, et les autres algorithmes (dans l'ordre) comme des moyens pour
@@ -107,6 +108,8 @@ obtenir une assimilation de données plus économique et de qualité
 
 .. include:: snippets/SetSeed.rst
 
+.. include:: snippets/SmootherLagL.rst
+
 StoreSupplementaryCalculations
   .. index:: single: StoreSupplementaryCalculations
 
index 8683b83f333b083fa6c3b450458dab434af956b3..fe443ab3f60b14114eb53132d02d3219a804d621 100644 (file)
@@ -92,7 +92,8 @@ Une série de commandes de post-traitement est un script Python spécial, qui es
 automatiquement activée à la fin des calculs d'estimation dans ADAO. Toutes les
 commandes Python, qu'un utilisateur peut ajouter après un calcul ADAO en
 interface graphique TUI, peuvent faire partie de ce post-traitement. Plusieurs
-modèles de série de commandes sont disponibles par défaut.
+modèles de série de commandes sont disponibles par défaut, essentiellement pour
+donner un exemple le plus simple possible d'enregistrement de ces séries.
 
 Pour être utilisable de manière automatique, il est requis tout appel du cas de
 calcul ADAO, pour récupérer une variable, se fasse uniquement avec le nom
diff --git a/doc/fr/snippets/SmootherLagL.rst b/doc/fr/snippets/SmootherLagL.rst
new file mode 100644 (file)
index 0000000..fa592ae
--- /dev/null
@@ -0,0 +1,10 @@
+.. index:: single: SmootherLagL
+
+SmootherLagL
+  *Valeur entière*. Cette clé indique le nombre d'intervalles de temps de
+  lissage dans le passé pour l'EnKS. C'est bien un nombre d'intervalles, et non
+  pas une durée fixe. La valeur par défaut est 0, qui conduit à une absence de
+  lissage.
+
+  Exemple :
+  ``{"SmootherLagL":0}``
index 689c90b19cca97a7f15cf21af37a63671fb904eb..f44b91874904206db8a1d754bc6e7f26b8dd7f5c 100644 (file)
@@ -5,6 +5,7 @@
     pair: Variant ; ETKF-N
     pair: Variant ; MLEF
     pair: Variant ; IEnKF
+    pair: Variant ; EnKS
 
 Variant
   *Nom prédéfini*. Cette clé permet de choisir l'une des variantes possibles
@@ -14,7 +15,8 @@ Variant
   "ETKF" (Ensemble-Transform Kalman Filter),
   "ETKF-N" (Ensemble-Transform Kalman Filter),
   "MLEF" (Maximum Likelihood Kalman Filter),
-  "IEnKF" (Iterative_EnKF).
+  "IEnKF" (Iterative_EnKF),
+  "EnKS" (Ensemble Kalman Smoother).
   Il est conseillé d'essayer les variantes "ETKF-N" ou "IEnKF", et de réduire
   le nombre de membres à une dizaine ou moins pour toutes les variantes autres
   que l'"EnKF" original.