Salome HOME
Revert "Synchronize adm files"
[modules/homard.git] / doc / en / tui_create_iteration.rst
index 6862ff2dacb08027eb3b5c9d187b8aa6e5fa2e34..c424f047d78c4451359513504b4ba19987473b89 100644 (file)
@@ -223,24 +223,46 @@ Information about the meshes
 Information about the field
 ===========================
 
+The file of the fields
+----------------------
+
 +---------------------------------------------------------------+
 +---------------------------------------------------------------+
 | .. module:: SetFieldFile                                      |
 |                                                               |
 | **SetFieldFile(field_file)**                                  |
-|     Defines the MED file of the field                         |
+|     Defines the MED file of the fields                        |
 |                                                               |
-|     - ``field_file``: the name of the MED file of the field   |
+|     - ``field_file``: the name of the MED file of the fields: |
+|       the driving field for the adaptation, or the fields to  |
+|       be interpolated                                         |
 +---------------------------------------------------------------+
-| .. module:: SetTimeStepRank                                   |
+| .. module:: GetFieldFileName                                  |
 |                                                               |
-| **SetTimeStepRank(TimeStep, Rank)**                           |
-|     Defines the time steps for the fields                     |
+| **GetFieldFileName()**                                        |
+|     Returns the name of the MED file of the fields            |
++---------------------------------------------------------------+
+
+The time step for the driving field
+-----------------------------------
+
+If no time step is defined for the field or if a single time step is defined for the field, the definition of a time step is useless. That will be the default choice.
+
++---------------------------------------------------------------+
++---------------------------------------------------------------+
+| .. module:: SetTimeStep                                       |
 |                                                               |
-|     Useless if no time step is defined for the field.         |
+| **SetTimeStep(TimeStep)**                                     |
+|     Defines the time step for the driving field for the       |
+|     adaptation. The rank will be ignored.                     |
 |                                                               |
-|     If a single time step is defined for the filed, it is the |
-|     default choice.                                           |
+|     - ``TimeStep``: the selected time step                    |
++---------------------------------------------------------------+
+| .. module:: SetTimeStepRank                                   |
+|                                                               |
+| **SetTimeStepRank(TimeStep, Rank)**                           |
+|     Defines the time step and the rank for the driving field  |
+|     for the adaptation                                        |
 |                                                               |
 |     - ``TimeStep``: the selected time step                    |
 |     - ``Rank``: the selected rank                             |
@@ -248,22 +270,59 @@ Information about the field
 | .. module:: SetTimeStepRankLast                               |
 |                                                               |
 | **SetTimeStepRankLast()**                                     |
-|     The last time step will be used, whatever its value       |
-+---------------------------------------------------------------+
-| .. module:: GetFieldFileName                                  |
-|                                                               |
-| **GetFieldFileName()**                                        |
-|     Returns the name of the MED file of the field             |
+|     The last time step will be used for the driving field for |
+|     the adaptation, whatever its value                        |
 +---------------------------------------------------------------+
 | .. module:: GetTimeStep                                       |
 |                                                               |
 | **GetTimeStep()**                                             |
-|     Returns the selected time step for the field              |
+|     Returns the selected time step for the driving field      |
 +---------------------------------------------------------------+
 | .. module:: GetRank                                           |
 |                                                               |
 | **GetRank()**                                                 |
-|     Returns the selected rank for the field                   |
+|     Returns the selected rank for the driving field           |
++---------------------------------------------------------------+
+
+The time steps for the fields to interpolate
+--------------------------------------------
+
+The choice of the fields to interpolated are defined in the hypothesis (see :ref:`tui_create_hypothese`).
+For a given field, if nothing is declared, every single time step will be considered.
+If some time steps are wanted, they must be defined as follows.
+
++---------------------------------------------------------------+
++---------------------------------------------------------------+
+| .. module:: SetFieldInterpTimeStep                            |
+|                                                               |
+| **SetFieldInterpTimeStep(FieldName, TimeStep)**               |
+|     Defines the time step for the interpolation of the field. |
+|     The rank will be ignored.                                 |
+|                                                               |
+|     - ``FieldName``: the name of the field to interpolate     |
+|     - ``TimeStep``: the selected time step                    |
++---------------------------------------------------------------+
+| .. module:: SetFieldInterpTimeStepRank                        |
+|                                                               |
+| **SetFieldInterpTimeStepRank(FieldName, TimeStep)**           |
+|     Defines the time step and the rank for the interpolation  |
+|     of the field.                                             |
+|                                                               |
+|     - ``FieldName``: the name of the field to interpolate     |
+|     - ``TimeStep``: the selected time step                    |
+|     - ``Rank``: the selected rank                             |
++---------------------------------------------------------------+
+| .. module:: GetFieldInterpsTimeStepRank                       |
+|                                                               |
+| **GetFieldInterpsTimeStepRank()**                             |
+|     Returns the information (name of the field, time step,    |
+|     rank)                                                     |
+|                                                               |
+|     Warning: the time step and the rank are stored as strings |
+|     in the list and not as integers.                          |
+|                                                               |
+|     Example: ['DEPL', '1', '1', 'DEPL', '2', '1', 'Mass',     |
+|     '2', '0', 'Mass', '3', '0']                               |
 +---------------------------------------------------------------+
 
 Miscellenaous
@@ -276,7 +335,7 @@ Miscellenaous
 | **SetInfoCompute(MessInfo)**                                  |
 |     Defines options to track the computation of the iteration |
 |                                                               |
-|     - ``MessInfo`` : integer that drives prints, as a multiple|
+|     - ``MessInfo``: integer that drives prints, as a multiple |
 |       of 2, 3 and 5                                           |
 |                                                               |
 |         * 1 : nothing (default)                               |