Changes between Version 12 and Version 13 of doc/tec/nesting


Ignore:
Timestamp:
Aug 2, 2018 10:17:29 AM (7 years ago)
Author:
suehring
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • doc/tec/nesting

    v12 v13  
    55The following example provide a step-by-step tutorial on how to set up a nesting system with one parent (root) domain and two child domains.
    66
    7 1. Prepare parameter files for all domains, e.g. for run with topography and separate topography data for each domain:
     71. Prepare parameter files for all domains, e.g. topography files or static drivers and separate each file for each domain:
    88{{{
    99testrun_p3d (root/parent domain)
    10 testrun_02_p3d (child domain 1)
    11 testrun_03_p3d (child domain 2)
     10testrun_p3d_N02 (child domain 1)
     11testrun_p3d_N03 (child domain 2)
    1212testrun_topo
    13 testrun_02_topo
    14 testrun_03_topo
     13testrun_topo_N02
     14testrun_topo_N03
     15testrun_static
     16testrun_static_N02
     17testrun_static_N03
    1518}}}
    1619Note that numbering of the child domains must start with "02" as "01" is internally reserved for the root domain.
    1720
    18 2. The nesting system is activated by specifying a {{{&nestpar}}} NAMELIST in the _p3d file of the '''root domain''', e.g.:
     212. The nesting system is activated by specifying a {{{&nesting_parameters}}} NAMELIST in the _p3d file of the '''root domain''', e.g.:
    1922{{{
    20  &nestpar domain_layouts = 'root domain',      1,  -1,  24,    0.0,    0.0,
     23 &nesting_parameters domain_layouts = 'root domain',      1,  -1,  24,    0.0,    0.0,
    2124                           'child domain 1',   2,   1,  24,  100.0,  100.0,
    2225                           'child domain 2',   3,   2,  24,  200.0,  200.0,
     
    2730For details on the parameters, see [wiki:doc/app/nestpar#nestpar nestpar].
    2831
    29 3. Add file connection statements for all child domains to the {{{.mrun.config}}} file,
     323. Add file connection statements for all child domains to the {{{.palm.config.xxx}}} file,
    3033{{{
    3134#----------------------------------------------------------------------------
     
    3740TOPOGRAPHY_DATA_03        in:locopt     nest#      $base_data/$fname/INPUT   _03_topo
    3841#----------------------------------------------------------------------------
    39 # List of output-files for nested domains
    40 #----------------------------------------------------------------------------
    41 RUN_CONTROL_02     out:loc:tr   nest#     $base_data/$fname/MONITORING  _2_rc
    42 RUN_CONTROL_02     out:loc:tra  nestf     $base_data/$fname/MONITORING  _2_rc
    43 HEADER_02          out:loc:tr   nest#     $base_data/$fname/MONITORING  _2_header
    44 HEADER_02          out:loc:tra  nestf     $base_data/$fname/MONITORING  _2_header
    45 CPU_MEASURES_02    out:loc:tr   nest#     $base_data/$fname/MONITORING  _2_cpu
    46 CPU_MEASURES_02    out:loc:tra  nestf     $base_data/$fname/MONITORING  _2_cpu
    47 BINOUT_02          out:loc:flpe restart   $base_data/$fname/RESTART     _2_d3d
    48 #
    49 RUN_CONTROL_03     out:loc:tr   nest#     $base_data/$fname/MONITORING  _3_rc
    50 RUN_CONTROL_03     out:loc:tra  nestf     $base_data/$fname/MONITORING  _3_rc
    51 HEADER_03          out:loc:tr   nest#     $base_data/$fname/MONITORING  _3_header
    52 HEADER_03          out:loc:tra  nestf     $base_data/$fname/MONITORING  _3_header
    53 CPU_MEASURES_03    out:loc:tr   nest#     $base_data/$fname/MONITORING  _3_cpu
    54 CPU_MEASURES_03    out:loc:tra  nestf     $base_data/$fname/MONITORING  _3_cpu
    55 BINOUT_03          out:loc:flpe restart   $base_data/$fname/RESTART     _3_d3d
    56 #
    57 DATA_1D_PR_NETCDF_02    out:loc:tr pro#:prof   $base_data/$fname/OUTPUT _2_pr  nc
    58 DATA_1D_SP_NETCDF_02    out:loc:tr spo#:spof   $base_data/$fname/OUTPUT _2_sp  nc
    59 DATA_1D_TS_NETCDF_02    out:loc:tr tso#:tsof   $base_data/$fname/OUTPUT _2_ts  nc
    60 DATA_1D_PTS_NETCDF_02   out:loc:tr ptso#:ptsof $base_data/$fname/OUTPUT _2_pts nc
    61 DATA_2D_XY_NETCDF_02    out:loc:tr xyo#:xyof   $base_data/$fname/OUTPUT _2_xy  nc
    62 DATA_2D_XY_AV_NETCDF_02 out:loc:tr xyo#:xyof   $base_data/$fname/OUTPUT _2_xy_av  nc
    63 DATA_2D_XZ_NETCDF_02    out:loc:tr xzo#:xzof   $base_data/$fname/OUTPUT _2_xz  nc
    64 DATA_2D_XZ_AV_NETCDF_02 out:loc:tr xzo#:xzof   $base_data/$fname/OUTPUT _2_xz_av  nc
    65 DATA_2D_YZ_NETCDF_02    out:loc:tr yzo#:yzof   $base_data/$fname/OUTPUT _2_yz  nc
    66 DATA_2D_YZ_AV_NETCDF_02 out:loc:tr yzo#:yzof   $base_data/$fname/OUTPUT _2_yz_av  nc
    67 DATA_3D_NETCDF_02       out:loc:tr 3do#:3dof   $base_data/$fname/OUTPUT _2_3d  nc
    68 DATA_3D_AV_NETCDF_02    out:loc:tr 3do#:3dof   $base_data/$fname/OUTPUT _2_3d_av nc
    69 #
    70 DATA_1D_PR_NETCDF_03    out:loc:tr pro:prof   $base_data/$fname/OUTPUT _3_pr  nc
    71 DATA_1D_SP_NETCDF_03    out:loc:tr spo#:spof   $base_data/$fname/OUTPUT _3_sp  nc
    72 DATA_1D_TS_NETCDF_03    out:loc:tr tso#:tsof   $base_data/$fname/OUTPUT _3_ts  nc
    73 DATA_1D_PTS_NETCDF_03   out:loc:tr ptso#:ptsof $base_data/$fname/OUTPUT _3_pts nc
    74 DATA_2D_XY_NETCDF_03    out:loc:tr xyo#:xyof   $base_data/$fname/OUTPUT _3_xy  nc
    75 DATA_2D_XY_AV_NETCDF_03 out:loc:tr xyo#:xyof   $base_data/$fname/OUTPUT _3_xy_av  nc
    76 DATA_2D_XZ_NETCDF_03    out:loc:tr xzo#:xzof   $base_data/$fname/OUTPUT _3_xz  nc
    77 DATA_2D_XZ_AV_NETCDF_03 out:loc:tr xzo#:xzof   $base_data/$fname/OUTPUT _3_xz_av  nc
    78 DATA_2D_YZ_NETCDF_03    out:loc:tr yzo#:yzof   $base_data/$fname/OUTPUT _3_yz  nc
    79 DATA_2D_YZ_AV_NETCDF_03 out:loc:tr yzo#:yzof   $base_data/$fname/OUTPUT _3_yz_av  nc
    80 DATA_3D_NETCDF_03       out:loc:tr 3do#:3dof   $base_data/$fname/OUTPUT _3_3d  nc
    81 DATA_3D_AV_NETCDF_03    out:loc:tr 3do#:3dof   $base_data/$fname/OUTPUT _3_3d_av nc
    82 }}}
    83 '''Attention:''' To get NetCDF output from the children requires to set the runtime_parameters-parameter {{{netcdf_data_format}}} = 5 or 6 (parallel I/O support). Otherwise, the NetCDF files are created but will be empty (filled with zero data only).
    84 
    85 4. Execute {{{mrun}}} and specify the nesting input files, i.e.,
     424. Execute {{{palmrun}}} and specify the nesting input files, i.e.,
    8643{{{
    87 mrun -d testrun -r "d3# nest# ts# pr# ... tso# pro# ..." -X "72" ...
     44palmrun -d testrun -r "d3# *" ...
    8845}}}
    8946Make sure that the total number of PEs (here 72) the sum of the PEs allocated for the individual domains (3 x 24).