/[MITgcm]/MITgcm/model/src/ini_cartesian_grid.F
ViewVC logotype

Annotation of /MITgcm/model/src/ini_cartesian_grid.F

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph


Revision 1.17 - (hide annotations) (download)
Wed Sep 26 18:09:15 2001 UTC (22 years, 8 months ago) by cnh
Branch: MAIN
CVS Tags: checkpoint46n_post, checkpoint51k_post, checkpoint47e_post, checkpoint52l_pre, checkpoint44e_post, hrcube4, hrcube5, checkpoint46l_post, checkpoint57g_pre, checkpoint46g_pre, checkpoint47c_post, release1_p13_pre, checkpoint50c_post, checkpoint57b_post, checkpoint46f_post, checkpoint52d_pre, checkpoint57g_post, checkpoint48e_post, checkpoint56b_post, checkpoint50c_pre, checkpoint44f_post, checkpoint46b_post, checkpoint52j_pre, checkpoint43a-release1mods, checkpoint51o_pre, checkpoint54d_post, checkpoint54e_post, ecco_c50_e32, ecco_c50_e33, ecco_c50_e30, ecco_c50_e31, release1_p13, checkpoint51l_post, checkpoint48i_post, checkpoint46l_pre, checkpoint57d_post, checkpoint57i_post, checkpoint52l_post, checkpoint52k_post, chkpt44d_post, checkpoint55, checkpoint54, checkpoint57, checkpoint56, checkpoint51, checkpoint50, checkpoint53, checkpoint52, release1_p8, release1_p9, checkpoint50d_post, release1_p1, release1_p2, release1_p3, release1_p4, release1_p5, release1_p6, release1_p7, checkpoint52f_post, checkpoint50b_pre, checkpoint44e_pre, checkpoint54f_post, checkpoint51f_post, release1_b1, ecco_c51_e34d, ecco_c51_e34e, ecco_c51_e34f, ecco_c51_e34g, ecco_c51_e34a, ecco_c51_e34b, ecco_c51_e34c, checkpoint48b_post, checkpoint43, checkpoint51d_post, checkpoint48c_pre, checkpoint47d_pre, checkpoint51t_post, checkpoint51n_post, release1_chkpt44d_post, checkpoint55i_post, checkpoint52i_pre, hrcube_1, hrcube_2, hrcube_3, checkpoint51s_post, checkpoint47a_post, checkpoint55c_post, checkpoint48d_pre, checkpoint51j_post, checkpoint47i_post, checkpoint52e_pre, release1_p11, checkpoint57f_post, checkpoint52e_post, checkpoint51n_pre, checkpoint47d_post, icebear5, icebear4, icebear3, icebear2, checkpoint53d_post, checkpoint46d_pre, checkpoint57a_post, checkpoint48d_post, release1-branch_tutorials, checkpoint57h_pre, checkpoint48f_post, checkpoint45d_post, checkpoint52b_pre, checkpoint54b_post, checkpoint46j_pre, checkpoint57h_post, checkpoint51l_pre, checkpoint52m_post, chkpt44a_post, checkpoint55g_post, checkpoint44h_pre, checkpoint48h_post, checkpoint51q_post, ecco_c50_e29, checkpoint51b_pre, checkpoint46a_post, checkpoint47g_post, checkpoint52b_post, checkpoint52c_post, checkpoint46j_post, checkpoint51h_pre, checkpoint46k_post, ecco_c50_e28, chkpt44c_pre, checkpoint48a_post, checkpoint45a_post, checkpoint57c_post, checkpoint50f_post, checkpoint50a_post, checkpoint50f_pre, checkpoint52f_pre, checkpoint55d_post, ecco_c44_e19, ecco_c44_e18, ecco_c44_e17, ecco_c44_e16, release1_p12, release1_p10, release1_p16, release1_p17, release1_p14, release1_p15, checkpoint47j_post, checkpoint54a_pre, ecco_c50_e33a, checkpoint53c_post, checkpoint55d_pre, checkpoint57c_pre, checkpoint55j_post, branch-exfmods-tag, checkpoint44g_post, branchpoint-genmake2, checkpoint54a_post, checkpoint46e_pre, checkpoint55h_post, checkpoint51r_post, checkpoint48c_post, checkpoint45b_post, checkpoint46b_pre, checkpoint51i_post, checkpoint57e_post, release1-branch-end, release1_final_v1, checkpoint55b_post, checkpoint51b_post, checkpoint51c_post, checkpoint46c_pre, checkpoint53a_post, checkpoint46, checkpoint47b_post, checkpoint44b_post, checkpoint55f_post, ecco_c51_e34, checkpoint46h_pre, checkpoint52d_post, checkpoint53g_post, checkpoint46m_post, checkpoint46a_pre, checkpoint50g_post, checkpoint45c_post, ecco_ice2, ecco_ice1, checkpoint44h_post, eckpoint57e_pre, checkpoint46g_post, release1_p12_pre, checkpoint52a_pre, ecco_c44_e22, checkpoint50h_post, checkpoint52i_post, checkpoint50e_pre, checkpoint50i_post, ecco_c44_e25, checkpoint51i_pre, checkpoint52h_pre, checkpoint56a_post, checkpoint53f_post, checkpoint57h_done, checkpoint52j_post, checkpoint47f_post, checkpoint50e_post, chkpt44a_pre, checkpoint46i_post, ecco_c44_e23, ecco_c44_e20, ecco_c44_e21, ecco_c44_e26, ecco_c44_e27, ecco_c44_e24, checkpoint57j_post, checkpoint57f_pre, checkpoint46c_post, ecco-branch-mod1, ecco-branch-mod2, ecco-branch-mod3, ecco-branch-mod4, ecco-branch-mod5, branch-netcdf, checkpoint50d_pre, checkpoint52n_post, checkpoint53b_pre, checkpoint46e_post, release1_beta1, checkpoint56c_post, checkpoint51e_post, checkpoint44b_pre, checkpoint42, checkpoint57a_pre, checkpoint41, checkpoint55a_post, checkpoint47, checkpoint44, checkpoint45, checkpoint48, checkpoint49, checkpoint46h_post, checkpoint51o_post, checkpoint57k_post, checkpoint51f_pre, chkpt44c_post, checkpoint48g_post, checkpoint53b_post, checkpoint47h_post, checkpoint52a_post, checkpoint44f_pre, checkpoint51g_post, ecco_c52_e35, checkpoint46d_post, checkpoint50b_post, release1-branch_branchpoint, checkpoint51m_post, checkpoint53d_pre, checkpoint55e_post, checkpoint54c_post, checkpoint51a_post, checkpoint51p_post, checkpoint51u_post
Branch point for: c24_e25_ice, branch-exfmods-curt, release1_final, release1-branch, branch-genmake2, release1, branch-nonh, tg2-branch, ecco-branch, release1_50yr, netcdf-sm0, icebear, checkpoint51n_branch, release1_coupled
Changes since 1.16: +46 -39 lines
Bringing comments up to data and formatting for document extraction.

1 cnh 1.17 C $Header: /u/gcmpack/models/MITgcmUV/model/src/ini_cartesian_grid.F,v 1.16 2001/05/29 14:01:37 adcroft Exp $
2 adcroft 1.16 C $Name: $
3 cnh 1.1
4 cnh 1.10 #include "CPP_OPTIONS.h"
5 cnh 1.1
6 cnh 1.17 CBOP
7     C !ROUTINE: INI_CARTESIAN_GRID
8     C !INTERFACE:
9 cnh 1.1 SUBROUTINE INI_CARTESIAN_GRID( myThid )
10 cnh 1.17 C !DESCRIPTION: \bv
11     C *==========================================================*
12     C | SUBROUTINE INI_CARTESIAN_GRID
13     C | o Initialise model coordinate system
14     C *==========================================================*
15     C | The grid arrays, initialised here, are used throughout
16     C | the code in evaluating gradients, integrals and spatial
17     C | avarages. This routine
18     C | is called separately by each thread and initialises only
19     C | the region of the domain it is "responsible" for.
20     C | Notes:
21     C | Two examples are included. One illustrates the
22     C | initialisation of a cartesian grid (this routine).
23     C | The other shows the
24     C | inialisation of a spherical polar grid. Other orthonormal
25     C | grids can be fitted into this design. In this case
26     C | custom metric terms also need adding to account for the
27     C | projections of velocity vectors onto these grids.
28     C | The structure used here also makes it possible to
29     C | implement less regular grid mappings. In particular
30     C | o Schemes which leave out blocks of the domain that are
31     C | all land could be supported.
32     C | o Multi-level schemes such as icosohedral or cubic
33     C | grid projections onto a sphere can also be fitted
34     C | within the strategy we use.
35     C | Both of the above also require modifying the support
36     C | routines that map computational blocks to simulation
37     C | domain blocks.
38     C | Under the cartesian grid mode primitive distances in X
39     C | and Y are in metres. Disktance in Z are in m or Pa
40     C | depending on the vertical gridding mode.
41     C *==========================================================*
42     C \ev
43    
44     C !USES:
45 adcroft 1.12 IMPLICIT NONE
46 cnh 1.1 C === Global variables ===
47     #include "SIZE.h"
48     #include "EEPARAMS.h"
49     #include "PARAMS.h"
50     #include "GRID.h"
51    
52 cnh 1.17 C !INPUT/OUTPUT PARAMETERS:
53 cnh 1.1 C == Routine arguments ==
54     C myThid - Number of this instance of INI_CARTESIAN_GRID
55     INTEGER myThid
56    
57 cnh 1.17 C !LOCAL VARIABLES:
58 cnh 1.1 C == Local variables ==
59 adcroft 1.16 INTEGER iG, jG, bi, bj, I, J
60     _RL xG0, yG0
61 cnh 1.17 C "Long" real for temporary coordinate calculation
62     C NOTICE the extended range of indices!!
63 adcroft 1.16 _RL xGloc(1-Olx:sNx+Olx+1,1-Oly:sNy+Oly+1)
64     _RL yGloc(1-Olx:sNx+Olx+1,1-Oly:sNy+Oly+1)
65 cnh 1.17 C These functions return the "global" index with valid values beyond
66     C halo regions
67 adcroft 1.16 INTEGER iGl,jGl
68     iGl(I,bi) = 1+mod(myXGlobalLo-1+(bi-1)*sNx+I+Olx*Nx-1,Nx)
69     jGl(J,bj) = 1+mod(myYGlobalLo-1+(bj-1)*sNy+J+Oly*Ny-1,Ny)
70 cnh 1.17 CEOP
71 adcroft 1.16
72     C For each tile ...
73 cnh 1.1 DO bj = myByLo(myThid), myByHi(myThid)
74     DO bi = myBxLo(myThid), myBxHi(myThid)
75 adcroft 1.16
76     C-- "Global" index (place holder)
77     jG = myYGlobalLo + (bj-1)*sNy
78 cnh 1.1 iG = myXGlobalLo + (bi-1)*sNx
79    
80 adcroft 1.16 C-- First find coordinate of tile corner (meaning outer corner of halo)
81     xG0 = 0.
82     C Find the X-coordinate of the outer grid-line of the "real" tile
83     DO i=1, iG-1
84     xG0 = xG0 + delX(i)
85     ENDDO
86     C Back-step to the outer grid-line of the "halo" region
87     DO i=1, Olx
88     xG0 = xG0 - delX( 1+mod(Olx*Nx-1+iG-i,Nx) )
89     ENDDO
90     C Find the Y-coordinate of the outer grid-line of the "real" tile
91     yG0 = 0.
92     DO j=1, jG-1
93     yG0 = yG0 + delY(j)
94     ENDDO
95     C Back-step to the outer grid-line of the "halo" region
96     DO j=1, Oly
97     yG0 = yG0 - delY( 1+mod(Oly*Ny-1+jG-j,Ny) )
98     ENDDO
99    
100     C-- Calculate coordinates of cell corners for N+1 grid-lines
101     DO J=1-Oly,sNy+Oly +1
102     xGloc(1-Olx,J) = xG0
103     DO I=1-Olx,sNx+Olx
104     c xGloc(I+1,J) = xGloc(I,J) + delX(1+mod(Nx-1+iG-1+i,Nx))
105     xGloc(I+1,J) = xGloc(I,J) + delX( iGl(I,bi) )
106     ENDDO
107     ENDDO
108     DO I=1-Olx,sNx+Olx +1
109     yGloc(I,1-Oly) = yG0
110     DO J=1-Oly,sNy+Oly
111     c yGloc(I,J+1) = yGloc(I,J) + delY(1+mod(Ny-1+jG-1+j,Ny))
112     yGloc(I,J+1) = yGloc(I,J) + delY( jGl(J,bj) )
113     ENDDO
114     ENDDO
115    
116     C-- Make a permanent copy of [xGloc,yGloc] in [xG,yG]
117     DO J=1-Oly,sNy+Oly
118     DO I=1-Olx,sNx+Olx
119     xG(I,J,bi,bj) = xGloc(I,J)
120     yG(I,J,bi,bj) = yGloc(I,J)
121     ENDDO
122     ENDDO
123    
124     C-- Calculate [xC,yC], coordinates of cell centers
125     DO J=1-Oly,sNy+Oly
126     DO I=1-Olx,sNx+Olx
127     C by averaging
128     xC(I,J,bi,bj) = 0.25*(
129     & xGloc(I,J)+xGloc(I+1,J)+xGloc(I,J+1)+xGloc(I+1,J+1) )
130     yC(I,J,bi,bj) = 0.25*(
131     & yGloc(I,J)+yGloc(I+1,J)+yGloc(I,J+1)+yGloc(I+1,J+1) )
132     ENDDO
133     ENDDO
134    
135     C-- Calculate [dxF,dyF], lengths between cell faces (through center)
136     DO J=1-Oly,sNy+Oly
137     DO I=1-Olx,sNx+Olx
138     dXF(I,J,bi,bj) = delX( iGl(I,bi) )
139     dYF(I,J,bi,bj) = delY( jGl(J,bj) )
140     ENDDO
141     ENDDO
142    
143     C-- Calculate [dxG,dyG], lengths along cell boundaries
144     DO J=1-Oly,sNy+Oly
145     DO I=1-Olx,sNx+Olx
146     dXG(I,J,bi,bj) = delX( iGl(I,bi) )
147     dYG(I,J,bi,bj) = delY( jGl(J,bj) )
148     ENDDO
149     ENDDO
150    
151     C-- The following arrays are not defined in some parts of the halo
152     C region. We set them to zero here for safety. If they are ever
153     C referred to, especially in the denominator then it is a mistake!
154     DO J=1-Oly,sNy+Oly
155     DO I=1-Olx,sNx+Olx
156     dXC(I,J,bi,bj) = 0.
157     dYC(I,J,bi,bj) = 0.
158     dXV(I,J,bi,bj) = 0.
159     dYU(I,J,bi,bj) = 0.
160     rAw(I,J,bi,bj) = 0.
161     rAs(I,J,bi,bj) = 0.
162     ENDDO
163     ENDDO
164    
165     C-- Calculate [dxC], zonal length between cell centers
166     DO J=1-Oly,sNy+Oly
167     DO I=1-Olx+1,sNx+Olx ! NOTE range
168     dXC(I,J,bi,bj) = 0.5D0*(dXF(I,J,bi,bj)+dXF(I-1,J,bi,bj))
169 cnh 1.1 ENDDO
170     ENDDO
171 adcroft 1.16
172     C-- Calculate [dyC], meridional length between cell centers
173     DO J=1-Oly+1,sNy+Oly ! NOTE range
174     DO I=1-Olx,sNx+Olx
175     dYC(I,J,bi,bj) = 0.5*(dYF(I,J,bi,bj)+dYF(I,J-1,bi,bj))
176 cnh 1.1 ENDDO
177     ENDDO
178 adcroft 1.16
179     C-- Calculate [dxV,dyU], length between velocity points (through corners)
180     DO J=1-Oly+1,sNy+Oly ! NOTE range
181     DO I=1-Olx+1,sNx+Olx ! NOTE range
182     C by averaging (method I)
183     dXV(I,J,bi,bj) = 0.5*(dXG(I,J,bi,bj)+dXG(I-1,J,bi,bj))
184     dYU(I,J,bi,bj) = 0.5*(dYG(I,J,bi,bj)+dYG(I,J-1,bi,bj))
185     C by averaging (method II)
186     c dXV(I,J,bi,bj) = 0.5*(dXG(I,J,bi,bj)+dXG(I-1,J,bi,bj))
187     c dYU(I,J,bi,bj) = 0.5*(dYC(I,J,bi,bj)+dYC(I-1,J,bi,bj))
188 cnh 1.1 ENDDO
189     ENDDO
190 adcroft 1.16
191 cnh 1.1 C Calculate vertical face area
192 adcroft 1.16 DO J=1-Oly,sNy+Oly
193     DO I=1-Olx,sNx+Olx
194 adcroft 1.11 rA (I,J,bi,bj) = dxF(I,J,bi,bj)*dyF(I,J,bi,bj)
195     rAw(I,J,bi,bj) = dxC(I,J,bi,bj)*dyG(I,J,bi,bj)
196     rAs(I,J,bi,bj) = dxG(I,J,bi,bj)*dyC(I,J,bi,bj)
197 adcroft 1.14 rAz(I,J,bi,bj) = dxV(I,J,bi,bj)*dyU(I,J,bi,bj)
198 adcroft 1.16 tanPhiAtU(I,J,bi,bj) = 0.
199     tanPhiAtV(I,J,bi,bj) = 0.
200 cnh 1.6 ENDDO
201     ENDDO
202 cnh 1.1
203 adcroft 1.16 C-- Cosine(lat) scaling
204     DO J=1-OLy,sNy+OLy
205     cosFacU(J,bi,bj)=1.
206     cosFacV(J,bi,bj)=1.
207     sqcosFacU(J,bi,bj)=1.
208     sqcosFacV(J,bi,bj)=1.
209     ENDDO
210    
211     ENDDO ! bi
212     ENDDO ! bj
213    
214 cnh 1.1 RETURN
215     END

  ViewVC Help
Powered by ViewVC 1.1.22