Différences

Ci-dessous, les différences entre deux révisions de la page.

--- sunfluidh:simulation_management_setup_namelist [2019/10/31 17:27] – yann
+++ sunfluidh:simulation_management_setup_namelist [2019/11/13 15:39] – yann
@@ Ligne 19: / Ligne 19: @@
                              Simulation_Backup_Rate                 = 1000   ,
                              Simulation_Checking_Rate = 200 ,
-                             Fields_Recording_Rate = 1.D+00 ,
+                             InstantaneousFields_TimeRecordingRate= 1.0D+00  ,
-                             Probe_Recording_Rate                   = 10     ,
+                             InstantaneousFields_RecordingStartTime= 0.0    ,
+                             Probe_StartTimeIterationRecording= 20          ,
+                             Probe_TimeIterationRecordingRate      = 10     ,
                              Start_Time_For_Statistics= 1.D+2               ,
                              Time_Range_Statistic_Calculation = 1.D+00  /
@@ Ligne 44: / Ligne 46: @@
 **Steady_Flow_Stopping_Criterion_Enabled**
-   * Type : Boolean value
+   * Type : Boolean value.
    * Activation of the stopping criterion for steady flow (based on the L2-norm of the time variation of physical quantities).
@@ Ligne 56: / Ligne 58: @@
    * Type : Real value
    * This value is the physical time limit reached by the simulation before stopping.
+<note>
+The simulation stops as soon as one of these conditions is achieved.
+</note>
 ----
@@ Ligne 76: / Ligne 82: @@
    * Type : Real value. This variable can be omitted when the time step is constant.
    * Minimum value of the CFL parameter (can be omitted, in this case **CFL_Max** will define the CFL value).
-==== CFL_max ====
+**CFL_max**
    * Type : Real value
    * Maximum value of the CFL parameter. This variable set the value of the CFL parameter when it is constant (in this case, **CFL_Min** is useless).
@@ Ligne 82: / Ligne 88: @@
    * Type : Integer value
    * Number of time iterations over which the CFL parameter or the time step can evolve linearly. When the time step or the CFL parameter are constant, this variable must not set to a value greater than 1. It could actually be omitted (this default value is 1).
+<note>
+For a dynamic computation of the time step from a CFL condition, you can only set the variable **CFL_Max** if you want a constant CFL value and **CFL_Min** can be omitted.\\
+In any way, the maximum value the time step can reached is limited by the value of **Timestep_max** (useful when the initial condition is defined from a zero velocity field for which the time step cannot be computed from the CFL condition).
+</note>
@@ Ligne 87: / Ligne 99: @@
 ==== Recording rates for different kind of files ====
 ----
-=== For backup/restart files : ===
+==== - For backup/restart files : ====
 **Simulation_Backup_Rate**
    * Type : Integer value
-   * This variable defines the recording rate, __in time iteration units__ , of the backup files (for instance, when "Simulation_Backup_Rate=1000" a data backup is carried out for all time iteration numbers that are a multiple of 1000).\\ Backup data are dispatched in two files that are named save_var_yyyyy_n.d and save_fld_yyyyy_n.d ('yyyyy' is the subdomain number for simulations based on the MPI domain-decomposition approach, n= 1 or 2 for temporary backup files and n=3 for the backup files created during the last time step of the simulation).
+   * This variable defines the recording rate, __in time iteration unit__ , of the backup files (for instance, when "Simulation_Backup_Rate=1000" a data backup is carried out for all time iteration numbers that are a multiple of 1000).\\ Backup data are dispatched in two files that are named save_var_yyyyy_n.d and save_fld_yyyyy_n.d ('yyyyy' is the subdomain number for simulations based on the MPI domain-decomposition approach, n= 1 or 2 for temporary backup files and n=3 for the backup files created during the last time step of the simulation).
-=== For snapshot files ===
+==== - For snapshot files : ====
-**Field_Recording_Rate**
+**InstantaneousFields_RecordingStartTime**
    * Type : Real value
-   * This variable defines the recording rate, __in time units__ , of instantaneous fields (for instance, when "Field_Recording_Rate=1.5" an instantaneous field file is created as soon as the time value is a multiple of 1.5).\\ Instantaneous field files are named res_xxxxxxx_yyyyy.d ('yyyyy' is the subdomain number for simulations based on the MPI domain-decomposition approach, 'xxxxxxx' is the file number). The intantaneous fields of the physical quantities are defined with the namelist "Instantaneous_Fields_Listing".
+   * This variable sets the time threshold from which the record of instantaneous fields begins. It must be used along with the next variable "InstantaneousFields_TimeRecordingRate". This value is defined in time unit.
-=== For statistics files ===
+**InstantaneousFields_TimeRecordingRate**
+   * Type : Real value
+   * This variable defines the recording rate, __in time unit__ , of instantaneous fields. For instance, when "InstantaneousFields_TimeRecordingRate=1.5" a file is created at every 1.5 time unit from the start time provided by the variable "InstantaneousFields_RecordingStartTime".\\
+**InstantaneousFields_StartTimeIterationRecording**
+   * Type : Integer value
+   * This variable sets the time-iteration threshold from which the record of instantaneous fields begins. It must be used along with the next variable "InstantaneousFields_TimeIterationRecordingRate". This value is defined in time-iteration unit (number of time steps).
+**InstantaneousFields_TimeIterationRecordingRate**
+   * Type : Integer value
+   * This variable defines the recording rate, __in time-iteration units__ , of instantaneous fields. For instance, when "InstantaneousFields_TimeIterationRecordingRate=100" a file is created at every 100 time steps from the threshold provided by the variable "InstantaneousFields_StartTimeIterationRecording".\\
+**InstantaneousFields_RecordingReset**
+   * Type : Boolean value. The default value is .false.
+   * When this variable is set to ".true.", the ID number of file 'xxxxxxx' is set to zero for the next simulation. This is useful for resetting the file numbering when a simulation is split into several successive parts.
+<note>
+Keep in mind :
+   * Instantaneous field files are named res_xxxxxxx_yyyyy.d. T
+   * The number 'yyyyy' stands for the subdomain number on which fields are recorded for simulations based on the MPI domain-decomposition approach. When the domain decomposition approach is not used (just one domain), 'yyyyy=00000' is the default value.
+   *  'xxxxxxx' is the ID number of the file. 'xxxxxxx' is incremented by one for each new file created.
+   * The instantaneous fields of the physical quantities written in each file are defined with the namelist "Instantaneous_Fields_Listing".
+</note>
+<WRAP important>
+ This set of variables must be used in respect of one rule : the user wants to define the recording rate of files either in time unit or in number of time steps (time-ieration unit). In any case, the correct couple of variable must be used.
+   * "InstantaneousFields_RecordingStartTime" and "InstantaneousFields_TimeRecordingRate" in  time unit.
+   * "InstantaneousFields_StartTimeIterationRecording" and "InstantaneousFields_TimeIterationRecordingRate" in number of time steps.
+</WRAP>
+==== - For statistics files : ====
 **Start_Time_For_Statistics**
    * Type : Real value
    * Time from which the statistical fields are calculated.
-**Time_Range_Statistic_Calculation** (for statistics files)
+**Time_Range_Statistic_Calculation**
    * Type : Real value
    * Time range over which statistical fields are calculated. When this time range has been covered, statistical fields are recorded in a file named rst_xxxxxxx_yyyyy.d ('yyyyy' is the subdomain number for simulations based on the MPI domain-decomposition approach, 'xxxxxxx' is the file number). If the simulation is not completed a new cycle of statistical calculation is initialized. The statistical quantities are defined with the namelist "Statistical_Fields_Listing".
-==== For probe time-series files ====
+==== - For probe time-series files : ====
-**Probe_Recording_Rate**
+**Probe_TimeIterationRecordingRate**
    * Type : Integer value
-   * This variable defines the recording rate, __in time iteration units__ , of time series associated to the probes distributed over the domain (see the namelist "Probe_Location"). The physical quantities linked to the probe time-series are defined with the namelist "Probe_Quantities_Enabled". For instance, when "Probe_Recording_Rate=10", a new value is added to probe time-series for all time iteration numbers that are a multiple of 10).
+   * This variable defines the recording rate, __in time iteration unit__ (number of time steps), of time series from probes distributed over the domain (see the namelist "Probe_Location"). The physical quantities linked to the probe time-series are defined with the namelist "Probe_Quantities_Enabled". For instance, when "Probe_TimeIterationRecordingRate=10", a new value is added to probe time-series at every 10 time steps from the threshold defined with "Probe_StartTimeIterationRecording").
+**Probe_TimeIterationRecordingRate**
+   * Type : Integer value
+   * This variable defines the threshold from which the probe time-series start (in time iteration unit)
+**Probe_RecordingReset**
+   * Type : Boolean value. The default value is .false.
+   * When this variable is set to ".true.", the recording procedure of probe time-series is reinitialized when the simulation runs again. the old time series files present in the work directory are removed and replaced by the ones created during the current simulation. In otherwise (.false.), the new data are added in the time-series files previously created.