Contents of /MITgcm_contrib/tides/README

The scripts in this directory are for adding tidal boundary condition 
to a regional configuration of MITgcm.  

The scripts are tested for Pine Island Model  

Steps  to add tide boundary conditions  to regional MITgcm 
0) Download the Circum-Antarctic Tide (CAT) Solution (Padman et al. 2002)
   from Earth and Space Research, http://www.esr.org.
   Modify CAT directory in test_tide_bc.m 

1) use create_bc_grid.m (test_bc_grid.m) to generate bc grid files. 
   create_bc_grid.m will generate files with names like 
   bdry_grid_[snwe].mat for south, north, west, and east boundary.  
   This script needs a directory path for MITgcm domain related files, 
   especially YC.data, XC.data, hFacC.data, AngleCS.data, AngleSN.data. 

2) use create_tide_bc_4bdry.m to generate tidal bc files (test_tide_bc.m) 
   Or dummy tidal bc files (zero amplitde and phase) for land boundary 
   if there is such a need. 

   create_tide_bc_4bdary.m will generate tidal bounday files with names 
   like OB[SNWE]{am ph}.seaice_obcs and a time constant in seconds
   which will be used in obcs_add_tides.F  
   The obcs_add_tides.F is included in this directory to explain how 
   timec is used. This part (using timec)  will be changed in future.  

3) Modify data.obcs as following  
   The number of tidal constituents to be included and their order 
   should be consistent for tidal periods and tidal current amplitude and 
   phase files,  OB?amFile and OB?phFile.
   useOBCStides = .TRUE. 
   tidalperiod = ...
   OBSamFile =  ...
   OBNamFile =  ...
   OBWamFile = ... 
   OBEamFile = ... 
   OBSphFile = ...
   OBNphFile = ...
   OBWphFile = ...
   OBEphFile = ... 


CAT Reference 
Padman, L., H. A. Fricker, R. Coleman, S. Howard, and S. Erofeeva, 2002: A new tidal model for the
Antarctic ice shelves and seas, Ann. Glaciol., 34, 247-254.


XC WANG 15 Mar  2013 
XC WANG 07 Feb. 2013 
XC WANG 20 Dec. 2012 
xiaochun.wang@jpl.nasa.gov 
1	The scripts in this directory are for adding tidal boundary condition
2	to a regional configuration of MITgcm.
3
4	The scripts are tested for Pine Island Model
5
6	Steps to add tide boundary conditions to regional MITgcm
7	0) Download the Circum-Antarctic Tide (CAT) Solution (Padman et al. 2002)
8	from Earth and Space Research, http://www.esr.org.
9	Modify CAT directory in test_tide_bc.m
10
11	1) use create_bc_grid.m (test_bc_grid.m) to generate bc grid files.
12	create_bc_grid.m will generate files with names like
13	bdry_grid_[snwe].mat for south, north, west, and east boundary.
14	This script needs a directory path for MITgcm domain related files,
15	especially YC.data, XC.data, hFacC.data, AngleCS.data, AngleSN.data.
16
17	2) use create_tide_bc_4bdry.m to generate tidal bc files (test_tide_bc.m)
18	Or dummy tidal bc files (zero amplitde and phase) for land boundary
19	if there is such a need.
20
21	create_tide_bc_4bdary.m will generate tidal bounday files with names
22	like OB[SNWE]{am ph}.seaice_obcs and a time constant in seconds
23	which will be used in obcs_add_tides.F
24	The obcs_add_tides.F is included in this directory to explain how
25	timec is used. This part (using timec) will be changed in future.
26
27	3) Modify data.obcs as following
28	The number of tidal constituents to be included and their order
29	should be consistent for tidal periods and tidal current amplitude and
30	phase files, OB?amFile and OB?phFile.
31	useOBCStides = .TRUE.
32	tidalperiod = ...
33	OBSamFile = ...
34	OBNamFile = ...
35	OBWamFile = ...
36	OBEamFile = ...
37	OBSphFile = ...
38	OBNphFile = ...
39	OBWphFile = ...
40	OBEphFile = ...
41
42
43
44	CAT Reference
45	Padman, L., H. A. Fricker, R. Coleman, S. Howard, and S. Erofeeva, 2002: A new tidal model for the
46	Antarctic ice shelves and seas, Ann. Glaciol., 34, 247-254.
47
48
49	XC WANG 15 Mar 2013
50	XC WANG 07 Feb. 2013
51	XC WANG 20 Dec. 2012
52	xiaochun.wang@jpl.nasa.gov