Différences

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

--- sunfluidh:sunfluidh_output [2019/01/10 15:05] – yann
+++ sunfluidh:sunfluidh_output [2023/03/13 11:32] (Version actuelle) – yann
@@ Ligne 7: / Ligne 7: @@
    * the **probe files** provide time series related to probes placed by the user over the computational domain.
    * the **instantaneous field files** contain a "snapshot view" of physical quantity fields for a given time.
+   * the **"slice" files** contain physical quantity fields associated to a slice for a given time.
+   * the ** "space-averaged" files** contain space-averaged fields along a specific direction for a given time.
    * the **statistical files** contain statistics about selected quantities.
    * the **backup files** contain the data setup for restarting the simulation.
-   * the checking files contain data that allow the user to check the behavior of the simulation
+   * the **checking files** contain data that allow the user to check the behavior of the simulation
 <note tips>
 The file formats are ASCII or BINARY.\\
-The binary files related to the instantaneous and statistical fields can be converted to an appropriate format for data visualization (with the softwares Tecplot or Paraview) by using the in-house software __[[ visfield_doc |VISFIELD ]]__.  \\ It is also possible to upload the data in Matlab software with the Matlab functions "read_sunfluidh_data.m" (for instantaneous and statistical fields) or "read_sunfluidh_probes.m" (for time series recorded from probes).
+The binary files related to the instantaneous and statistical fields can be converted to an appropriate format for data visualization (with the softwares Tecplot or Paraview) by using the in-house software __[[ visfield_doc |VISFIELD ]]__.  \\ It is also possible to upload the data in [[sunfluidh:sunfluidh_matlab| Matlab]] or [[https://perso.limsi.fr/witko/teaching/MU5MEF32/TutoReadingSunfluidhFileswithPython.html|Python]].
 </note>
 ----
@@ Ligne 19: / Ligne 21: @@
 ----
 The name of file is defined following the template : "N_ins_yyyyy.d".
-     * "yyyyy" is the number of the subdomain where the probes are located (relevant for MPI computing).
+     * "yyyyy" is the subdomain ID where the probes are located (relevant for MPI computing).
      * N is the physical quantity related to the time series recorded in the file. N= u,v,w,t,p,r for the three velocity components, the temperature, the pressure or the density, respectively.
 <note info>
-These files are written in ASCII format and data are ordered in colums.
+   * These files are written in ASCII format and data are ordered in columns.
-The first column is the time and the others are the time series of a specific quantity. Other columns are linked with probe locations.
+   * The first column is the time and the others are the time series of the physical quantity specified in the file name. Other columns are linked with probe locations.
+   * The velocity components are interpolated at the center of cells.
 </note>
 The data setting is defined in the file "input3d.dat" by means of the namelists:
@@ Ligne 34: / Ligne 37: @@
 ----
 The name of file is defined following the template : "res_yyyyy_xxxxxxx.d"
-     * "yyyyy" is the number of the subdomain where the fields are present (relevant for MPI computing).
+     * "yyyyy" is the subdomain ID for which the fields are recorded (relevant for MPI computing).
-     * "xxxxxxx" is the file number (the rank) used for the time classification in regard to the recording rate.
+     * "xxxxxxx" is the time ID used for the time classification in regard to the recording rate.
 <note info>
-These files are written in binary format.\\
+   * These files are written in binary format.\\
-Each recorded field includes the ghost-cells surrounding the computational domain (or subdomains for MPI computing).
+   * Each recorded field includes the ghost-cells surrounding the computational domain (or subdomains for MPI computing).\\
+   * Each file contains a cell-centered coordinate set \\
+   * The velocity components are located at the center of the __cell-faces__ (the location used during the computation, see [[sunfluidh:sunfluidh_tools|"Overview of key points for using Sunfluidh"]]). \\
 </note>
 The data setting is performed in the file "input3d.dat" with the namelists :
     * **[[Instantaneous_Fields_Listing_Namelist_Setup|Instantaneous_Fields_Listing]] ** for defining the list of physical quantities to record
     * **[[Field_Recording_Setup_Namelist_Setup|Field_Recording_Setup]]** for defining the binary format in single or double precision
-    * **[[Simulation_Management_Setup_Namelist|Simulation_Management]]**  for setting the recording rate of files with the data "Fields_Recording_Rate".
+    * **[[Simulation_Management_Setup_Namelist|Simulation_Management]]**  in order to set the parameters about the recording rate of files and the recording start time.
+----
+==== "Slice" files ====
+----
+The name of file is defined following the template : "slice_Id_Dir_yyyyy_xxxxxxx.d"
+     * "Id" is the rank ID of the slice for which physical quantities are recorded
+     * "Dir" defines the normal direction of the slice
+     * "yyyyy" is the subdomain ID for which the fields are recorded (relevant for MPI computing).
+     * "xxxxxxx" is the time ID used for the time classification in regard to the recording rate.
+<note info>
+These files are written in binary format.\\
+</note>
+The data setting is performed in the file "input3d.dat" with the namelists :
+    * **[[Slices_Recording_Setup_Namelist|Slices_Recording_Setup]] ** for defining the list of physical quantities to record and the slice features.
+    * **[[Field_Recording_Setup_Namelist_Setup|Field_Recording_Setup]]** for defining the binary format in single or double precision
+    * **[[Simulation_Management_Setup_Namelist|Simulation_Management]]**  for setting the recording features of files (see variables containing the character string "Slice").
+<note info>
+   * When the variable "Slice_Gathering_Enabled= .true." in the namelist [[Field_Recording_Setup_Namelist_Setup|Field_Recording_Setup]], every "slice" data split over several MPI subdomains are gathered and recorded in the same file named "slice_Id_Dir_xxxxxxx.d"("yyyyy" is not considered).
+   * Each file contains a cell-centered coordinate set. \\
+   * The velocity components are interpolated at the center of cells. Their position is directly given by the cell-centered coordinate set.
+</note>
+----
+==== "Space-averaged" files ====
+----
+The name of file is defined following the template : "spav_slice_Dir_xxxxxxx.d"
+     * "Dir" defines the direction along which the fields are averaged in space.
+     * "xxxxxxx" is the time ID used for the time classification in regard to the recording rate.
+<note info>
+   * These files are written in binary format.
+   * Each file contains a cell-centered coordinate set.
+   * The velocity components are interpolated at the center of cells. Their position is directly given by the cell-centered coordinate set.
+</note>
+The data setting is performed in the file "input3d.dat" with the namelists :
+    * **[[SpaceAveragedSnapshots_Dataset_Namelist|SpaceAveragedSnapshots_Dataset]]** for defining the list of physical quantities to record and the direction of the space average.
+    * **[[Field_Recording_Setup_Namelist_Setup|Field_Recording_Setup]]** for defining the binary format in single or double precision
+    * **[[Simulation_Management_Setup_Namelist|Simulation_Management]]**  for setting the recording features of files (see variables containing the character string "SpaceAveragedField").
 ----
@@ Ligne 49: / Ligne 93: @@
 ----
 The name is defined following the template : "rst_yyyyy_xxxxxxx.d" \\
-    * "yyyyy" is the number of the subdomain where the fields are present (relevant for MPI computing).
+   * "yyyyy" is the subdomain ID for which the fields are recorded (relevant for MPI computing).
-     * "xxxxxxx" is the file number used for the time classification.
+   * "xxxxxxx" is the time ID used for the time classification in regard to the recording rate.
 <note info>
-These files are written in binary format (double precision for the real values).
+   * These files are written in binary format (double precision for the real values).
-Each recorded field includes the ghost-cells surrounding the computational domain (or subdomains for MPI computing).
+   * Each recorded field includes the ghost-cells surrounding the computational domain (or subdomains for MPI computing).
+   * Each file contains a cell-centered coordinate set.
+   * The velocity components are interpolated at the center of cells. Their position is directly given by the cell-centered coordinate set.
 </note>
 <note important> The term "statistics" generally means the computation of time averages :$$ \overline{f(x_i,x_j,x_k,z)}= \frac{1}{T}\sum_{n=1}^{n=N_t} f(x_i,x_j,x_k,t_n) \Delta t$$
@@ Ligne 66: / Ligne 112: @@
 ==== Backup files ====
 ----
-Three types of files exits :
+Three types of files exists for data used for a restart procedure :
      * The file "save_var_yyyyy_n.d" : This file contains some variables describing the state of the simulation at the backup time.
      * The file "save_fld_yyyyy_n.d" : This file contains all backup fields that are mandatory in order to perform a resuming of the simulation.
@@ Ligne 82: / Ligne 128: @@
      * For the species mass fractions (only for multi-species flows) **[[ Species_Initialization_Namelist | Species_Initialization ]] **
      * For incompressible and immiscible bi-fluid flows : **[[ Two_fluids_Initialization_Namelist | Two_Fluids_Initialization ]]**
+It also exists two kinds of files for the backup of statistical quantities :
+     * The files "save_stat_yyyyy_n.d" : They contain all backup fields that are mandatory in order to perform a resuming of the statistical quantities computation.
+     * The files "save_tpst_yyyyy_n.d" : They contain some variables describing the state of the statistical computation at the backup time.
 ----