Zoom Regions

From tm5
Jump to: navigation, search

TM5 allows users to define up to 4 zoom regions. Zoom regions are 2-way nested. The corresponding settings are (1) in the main rc file, and (2) in the region rc file, where the regions are defined.

Main RC settings

Look for the "Grids & Levels" section of the file. Here is a working example:

 1  !=====================================================================!
 2  ! Grids & Levels
 3  !=====================================================================!
 4  my.levs                     :  tropo34
 5  ! regions name
 6  my.region1                  :  glb600x400
 7  my.region2                  :  eur300x200
 8  my.region3                  :  eur100x100
 9  my.region4                  :  sam300x200
10  my.region5                  :  sam100x100
11  ! regions meteo grid
12  my.region1m                 :  glb100x100
13  my.region2m                 :  glb100x100
14  my.region3m                 :  glb100x100
15  my.region4m                 :  glb100x100
16  my.region5m                 :  glb100x100
17   
18  ! parent regions for zoom
19  region.${my.region2}.parent :  ${my.region1}
20   
21  #if not("${my.region3}" == "") :
22  region.${my.region3}.parent :  ${my.region2}
23  #endif
24  #if not("${my.region4}" == "") :
25  region.${my.region4}.parent :  ${my.region1}
26  #endif
27  #if not("${my.region5}" == "") :
28  region.${my.region5}.parent :  ${my.region4}
29  #endif


line 6: name of the global region. It is used to define the name of the region file.

line 7-10: provide the name of each region. They should correspond to a definition in the region file, i.e. a set of region.<name>.* keys.

line 12-16: name of the meteo grid. If different from the region name, then the met fields are regridded on the fly.

line 18, 22, 25, 28: specify the parent of each region.


Region file settings

Each zoom region has a set of keys, which are the same as for the global region (see TODO for details). For example, this South-America region:

! zoom over South-America 1x1
region.sam100x100.xcyc               :     0
region.sam100x100.touch_np           :     0
region.sam100x100.touch_sp           :     0
region.sam100x100.xbeg               :   -84
region.sam100x100.xend               :   -33
region.sam100x100.ybeg               :   -32
region.sam100x100.yend               :    14
region.sam100x100.im                 :    51
region.sam100x100.jm                 :    46
region.sam100x100.xref               :     6
region.sam100x100.yref               :     4
region.sam100x100.zref               :     1
region.sam100x100.tref               :     4
region.sam100x100.redgrid.nh.n       :     0
region.sam100x100.redgrid.nh.comb    :
region.sam100x100.redgrid.sh.n       :     0
region.sam100x100.redgrid.sh.comb    :

Things to watch for when defining a zoom region:

"ERROR - could not match west bound of the grid"
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox