doc/fr/reference.rst

   1 ..
   2    Copyright (C) 2008-2024 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 .. _section_reference:
  25
  26 ================================================================================
  27 **[DocR]** Description de référence des commandes et mots-clés ADAO
  28 ================================================================================
  29
  30 Les sections suivantes présentent la description de référence des commandes et
  31 mots-clés ADAO disponibles à travers l'interface textuelle (TUI), graphique
  32 (GUI) ou à travers des scripts. Les deux premières sections communes présentent
  33 les :ref:`section_reference_entry` et les
  34 :ref:`section_reference_special_entry`. Ensuite, on décrit successivement les
  35 :ref:`section_reference_assimilation` et les :ref:`section_reference_checking`.
  36
  37 Chaque commande ou mot-clé à définir par la TUI ou la GUI a des propriétés
  38 particulières. La première propriété est d'être *requise*, *optionnelle* ou
  39 simplement utile, décrivant un type d'entrée. La seconde propriété est d'être
  40 une variable "ouverte" avec un type fixé mais avec n'importe quelle valeur
  41 autorisée par le type, ou une variable "fermée", limitée à des valeurs
  42 spécifiées. L'éditeur graphique GUI intégré disposant de capacités intrinsèques
  43 de validation, les propriétés des commandes ou mots-clés données à l'aide de
  44 l'interface graphique sont automatiquement correctes.
  45
  46 .. _section_reference_entry:
  47
  48 ================================================================================
  49 **[DocR]** Entrées et sorties générales
  50 ================================================================================
  51
  52 Cette section décrit de manière générale les différentes options de types
  53 d'entrées et de variables de sortie. Les notations mathématiques utilisées sont
  54 expliquées dans la section :ref:`section_theory`.
  55
  56 .. toctree::
  57    :maxdepth: 1
  58
  59    ref_entry_types
  60    ref_options_AlgorithmParameters
  61    ref_output_variables
  62
  63 .. _section_reference_special_entry:
  64
  65 ==========================================================================================
  66 **[DocR]** Entrées spéciales : mesures, fonctions, matrices, "*observer*", post-traitement
  67 ==========================================================================================
  68
  69 Cette section décrit les entrées spéciales, comme les formes fonctionnelles ou
  70 matricielles, et les conditions requises pour les utiliser. Les notions et
  71 notations mathématiques relatives à ces entrées sont expliquées dans la section
  72 :ref:`section_theory`.
  73
  74 .. toctree::
  75    :maxdepth: 1
  76
  77    ref_observations_requirements
  78    ref_operator_requirements
  79    ref_covariance_requirements
  80    ref_sampling_requirements
  81    ref_observers_requirements
  82    ref_userpostanalysis_requirements
  83
  84 .. _section_reference_assimilation:
  85
  86 ================================================================================
  87 **[DocR]** Cas d'assimilation de données ou d'optimisation
  88 ================================================================================
  89
  90 Cette section décrit les choix algorithmiques pour utiliser des méthodes
  91 d'assimilation de données, des méthodes d'optimisation ou des méthodes avec
  92 réduction, disponibles dans ADAO, en détaillant leurs caractéristiques et leurs
  93 options.
  94
  95 Des exemples sur l'usage de ces commandes sont disponibles dans la section des
  96 :ref:`section_tutorials_in_salome`, dans la section des
  97 :ref:`section_tutorials_in_python`, dans la section des
  98 :ref:`section_docu_examples`, et dans les fichiers d'exemple installés avec
  99 ADAO. Les notions et notations mathématiques utilisées sont expliquées dans la
 100 section générale donnant :ref:`section_theory`.
 101
 102 .. toctree::
 103    :maxdepth: 1
 104
 105    ref_algorithm_3DVAR
 106    ref_algorithm_4DVAR
 107    ref_algorithm_Blue
 108    ref_algorithm_DerivativeFreeOptimization
 109    ref_algorithm_DifferentialEvolution
 110    ref_algorithm_EnsembleBlue
 111    ref_algorithm_EnsembleKalmanFilter
 112    ref_algorithm_ExtendedBlue
 113    ref_algorithm_ExtendedKalmanFilter
 114    ref_algorithm_KalmanFilter
 115    ref_algorithm_LinearLeastSquares
 116    ref_algorithm_NonLinearLeastSquares
 117    ref_algorithm_ParticleSwarmOptimization
 118    ref_algorithm_QuantileRegression
 119    ref_algorithm_TabuSearch
 120    ref_algorithm_UnscentedKalmanFilter
 121    ref_assimilation_keywords
 122
 123 .. _section_reference_checking:
 124
 125 ================================================================================
 126 **[DocR]** Cas de vérification
 127 ================================================================================
 128
 129 Cette section décrit les algorithmes de vérification disponibles dans ADAO,
 130 détaillant leurs caractéristiques d'utilisation et leurs options.
 131
 132 Des exemples sur l'usage de ces commandes sont disponibles dans la section des
 133 :ref:`section_tutorials_in_salome`, dans la section des
 134 :ref:`section_tutorials_in_python`, dans la section des
 135 :ref:`section_docu_examples`, et dans les fichiers d'exemple installés avec
 136 ADAO. Les notions et notations mathématiques utilisées sont expliquées dans la
 137 section générale donnant :ref:`section_theory`.
 138
 139 .. toctree::
 140    :maxdepth: 1
 141
 142    ref_algorithm_AdjointTest
 143    ref_algorithm_ControledFunctionTest
 144    ref_algorithm_FunctionTest
 145    ref_algorithm_GradientTest
 146    ref_algorithm_InputValuesTest
 147    ref_algorithm_LinearityTest
 148    ref_algorithm_LocalSensitivityTest
 149    ref_algorithm_ObservationSimulationComparisonTest
 150    ref_algorithm_ObserverTest
 151    ref_algorithm_ParallelFunctionTest
 152    ref_algorithm_ReducedModelingTest
 153    ref_algorithm_SamplingTest
 154    ref_algorithm_TangentTest
 155    ref_checking_keywords
 156
 157 .. _section_reference_task:
 158
 159 ================================================================================
 160 **[DocR]** Cas orientés tâches ou études dédiées
 161 ================================================================================
 162
 163 Cette section décrit les algorithmes de tâches facilitant une étude dédiée
 164 disponibles dans ADAO, détaillant leurs caractéristiques d'utilisation et leurs
 165 options.
 166
 167 Ces tâches utilisent des algorithmes provenant de méthodes d'assimilation de
 168 données, de méthodes d'optimisation ou de méthodes avec réduction. On renvoie à
 169 la section générale donnant :ref:`section_theory` et à celle des
 170 :ref:`section_reference_assimilation` pour les détails algorithmiques
 171 sous-jacents.
 172
 173 .. toctree::
 174    :maxdepth: 1
 175
 176    ref_algorithm_EnsembleOfSimulationGenerationTask
 177    ref_algorithm_InterpolationByReducedModelTask
 178    ref_algorithm_MeasurementsOptimalPositioningTask
 179    ref_task_keywords