New URL for NEMO forge!   http://forge.nemo-ocean.eu

Since March 2022 along with NEMO 4.2 release, the code development moved to a self-hosted GitLab.
This present forge is now archived and remained online for history.
Users/ModelInterfacing/AGRIF (diff) – NEMO

Changes between Version 5 and Version 6 of Users/ModelInterfacing/AGRIF


Ignore:
Timestamp:
2018-08-30T15:17:19+02:00 (6 years ago)
Author:
jchanut
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Users/ModelInterfacing/AGRIF

    v5 v6  
    2323Note that rectangular regions must be defined so that they are connected to a single parent grid. Hence, defining for instance overlapping grids with the same refinement ratio will not work properly, boundary data exchange and update being only performed between root and child grids. 
    2424 
    25 Knowing the refinement area you may choose, a pre-processing tool (NESTING directory in tools) helps to create needed input files (mesh file, restart, climatological and forcing files). The key here is to ensure volume matching near the child grid interface, a step done by invoking the Agrif_create_bathy.exe program. You may use the namelists provided in the NESTING directory as a guide. These correspond to the namelists used to create AGRIF_DEMO inputs.  
     25Knowing the refinement factors and area, a pre-processing tool (NESTING directory in tools) may help to create needed input files (mesh file, restart, climatological and forcing files). The key here to maintain robustness is to ensure volume matching near the child grid interface, a step done by invoking the Agrif_create_bathy.exe program. You may use the namelists provided in the NESTING directory as a guide. These correspond to the namelists used to create AGRIF_DEMO inputs.  
    2626 
    2727AGRIF is continuously maintained so that it can be activated with all NEMO components (OPA, sea-ice, TOP). Depending on NEMO version, it is nevertheless not the case so that some options may not be compatible with the use of online grid refinement. Check out the table below to know the status according to the NEMO release you may use. 
     
    121121 
    122122== Available in the forthcoming 4.0 
    123 [[span(''To be completed'', style=background-color:lime)]] 
     123The [wiki:Users/Announcement_4.0.beta_release 4.0 beta release is now available] and includes new configurations and test cases with AGRIF, see below: 
     124=== New reference configuration with AGRIF: AGRIF_DEMO  
    124125 
    125 In addition to the reference configurations in the 3_6 release, the [wiki:Users/Announcement_4.0.beta_release 4.0 beta release is now available] and includes new configurations and test cases with AGRIF, see below: 
    126 === New reference configurations with AGRIF  
    127  
    128 * AGRIF_DEMO ''to be described'' 
     126AGRIF_DEMO is based on the [wiki:Users/ReferenceConfigurations/ORCA2_LIM3_PISCES] global 2° configuration but it includes 3 online nested grids that should demonstrate the overall capabilities of AGRIF in a realistic context, including nesting sea ice models. The configuration includes a 1:1 grid in the Pacific and two successively nested grids with odd and even refinement ratios over the Arctic ocean. The finest grid spanning the whole Svalbard archipelago is of particular interest to check that sea ice coupling is done properly. The 1:1 grid, used alone, is used as a benchmark to check that the solution is not corrupted by grid exchanges. Note that since grids interact only at the baroclinic time level, numerically exact results can not be achieved in the 1:1 case. One has to switch to a fully explicit in place of a split explicit free surface scheme in order to retrieve perfect reproducibility.    
    129127  {{{#!td style="border: none;" 
    130128    [[Image(wiki:Users/ModelInterfacing/AGRIF:AGRIF_DEMO.jpg,width=600)]] 
    131129  }}} 
    132 [[span(''To be completed'', style=background-color:lime)]] 
     130 
    133131=== New tests cases demonstrating some major features of AGRIF with NEMO: 
    134 [[span(''To be completed'', style=background-color:lime)]] 
     132 * ICEDYN:  
     133This is an East-west + north-south periodic channel. The configuration includes an AGRIF zoom (1:3) in the middle of the basin to test how an ice patch is advected through it but one can also test the advection schemes (Prather and Ultimate-Macho) by removing the key_agrif in the cpp keys. 
     134 
     135 * VORTEX: 
     136This test case illustrates the propagation of an anticyclonic eddy over a Beta plan and a flat bottom. It is implemented here with an online refined subdomain (1:3) out of which the vortex propagates. It serves as a benchmark for quantitative estimates of nesting errors as in Debreu et al. (2012), Penven et al. (2006) or Spall and Holland (1991). The animation below illustrates, with two 1:2 successfully nested grids, how the vortex smoothly propagates out of the refined grids.  
     137  
     138  {{{#!td style="border: none;" 
     139    [[Image(wiki:Users/ModelInterfacing/AGRIF:VORTEX_anim.gif,width=600)]] 
     140  }}} 
    135141 
    136142== AGRIF in NEMO documentation 
     
    140146* How to set up a new configuration 
    141147* ... 
    142