1 |
C $Header: /u/gcmpack/models/MITgcmUV/model/src/ini_grid.F,v 1.9 2001/06/04 19:46:22 adcroft Exp $ |
2 |
C $Name: $ |
3 |
|
4 |
#include "CPP_OPTIONS.h" |
5 |
|
6 |
CBOP |
7 |
C !ROUTINE: INI_GRID |
8 |
C !INTERFACE: |
9 |
SUBROUTINE INI_GRID( myThid ) |
10 |
C !DESCRIPTION: \bv |
11 |
C *==========================================================* |
12 |
C | SUBROUTINE INI_GRID |
13 |
C | o Initialise model grid |
14 |
C *==========================================================* |
15 |
C | These arrays are used throughout the code in evaluating |
16 |
C | gradients, integrals and spatial avarages. This routine |
17 |
C | is called separately by each thread and initialise only |
18 |
C | the region of the domain it is "responsible" for. |
19 |
C | Notes: |
20 |
C | Two examples are shown in this code. One illustrates the |
21 |
C | initialisation of a cartesian grid. The other shows the |
22 |
C | inialisation of a spherical polar grid. Other orthonormal |
23 |
C | grids can be fitted into this design. In this case |
24 |
C | custom metric terms also need adding to account for the |
25 |
C | projections of velocity vectors onto these grids. |
26 |
C | The structure used here also makes it possible to |
27 |
C | implement less regular grid mappings. In particular |
28 |
C | o Schemes which leave out blocks of the domain that are |
29 |
C | all land could be supported. |
30 |
C | o Multi-level schemes such as icosohedral or cubic |
31 |
C | grid projectedions onto a sphere can also be fitted |
32 |
C | within the strategy we use. |
33 |
C | Both of the above also require modifying the support |
34 |
C | routines that map computational blocks to simulation |
35 |
C | domain blocks. |
36 |
C *==========================================================* |
37 |
C \ev |
38 |
|
39 |
C !USES: |
40 |
IMPLICIT NONE |
41 |
C === Global variables === |
42 |
#include "SIZE.h" |
43 |
#include "EEPARAMS.h" |
44 |
#include "PARAMS.h" |
45 |
#include "GRID.h" |
46 |
|
47 |
C !INPUT/OUTPUT PARAMETERS: |
48 |
C == Routine arguments == |
49 |
C myThid - Number of this instance of INI_GRID |
50 |
INTEGER myThid |
51 |
|
52 |
C !LOCAL VARIABLES: |
53 |
C == Local variables == |
54 |
C msgBuf - Used for informational I/O. |
55 |
CHARACTER*(MAX_LEN_MBUF) msgBuf |
56 |
CEOP |
57 |
|
58 |
C-- Set up vertical grid and coordinate system |
59 |
CALL INI_VERTICAL_GRID( myThid ) |
60 |
|
61 |
C-- Set up horizontal grid and coordinate system |
62 |
IF ( usingCartesianGrid ) THEN |
63 |
CALL INI_CARTESIAN_GRID( myThid ) |
64 |
ELSEIF ( usingSphericalPolarGrid ) THEN |
65 |
CALL INI_SPHERICAL_POLAR_GRID( myThid ) |
66 |
ELSEIF ( usingCurvilinearGrid ) THEN |
67 |
CALL INI_CURVILINEAR_GRID( myThid ) |
68 |
ELSE |
69 |
_BEGIN_MASTER(myThid) |
70 |
WRITE(msgBuf,'(A)') |
71 |
& 'S/R INI_GRID: No grid coordinate system has been selected' |
72 |
CALL PRINT_ERROR( msgBuf , myThid) |
73 |
STOP 'ABNORMAL END: S/R INI_GRID' |
74 |
_END_MASTER(myThid) |
75 |
ENDIF |
76 |
|
77 |
C-- Write certain grid data to files (useful for creating netCDF |
78 |
C and general post-analysis) |
79 |
CALL WRITE_FLD_XY_RS( 'XC',' ',XC,0,myThid) |
80 |
CALL WRITE_FLD_XY_RS( 'YC',' ',YC,0,myThid) |
81 |
CALL WRITE_FLD_XY_RS( 'XG',' ',XG,0,myThid) |
82 |
CALL WRITE_FLD_XY_RS( 'YG',' ',YG,0,myThid) |
83 |
CALL WRITE_FLD_XY_RS( 'AC',' ',rA,0,myThid) |
84 |
|
85 |
C-- Print out statistics of each horizontal grid array (helps when debugging) |
86 |
CALL MON_PRINTSTATS_RS(1,XC,'XC',myThid) |
87 |
CALL MON_PRINTSTATS_RS(1,XG,'XG',myThid) |
88 |
CALL MON_PRINTSTATS_RS(1,DXC,'DXC',myThid) |
89 |
CALL MON_PRINTSTATS_RS(1,DXF,'DXF',myThid) |
90 |
CALL MON_PRINTSTATS_RS(1,DXG,'DXG',myThid) |
91 |
CALL MON_PRINTSTATS_RS(1,DXV,'DXV',myThid) |
92 |
CALL MON_PRINTSTATS_RS(1,YC,'YC',myThid) |
93 |
CALL MON_PRINTSTATS_RS(1,YG,'YG',myThid) |
94 |
CALL MON_PRINTSTATS_RS(1,DYC,'DYC',myThid) |
95 |
CALL MON_PRINTSTATS_RS(1,DYF,'DYF',myThid) |
96 |
CALL MON_PRINTSTATS_RS(1,DYG,'DYG',myThid) |
97 |
CALL MON_PRINTSTATS_RS(1,DYU,'DYU',myThid) |
98 |
CALL MON_PRINTSTATS_RS(1,RA,'RA',myThid) |
99 |
CALL MON_PRINTSTATS_RS(1,RAW,'RAW',myThid) |
100 |
CALL MON_PRINTSTATS_RS(1,RAS,'RAS',myThid) |
101 |
CALL MON_PRINTSTATS_RS(1,RAZ,'RAZ',myThid) |
102 |
|
103 |
RETURN |
104 |
END |