[Dart-dev] [6187] DART/branches/development/ensemble_manager: update documentation and nml file to match changes to

nancy at ucar.edu nancy at ucar.edu
Wed May 29 10:50:56 MDT 2013


Revision: 6187
Author:   nancy
Date:     2013-05-29 10:50:55 -0600 (Wed, 29 May 2013)
Log Message:
-----------
update documentation and nml file to match changes to
ensemble_manager namelist.  in the .f90 file, line up
a few lines that changed when the names of the subroutines
changed.  no executable code changes.

Modified Paths:
--------------
    DART/branches/development/ensemble_manager/ensemble_manager_mod.f90
    DART/branches/development/ensemble_manager/ensemble_manager_mod.html
    DART/branches/development/ensemble_manager/ensemble_manager_mod.nml

-------------- next part --------------
Modified: DART/branches/development/ensemble_manager/ensemble_manager_mod.f90
===================================================================
--- DART/branches/development/ensemble_manager/ensemble_manager_mod.f90	2013-05-29 16:23:47 UTC (rev 6186)
+++ DART/branches/development/ensemble_manager/ensemble_manager_mod.f90	2013-05-29 16:50:55 UTC (rev 6187)
@@ -52,9 +52,9 @@
           get_copy,                   put_copy,                 all_vars_to_all_copies, &
           all_copies_to_all_vars,     read_ensemble_restart,    write_ensemble_restart, &
           compute_copy_mean_var,      get_copy_owner_index,     set_ensemble_time,      &
-          broadcast_copy,             prepare_to_write_to_vars,          prepare_to_write_to_copies,      &
-          prepare_to_read_from_vars,          prepare_to_read_from_copies,      prepare_to_update_vars,          &
-          prepare_to_update_copies,            print_ens_handle,                                 &
+          broadcast_copy,             prepare_to_write_to_vars, prepare_to_write_to_copies, &
+          prepare_to_read_from_vars,  prepare_to_read_from_copies, prepare_to_update_vars,  &
+          prepare_to_update_copies,   print_ens_handle,                                 &
           map_task_to_pe,             map_pe_to_task
 
 type ensemble_type

Modified: DART/branches/development/ensemble_manager/ensemble_manager_mod.html
===================================================================
--- DART/branches/development/ensemble_manager/ensemble_manager_mod.html	2013-05-29 16:23:47 UTC (rev 6186)
+++ DART/branches/development/ensemble_manager/ensemble_manager_mod.html	2013-05-29 16:50:55 UTC (rev 6187)
@@ -70,7 +70,8 @@
 <pre>
 <em class=call>namelist / ensemble_manager_nml / </em>
    single_restart_file_in, single_restart_file_out, perturbation_amplitude,
-   use_copy2var_send_loop, use_var2copy_rec_loop, layout, tasks_per_node
+   layout, tasks_per_node, communication_configuration, flag_unneeded_transposes,
+   debug
 </pre>
 </div>
 
@@ -113,14 +114,6 @@
       the initial states into a set of members with enough spread and which
       match the current set of observations.
       Default: 0.2_r8</TD></TR>
-<TR><!--contents--><TD valign=top>use_copy2var_send_loop</TD>
-    <!--  type  --><TD>logical</TD>
-    <!--descript--><TD>MPI communication flag* for all_copies_to_all_vars.
-     Default: .true.</TD></TR>
-<TR><!--contents--><TD valign=top>use_var2copy_rec_loop</TD>
-    <!--  type  --><TD>logical</TD>
-    <!--descript--><TD>MPI communication flag* for all_vars_to_all_copies.
-     Default: .true.</TD></TR>
  <TR><!--contents--><TD valign=top>layout</TD>
     <!--  type  --><TD valign=top>integer</TD>
     <!--descript--><TD>Determines the process (pe) layout on MPI tasks.
@@ -135,12 +128,30 @@
     <!--descript--><TD>The number of tasks per node.  This
     is only used if layout = 2. 
      Default: 1</TD></TR>
+<TR><!--contents--><TD valign=top>communication_configuration</TD>
+    <!--  type  --><TD>integer</TD>
+    <!--descript--><TD>For most users, the default value of 1 is the best choice.
+     However there are multiple strategies for the internal MPI communication 
+     patterns (see *Note below).  Values from 
+     1 to 4 select different options; try the various options to see if one might
+     be faster than the others.  
+     Default: 1</TD></TR>
+<TR><!--contents--><TD valign=top>flag_unneeded_transposes</TD>
+    <!--  type  --><TD>logical</TD>
+    <!--descript--><TD>If true, print out when unnecessary transposes are executed.
+     This is generally used only during debugging and should be .false. in most cases.
+     Default: .false.</TD></TR>
+<TR><!--contents--><TD valign=top>debug</TD>
+    <!--  type  --><TD>logical</TD>
+    <!--descript--><TD>If true print debugging information.
+     Default: .false.</TD></TR>
 </TABLE>
 
 <P>
 <i>*Note about MPI communication flags:</i>
 <br />
-use_copy2var_send_loop and use_var2copy_rec_loop are flags that change the order of the MPI
+The communication_configuration flags select various combinations of the internal settings for
+use_copy2var_send_loop and use_var2copy_rec_loop.  These flags change the order of the MPI
 send and MPI receives in the the routines all_copies_to_all_vars and all_vars_to_all_copies.
 The figures below show the data transferred between tasks for an 80 member ensemble.
 The left figure is using 96 tasks, the right figure is using 512 tasks. As the number of tasks

Modified: DART/branches/development/ensemble_manager/ensemble_manager_mod.nml
===================================================================
--- DART/branches/development/ensemble_manager/ensemble_manager_mod.nml	2013-05-29 16:23:47 UTC (rev 6186)
+++ DART/branches/development/ensemble_manager/ensemble_manager_mod.nml	2013-05-29 16:50:55 UTC (rev 6187)
@@ -2,7 +2,10 @@
    single_restart_file_in  = .true.,
    single_restart_file_out = .true.,
    perturbation_amplitude  = 0.2,
-   use_copy2var_send_loop = .true.,
-   use_var2copy_rec_loop = .true. 
+   layout = 1,
+   tasks_per_node = 1,
+   communication_configuration = 1,
+   flag_unneeded_transposes = .false.,
+   debug = .false.
  /
 


More information about the Dart-dev mailing list