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

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

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


Revision 1.29 - (hide annotations) (download)
Wed Feb 4 05:45:09 2004 UTC (20 years, 4 months ago) by edhill
Branch: MAIN
Changes since 1.28: +6 -2 lines
 o working (though incomplete) version of the "wrapper":
   - 149 pre-defined grids:
     - all "meaningful" X,Y,Z,T combinations
     - X,Y with or without halos
     - Horiz: centered, U, V, and corner (vorticity) grids
     - Vert: centered or interface
   - just two function calls to write a variable using one of the
     pre-defined grids
 o tile numbering scheme for both cube and XY grids
 o read, write, and append NetCDF files
 o checks for (acceptable) re-definition of dims, grids, and vars
 o numerous small bug fixes
 o warning: the two mnc_model_* files are now broken/obsolete and
   will soon be removed

1 edhill 1.29 C $Header: /u/u3/gcmpack/MITgcm/model/src/write_state.F,v 1.28 2004/01/18 23:23:15 edhill Exp $
2 mlosch 1.19 C $Name: $
3 edhill 1.25
4     #include "PACKAGES_CONFIG.h"
5 adcroft 1.1 #include "CPP_OPTIONS.h"
6    
7 adcroft 1.5 #undef MULTIPLE_RECORD_STATE_FILES
8    
9 cnh 1.15 CBOP
10     C !ROUTINE: WRITE_STATE
11     C !INTERFACE:
12 adcroft 1.17 SUBROUTINE WRITE_STATE ( myTime, myIter, myThid )
13 cnh 1.15 C !DESCRIPTION: \bv
14     C *==========================================================*
15     C | SUBROUTINE WRITE_STATE
16     C | o Controlling routine for IO to dump model state.
17     C *==========================================================*
18     C | Write model state files for post-processing. This file
19     C | includes code for diagnosing W and RHO for output.
20     C | File write_state.F: Routines to handle mid-level I/O
21     C | interface.
22     C | o WRITE_STATE - Write out model state.
23     C | The following CPP flag (MULTIPLE_RECORD_STATE_FILES) is
24     C | #define/#undefed here since it is specific to this routine
25     C | and very user-preference specific.
26     C |
27     C | If #undefed (default) the state files are written as in all versions
28     C | prior to checkpoint32, where a file is created per variable, per time
29     C | and per tile. This *has* to be the default because most users use this
30     C | mode and all utilities and scripts (diagnostic) assume this form.
31     C | It is also robust, as explained below.
32     C |
33     C | If #defined, subsequent snap-shots are written as records in the
34     C | same file (no iteration number in filenames).
35     C | Advantages: - fewer files
36     C | - for small problems, is easy to copy the output around
37     C | Disadvantages:
38     C | - breaks a lot of diagnostic scripts
39     C | - for large or long problems this creates huge files
40     C | - is an unexpected, unsolicited change in behaviour which came
41     C | as a surprise (in c32) and inconvenience to several users
42     C | - can not accomodate changing the frequency of output
43     C | after a pickup (this is trivial in previous method
44     C | but needs new code and parameters in this new method)
45     C | Known Bugs:
46     C | - if the length of integration is not exactly an integer
47     C | times the output frequency then the last record written
48     C | (at end of integration) overwrites a previously written
49     C | record corresponding to an earier time. *BE WARNED*
50     C *==========================================================*
51     C \ev
52 adcroft 1.5
53 cnh 1.15 C !USES:
54 adcroft 1.1 IMPLICIT NONE
55     C == Global variables ===
56     #include "SIZE.h"
57     #include "EEPARAMS.h"
58     #include "PARAMS.h"
59     #include "DYNVARS.h"
60 jmc 1.16 #include "GRID.h"
61 mlosch 1.18 #include "EOS.h"
62 heimbach 1.14 #ifdef ALLOW_PASSIVE_TRACER
63 heimbach 1.13 #include "TR1.h"
64 heimbach 1.14 #endif
65 adcroft 1.1 LOGICAL DIFFERENT_MULTIPLE
66     EXTERNAL DIFFERENT_MULTIPLE
67     INTEGER IO_ERRCOUNT
68     EXTERNAL IO_ERRCOUNT
69    
70 cnh 1.15 C !INPUT/OUTPUT PARAMETERS:
71 adcroft 1.1 C == Routine arguments ==
72     C myThid - Thread number for this instance of the routine.
73     C myIter - Iteration number
74 adcroft 1.17 C myTime - Current time of simulation ( s )
75     _RL myTime
76 adcroft 1.1 INTEGER myThid
77     INTEGER myIter
78    
79 cnh 1.15 C !LOCAL VARIABLES:
80 adcroft 1.1 C == Local variables ==
81 adcroft 1.5 CHARACTER*(MAX_LEN_MBUF) suff
82 heimbach 1.4 INTEGER iRec
83 cnh 1.15 CEOP
84 adcroft 1.1
85     IF (
86 adcroft 1.17 & DIFFERENT_MULTIPLE(dumpFreq,myTime,
87     & myTime-deltaTClock) .OR.
88     & myTime.EQ.endTime .OR.
89     & myTime.EQ.startTime
90 heimbach 1.4 & ) THEN
91 dimitri 1.20 IF ( dumpFreq .EQ. 0.0 ) THEN
92     iRec = 1
93     ELSE
94     iRec = int ( (myTime-startTime) / dumpFreq +1.5 )
95     ENDIF
96 heimbach 1.4
97     C-- Going to really do some IO. Make everyone except master thread wait.
98     _BARRIER
99     _BEGIN_MASTER( myThid )
100 adcroft 1.1
101     C-- Write model fields
102 jmc 1.16
103 adcroft 1.5 #ifdef MULTIPLE_RECORD_STATE_FILES
104 jmc 1.16
105 adcroft 1.5 C Write each snap-shot as a new record in one file per variable
106     C - creates relatively few files but these files can become huge
107 heimbach 1.4 CALL WRITE_REC_XYZ_RL( 'U', uVel,iRec,myIter,myThid)
108     CALL WRITE_REC_XYZ_RL( 'V', vVel,iRec,myIter,myThid)
109     CALL WRITE_REC_XYZ_RL( 'T', theta,iRec,myIter,myThid)
110     CALL WRITE_REC_XYZ_RL( 'S', salt,iRec,myIter,myThid)
111 jmc 1.10 CALL WRITE_REC_XY_RL('Eta',etaN,iRec,myIter,myThid)
112 adcroft 1.7 CALL WRITE_REC_XYZ_RL( 'W',wVel,iRec,myIter,myThid)
113 heimbach 1.14 #ifdef ALLOW_PASSIVE_TRACER
114 edhill 1.25 ceh3 needs an IF ( usePASSIVE_TRACER ) THEN
115 heimbach 1.13 CALL WRITE_REC_XYZ_RL( 'TR1',tr1,iRec,myIter,myThid)
116 edhill 1.25 #endif /* ALLOW_PASSIVE_TRACER */
117 adcroft 1.1 #ifdef ALLOW_NONHYDROSTATIC
118     IF (nonHydroStatic) THEN
119 adcroft 1.12 CALL WRITE_REC_XYZ_RL( 'PNH',phi_nh,iRec,myIter,myThid)
120 adcroft 1.1 ENDIF
121 adcroft 1.5 #endif /* ALLOW_NONHYDROSTATIC */
122 jmc 1.16 #ifdef NONLIN_FRSURF
123 jmc 1.24 c CALL WRITE_REC_XYZ_RS('hFacC.',hFacC,iRec,myIter,myThid)
124     c CALL WRITE_REC_XYZ_RS('hFacW.',hFacW,iRec,myIter,myThid)
125     c CALL WRITE_REC_XYZ_RS('hFacS.',hFacS,iRec,myIter,myThid)
126 jmc 1.16 #endif /* NONLIN_FRSURF */
127    
128     #else /* MULTIPLE_RECORD_STATE_FILES */
129    
130 adcroft 1.5 C Write each snap-shot as a new file (original and default method)
131     C - creates many files but for large configurations is easier to
132     C transfer analyse a particular snap-shots
133     WRITE(suff,'(I10.10)') myIter
134     CALL WRITE_FLD_XYZ_RL( 'U.',suff,uVel,myIter,myThid)
135     CALL WRITE_FLD_XYZ_RL( 'V.',suff,vVel,myIter,myThid)
136     CALL WRITE_FLD_XYZ_RL( 'T.',suff,theta,myIter,myThid)
137     CALL WRITE_FLD_XYZ_RL( 'S.',suff,salt,myIter,myThid)
138 jmc 1.10 CALL WRITE_FLD_XY_RL('Eta.',suff,etaN,myIter,myThid)
139 adcroft 1.7 CALL WRITE_FLD_XYZ_RL( 'W.',suff,wVel,myIter,myThid)
140 jmc 1.22 IF ( useDynP_inEos_Zc .OR. myIter.NE.nIter0 )
141     & CALL WRITE_FLD_XYZ_RL( 'PH.',suff,totPhiHyd,myIter,myThid)
142 jmc 1.24 IF (buoyancyRelation.NE.'ATMOSPHERIC' .AND. myIter.NE.nIter0)
143 jmc 1.21 & CALL WRITE_FLD_XY_RL('PHL.',suff,phiHydLow,myIter,myThid)
144 heimbach 1.14 #ifdef ALLOW_PASSIVE_TRACER
145 edhill 1.25 ceh3 needs an IF ( usePASSIVE_TRACER ) THEN
146 heimbach 1.13 CALL WRITE_FLD_XYZ_RL( 'TR1.',suff,tr1,myIter,myThid)
147 heimbach 1.14 #endif
148 adcroft 1.5 #ifdef ALLOW_NONHYDROSTATIC
149     IF (nonHydroStatic) THEN
150 adcroft 1.12 CALL WRITE_FLD_XYZ_RL( 'PNH.',suff,phi_nh,myIter,myThid)
151 adcroft 1.5 ENDIF
152     #endif /* ALLOW_NONHYDROSTATIC */
153 jmc 1.16 #ifdef NONLIN_FRSURF
154 jmc 1.24 c CALL WRITE_FLD_XYZ_RS('hFacC.',suff,hFacC,myIter,myThid)
155     c CALL WRITE_FLD_XYZ_RS('hFacW.',suff,hFacW,myIter,myThid)
156     c CALL WRITE_FLD_XYZ_RS('hFacS.',suff,hFacS,myIter,myThid)
157 jmc 1.16 #endif /* NONLIN_FRSURF */
158    
159 adcroft 1.5 #endif /* MULTIPLE_RECORD_STATE_FILES */
160 adcroft 1.1
161 adcroft 1.17 #ifdef ALLOW_PTRACERS
162     IF (usePTRACERS) CALL PTRACERS_WRITE_STATE(myIter,myTime,myThid)
163     #endif /* ALLOW_PTRACERS */
164 heimbach 1.4 _END_MASTER( myThid )
165     _BARRIER
166 edhill 1.26
167     #ifdef ALLOW_MNC
168 edhill 1.29 C CALL MNC_W_STATE(myThid, myIter, 'test')
169    
170     CALL MNC_CW_RL_WRITES_D(myThid, 't_theta',0,0,
171     &'theta', 1, theta)
172    
173 edhill 1.26 #endif
174 adcroft 1.1
175     ENDIF
176    
177     RETURN
178     END

  ViewVC Help
Powered by ViewVC 1.1.22