Changes between Version 354 and Version 355 of doc/app/runtime_parameters

Timestamp:

Feb 15, 2021 8:29:19 AM (4 years ago)

Author:

raasch

Comment:

--

doc/app/runtime_parameters

@@ -1306 +1306 @@
 |----------------
 {{{#!td style="vertical-align:top"
-[=#termination_time_needed '''termination_time_needed''']
-}}}
-{{{#!td style="vertical-align:top"
-R
-}}}
-{{{#!td style="vertical-align:top"
-35.0
-}}}
-{{{#!td
-CPU time needed for terminal actions at the end of a run in batch mode (in s).\\\\
-If the environment variable '''write_binary''' is set ''.T.'' (see [../runs Initialization and restart runs]), PALM checks the remaining CPU time of the job after each time step. Time integration must not consume the CPU time completely since several actions still have to be carried out after time integration has finished (e.g. writing of binary data for the restart run, carrying out output commands, copying of local files to their permanent destinations, etc.) which also takes some time. Furthermore, the parameter has also to account for the CPU time consumed by the job '''before''' the PALM executable has started (e.g. required for providing input data, or for compiling the user-interface code, etc.). The maximum possible time needed for these activities plus a reserve is to be given with the parameter '''termination_time_needed'''. Among other things, it depends on the number of grid points used. If its value is selected too small, then the respective job will be prematurely aborted by the queuing system, which may result in a data loss and will possibly interrupt the job chain.\\\\
-An abort happens in any way, if the activation string '''restart''' is not given with the {{{palmrun}}}-option {{{-a}}} and if the job has additionally been assigned an insufficient CPU time by '''palmrun''' option {{{-t}}}.
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
 [=#nz_do3d '''nz_do3d''']
 }}}
@@ -1504 +1489 @@
 |----------------
 {{{#!td style="vertical-align:top"
+[=#restart_data_format '''restart_data_format''']
+}}}
+{{{#!td style="vertical-align:top"
+C*20
+}}}
+{{{#!td style="vertical-align:top"
+'fortran_binary'
+}}}
+{{{#!td
+Binary format of the input and output restart files.\\\\
+Allowed values are '' 'fortran_binary' '', '' 'mpi' '', and '' 'mpi_shared_memory' ''. In case of '' 'fortran_binary' '' each core reads/writes its own file. In case of '' 'mpi' '', the I/O is done using a single file. This method can also be used in serial mode (when PALM has been compiled without {{{-D__parallel}}} option). In such a case, restart I/O is carried out using POSIX calls.\\\\
+On many-core processors the I/O speed can be increased by setting '''restart_data_format''' = '' 'mpi_shared_memory' ''. With this setting, I/O is performed only by a limited number of cores on each of the nodes. With mpi every core writes and reads its relevant data. With mpi_shared_memory, only every 4th (or any other multiple integer of the cores per node) reads and writes data and distributes it to the other cores. This is possible since all processes on a node can share their memory. With this, the IO rates might increase.
+
+This parameter can also be used in the initialization parameter NAMELIST.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#restart_data_format_input '''restart_data_format_input''']
+}}}
+{{{#!td style="vertical-align:top"
+C*20
+}}}
+{{{#!td style="vertical-align:top"
+value of [#restart_data_format restart_data_format]
+}}}
+{{{#!td
+Binary format of the input restart file.\\\\
+See [#restart_data_format restart_data_format] for allowed values.
+
+This parameter can also be used in the initialization parameter NAMELIST.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#restart_data_format_output '''restart_data_format_output''']
+}}}
+{{{#!td style="vertical-align:top"
+C*20
+}}}
+{{{#!td style="vertical-align:top"
+value of [#restart_data_format restart_data_format]
+}}}
+{{{#!td
+Binary format of the output restart file.\\\\
+See [#restart_data_format restart_data_format] for allowed values.
+
+This parameter can also be used in the initialization parameter NAMELIST.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
 [=#restart_time '''restart_time''']
 }}}
@@ -1520 +1554 @@
 For [../examples/coupled coupled runs] this parameter must be equal in both parameter files [[../iofiles#PARIN|PARIN]] and [[../iofiles#PARIN_O|PARIN_O]].
 }}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#termination_time_needed '''termination_time_needed''']
+}}}
+{{{#!td style="vertical-align:top"
+R
+}}}
+{{{#!td style="vertical-align:top"
+35.0
+}}}
+{{{#!td
+CPU time needed for terminal actions at the end of a run in batch mode (in s).\\\\
+If the environment variable '''write_binary''' is set ''.T.'' (see [../runs Initialization and restart runs]), PALM checks the remaining CPU time of the job after each time step. Time integration must not consume the CPU time completely since several actions still have to be carried out after time integration has finished (e.g. writing of binary data for the restart run, carrying out output commands, copying of local files to their permanent destinations, etc.) which also takes some time. Furthermore, the parameter has also to account for the CPU time consumed by the job '''before''' the PALM executable has started (e.g. required for providing input data, or for compiling the user-interface code, etc.). The maximum possible time needed for these activities plus a reserve is to be given with the parameter '''termination_time_needed'''. Among other things, it depends on the number of grid points used. If its value is selected too small, then the respective job will be prematurely aborted by the queuing system, which may result in a data loss and will possibly interrupt the job chain.\\\\
+An abort happens in any way, if the activation string '''restart''' is not given with the {{{palmrun}}}-option {{{-a}}} and if the job has additionally been assigned an insufficient CPU time by '''palmrun''' option {{{-t}}}.
+}}}
 \\\\
 [=#pgrid '''Processor grid / MPI settings:]\\