Difference between revisions of "Lake Jersey Refinement Example Introduction"

From WikiROMS
Jump to navigationJump to search
(Created page with "<div class="title">Lake Jersey Nesting Refinement Example</div>__NOTOC__ Using the Lake Jersey test case, this example details many grid refinement configurations possible in R…")   (change visibility)
 
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<div class="title">Lake Jersey Nesting Refinement Example</div>__NOTOC__
<div class="title">Lake Jersey Nesting Refinement Examples</div>__NOTOC__
 
 
The Lake Jersey is an idealized ROMS example used primarily to test the nesting algorithms for the Refinement Grids Super-Class.  It is a wind forced test with strong upwelling and upwelling plumes. The model is started from rest with uniform potential temperature and salinity.  It is run only for two days for efficiency with history and time-averaged output every 30 minutes.
 
Various configurations of refined grids are possible including refinement ratio, telescoping grids ('''a''', '''d''', and '''e'''), and nesting layers.  The order of the nested grids in ROMS is extremely important so several examples are shown to illustrate the various possibilities. Currently, there are four refined grids inside the coarse grid. The following table summarize the nested grids information:
 
<div style="padding-left: 25px">
{| id="grids" border="1" cellspacing="0" cellpadding="5" align="left"
! colspan="9" | Lake Jersey Grid Information
|-
!Grid
!Mesh<br />Size
!Refinement<br />Factor
!Parent<br />Imin
!Parent<br />Imax
!Parent<br />Jmin
!Parent<br />Jmax
!&Delta;x<br />&Delta;y
!Grid NetCDF File
|-
|align="center" | '''a'''
|align="right"  | 100x 80x8
|align="center" | <nowiki>-</nowiki>
|align="center" | <nowiki>-</nowiki>
|align="center" | <nowiki>-</nowiki>
|align="center" | <nowiki>-</nowiki>
|align="center" | <nowiki>-</nowiki>
|align="right"  | 500.0 m
|align="right"  | lake_jersey_grd_a.nc
|-
|align="center" | '''b'''
|align="right"  | 66x99x8
|align="center" | 1:3 from '''a'''
|align="center" | 9
|align="center" | 31
|align="center" | 12
|align="center" | 45
|align="right"  | 166.6 m
|align="right"  | lake_jersey_grd_b.nc
|-
|align="center" | '''c'''
|align="right"  | 120x130x8
|align="center" | 1:5 from '''a'''
|align="center" | 34
|align="center" | 58
|align="center" | 19
|align="center" | 45
|align="right"  | 100.0 m
|align="right"  | lake_jersey_grd_c.nc
|-
|align="center" | '''d'''
|align="right"  | 114x60x8
|align="center" | 1:3 from '''a'''
|align="center" | 50
|align="center" | 88
|align="center" | 50
|align="center" | 70
|align="right"  | 166.6 m
|align="right"  | lake_jersey_grd_d.nc
|-
|align="center" | '''e'''
|align="right"  | 132x60x8
|align="center" | 1:3 from '''d'''
|align="center" | 36
|align="center" | 80
|align="center" | 20
|align="center" | 40
|align="right"  | 55.5 m
|align="right"  | lake_jersey_grd_e.nc
|}
 
<div style="clear: both"></div>




Using the Lake Jersey test case, this example details many grid refinement configurations possible in ROMS.


<!-- Edit Template:Refinement_Exe_TOC to modify this Table of Contents-->
<!-- Edit Template:Refinement_Exe_TOC to modify this Table of Contents-->
Line 8: Line 79:


<div style="clear: both"></div>
<div style="clear: both"></div>


==Obtaining Test Cases==
==Obtaining Test Cases==
The test cases can be obtained using [[Subversion]] with the following command:
The test cases can be obtained using [[Subversion]] with the following command:


     <span class="red">svn checkout <nowiki>https://www.myroms.org/svn/src/test</nowiki> </span>
     <span class="red">svn checkout <nowiki>https://www.myroms.org/svn/src/test</nowiki> </span>


In this example we use files from the '''lake_jersey''' test case.
The configuration and input NetCDF file can be found in the '''test/lake_jersey''' sub-directory.
 
 
==Nested Grid Diagram==
 
The following diagram illustrate the location of all the nested grids.  Grid a is the coarser grid at 500m resolution.  The above table provides the information of the coordinates used to extract the refined grids from the donor grid.  The Matlab script [[Grid_Processing_Scripts#grid_extract|grid_extract.m]] the refine grids.  For example:
 
<span class="twilightBlue"> >>  Imin = 34;<br \> >>  Imax = 58;<br \> >>  Jmin = 19;<br \> >>  Jmax = 45;<br \> >>  C = coarse2fine ('lake_jersey_grd_a.nc', 'lake_jersey_grd_c.nc', 5, Imin, Imax, Jmin, Jmax);</span>
 
In the Menu above, the link '''Lake Jersey ACDE''' correspond to a nesting application including grids '''a''', '''c''', '''d''', and '''e'''.  Notice that this example has two telescoping grids ('''d''' and '''e''') and they are ordered last.
 
 
[[Image:Lake_Jersey_grids.png|thumb|800px|left|Click image to view full resolution]]<div style="clear: both"></div>
 
 
Below is a zoom detailing the relative grid resolutions.


==Nested Grid Locations==
The labeled grids correspond to the example titles above. For Example, '''Lake Jersey ABDE''' is a multiple grid nesting setup using grids '''a''', '''b''', '''d''', and '''e'''.


[[Image:Lake_Jersey_grids.png|thumb|800px|left|Click image to view full resolution]]
[[Image:lake_jersey_grids_mesh_zoom.png|thumb|800px|left|Click image to view full resolution]]<div style="clear: both"></div>

Latest revision as of 14:47, 12 December 2014

Lake Jersey Nesting Refinement Examples


The Lake Jersey is an idealized ROMS example used primarily to test the nesting algorithms for the Refinement Grids Super-Class. It is a wind forced test with strong upwelling and upwelling plumes. The model is started from rest with uniform potential temperature and salinity. It is run only for two days for efficiency with history and time-averaged output every 30 minutes.

Various configurations of refined grids are possible including refinement ratio, telescoping grids (a, d, and e), and nesting layers. The order of the nested grids in ROMS is extremely important so several examples are shown to illustrate the various possibilities. Currently, there are four refined grids inside the coarse grid. The following table summarize the nested grids information:

Lake Jersey Grid Information
Grid Mesh
Size
Refinement
Factor
Parent
Imin
Parent
Imax
Parent
Jmin
Parent
Jmax
Δx
Δy
Grid NetCDF File
a 100x 80x8 - - - - - 500.0 m lake_jersey_grd_a.nc
b 66x99x8 1:3 from a 9 31 12 45 166.6 m lake_jersey_grd_b.nc
c 120x130x8 1:5 from a 34 58 19 45 100.0 m lake_jersey_grd_c.nc
d 114x60x8 1:3 from a 50 88 50 70 166.6 m lake_jersey_grd_d.nc
e 132x60x8 1:3 from d 36 80 20 40 55.5 m lake_jersey_grd_e.nc



Obtaining Test Cases

The test cases can be obtained using Subversion with the following command:

   svn checkout https://www.myroms.org/svn/src/test 

The configuration and input NetCDF file can be found in the test/lake_jersey sub-directory.


Nested Grid Diagram

The following diagram illustrate the location of all the nested grids. Grid a is the coarser grid at 500m resolution. The above table provides the information of the coordinates used to extract the refined grids from the donor grid. The Matlab script grid_extract.m the refine grids. For example:

 >>  Imin = 34;
>> Imax = 58;
>> Jmin = 19;
>> Jmax = 45;
>> C = coarse2fine ('lake_jersey_grd_a.nc', 'lake_jersey_grd_c.nc', 5, Imin, Imax, Jmin, Jmax);

In the Menu above, the link Lake Jersey ACDE correspond to a nesting application including grids a, c, d, and e. Notice that this example has two telescoping grids (d and e) and they are ordered last.


Click image to view full resolution


Below is a zoom detailing the relative grid resolutions.


Click image to view full resolution