C $Header: /u/gcmpack/MITgcm/model/src/write_state.F,v 1.61 2010/01/23 00:04:03 jmc Exp $
C $Name: $
#include "PACKAGES_CONFIG.h"
#include "CPP_OPTIONS.h"
#undef MULTIPLE_RECORD_STATE_FILES
C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----|
CBOP
C !ROUTINE: WRITE_STATE
C !INTERFACE:
SUBROUTINE WRITE_STATE ( myTime, myIter, myThid )
C !DESCRIPTION:
C This is the controlling routine for writing mid-level IO. It
C includes code for diagnosing W and RHO for output.
C The CPP flag (MULTIPLE_RECORD_STATE_FILES) is #define/#undefed
C here since it is specific to this routine and very user-preference
C specific. If #undefed (default) the state files are written as in
C all versions prior to checkpoint32, where a file is created per
C variable, per time and per tile. This *has* to be the default
C because most users use this mode and all utilities and scripts
C (diagnostic) assume this form. It is also robust, as explained
C below.
C
C If #defined, subsequent snap-shots are written as records in the
C same file (no iteration number in filenames). The main advantage
C is fewer files. The disadvantages are that:
C (1) it breaks a lot of diagnostic scripts,
C (2) for large or long problems this creates huge files,
C (3) its an unexpected, unsolicited change in behaviour which
C came as a surprise (in c32) and is an inconvenience to
C several users
C (4) it can not accomodate changing the frequency of output
C after a pickup (this is trivial in previous method but
C needs new code and parameters in this new method)
C
C Known Bugs include:
C (1) if the length of integration is not exactly an integer
C times the output frequency then the last record written
C (at end of integration) overwrites a previously written
C record corresponding to an earier time. *BE WARNED*
C !USES:
IMPLICIT NONE
#include "SIZE.h"
#include "EEPARAMS.h"
#include "PARAMS.h"
#include "GRID.h"
#include "DYNVARS.h"
#ifdef ALLOW_NONHYDROSTATIC
#include "NH_VARS.h"
#endif
#ifdef ALLOW_MNC
#include "MNC_PARAMS.h"
#endif
LOGICAL DIFFERENT_MULTIPLE
EXTERNAL
INTEGER IO_ERRCOUNT
EXTERNAL
C !INPUT/OUTPUT PARAMETERS:
C myThid - Thread number for this instance of the routine.
C myIter - Iteration number
C myTime - Current time of simulation ( s )
_RL myTime
INTEGER myThid
INTEGER myIter
C !LOCAL VARIABLES:
CHARACTER*(MAX_LEN_MBUF) suff
INTEGER iRec
#ifdef ALLOW_MNC
CHARACTER*(1) pf
#endif
CEOP
IF (
& DIFFERENT_MULTIPLE(dumpFreq,myTime,deltaTClock)
& .OR. dumpInitAndLast.AND.( myTime.EQ.endTime .OR.
& myTime.EQ.startTime )
& ) THEN
IF ( dumpFreq .EQ. 0.0 ) THEN
iRec = 1
ELSE
iRec = int ( (myTime-startTime) / dumpFreq +1.5 )
ENDIF
C Going to really do some IO. Make everyone except master thread wait.
C this is done within IO routines => no longer needed
c _BARRIER
C Write model fields
IF (snapshot_mdsio) THEN
#ifdef MULTIPLE_RECORD_STATE_FILES
C Write each snap-shot as a new record in one file per variable
C - creates relatively few files but these files can become huge
CALL WRITE_REC_XYZ_RL( 'U', uVel,iRec,myIter,myThid)
CALL WRITE_REC_XYZ_RL( 'V', vVel,iRec,myIter,myThid)
CALL WRITE_REC_XYZ_RL( 'T', theta,iRec,myIter,myThid)
CALL WRITE_REC_XYZ_RL( 'S', salt,iRec,myIter,myThid)
CALL WRITE_REC_XY_RL('Eta',etaN,iRec,myIter,myThid)
CALL WRITE_REC_XYZ_RL( 'W',wVel,iRec,myIter,myThid)
#ifdef ALLOW_NONHYDROSTATIC
IF (nonHydroStatic) THEN
CALL WRITE_REC_XYZ_RL( 'PNH',phi_nh,iRec,myIter,myThid)
ENDIF
#endif /* ALLOW_NONHYDROSTATIC */
#ifdef NONLIN_FRSURF
c CALL WRITE_REC_XYZ_RS('hFacC.',hFacC,iRec,myIter,myThid)
c CALL WRITE_REC_XYZ_RS('hFacW.',hFacW,iRec,myIter,myThid)
c CALL WRITE_REC_XYZ_RS('hFacS.',hFacS,iRec,myIter,myThid)
#endif /* NONLIN_FRSURF */
#else /* MULTIPLE_RECORD_STATE_FILES */
C Write each snap-shot as a new file (original and default
C method) -- creates many files but for large configurations is
C easier to transfer analyse a particular snap-shots
WRITE(suff,'(I10.10)') myIter
CALL WRITE_FLD_XYZ_RL( 'U.',suff,uVel,myIter,myThid)
CALL WRITE_FLD_XYZ_RL( 'V.',suff,vVel,myIter,myThid)
CALL WRITE_FLD_XYZ_RL( 'T.',suff,theta,myIter,myThid)
CALL WRITE_FLD_XYZ_RL( 'S.',suff,salt,myIter,myThid)
CALL WRITE_FLD_XY_RL('Eta.',suff,etaN,myIter,myThid)
CALL WRITE_FLD_XYZ_RL( 'W.',suff,wVel,myIter,myThid)
IF ( useDynP_inEos_Zc .OR. myIter.NE.nIter0 ) THEN
CALL WRITE_FLD_XYZ_RL('PH.',suff,totPhiHyd,myIter,myThid)
ENDIF
IF ( fluidIsWater .AND. (myIter.NE.nIter0) ) THEN
CALL WRITE_FLD_XY_RL('PHL.',suff,phiHydLow,myIter,myThid)
ENDIF
#ifdef ALLOW_NONHYDROSTATIC
IF (nonHydroStatic) THEN
CALL WRITE_FLD_XYZ_RL( 'PNH.',suff,phi_nh,myIter,myThid )
ENDIF
IF ( selectNHfreeSurf.GE.1 ) THEN
CALL WRITE_FLD_XY_RL( 'dPnh.',suff,dPhiNH,myIter,myThid )
ENDIF
#endif /* ALLOW_NONHYDROSTATIC */
#ifdef NONLIN_FRSURF
c CALL WRITE_FLD_XYZ_RS('hFacC.',suff,hFacC,myIter,myThid)
c CALL WRITE_FLD_XYZ_RS('hFacW.',suff,hFacW,myIter,myThid)
c CALL WRITE_FLD_XYZ_RS('hFacS.',suff,hFacS,myIter,myThid)
#endif /* NONLIN_FRSURF */
#endif /* MULTIPLE_RECORD_STATE_FILES */
ENDIF
#ifdef ALLOW_MNC
IF (useMNC .AND. snapshot_mnc) THEN
IF ( writeBinaryPrec .EQ. precFloat64 ) THEN
pf(1:1) = 'D'
ELSE
pf(1:1) = 'R'
ENDIF
C Write dynvars using the MNC package
CALL MNC_CW_SET_UDIM('state', -1, myThid)
CALL MNC_CW_RL_W_S('D','state',0,0,'T', myTime, myThid)
CALL MNC_CW_SET_UDIM('state', 0, myThid)
CALL MNC_CW_I_W_S('I','state',0,0,'iter', myIter, myThid)
C CALL MNC_CW_RL_W_S('D','state',0,0,'model_time',myTime,myThid)
CALL MNC_CW_RL_W(pf,'state',0,0,'U', uVel, myThid)
CALL MNC_CW_RL_W(pf,'state',0,0,'V', vVel, myThid)
CALL MNC_CW_RL_W(pf,'state',0,0,'Temp', theta, myThid)
CALL MNC_CW_RL_W(pf,'state',0,0,'S', salt, myThid)
CALL MNC_CW_RL_W(pf,'state',0,0,'Eta', etaN, myThid)
CALL MNC_CW_RL_W(pf,'state',0,0,'W', wVel, myThid)
IF ( useDynP_inEos_Zc .OR. myIter.NE.nIter0 ) THEN
CALL MNC_CW_SET_UDIM('phiHyd', -1, myThid)
CALL MNC_CW_RL_W_S('D','phiHyd',0,0,'T',myTime,myThid)
CALL MNC_CW_SET_UDIM('phiHyd', 0, myThid)
CALL MNC_CW_I_W_S('I','phiHyd',0,0,'iter',myIter,myThid)
CALL MNC_CW_RL_W(pf,'phiHyd',0,0,'phiHyd',
& totPhiHyd, myThid)
ENDIF
IF ( fluidIsWater .AND. (myIter .NE. nIter0) ) THEN
CALL MNC_CW_SET_UDIM('phiHydLow', -1, myThid)
CALL MNC_CW_RL_W_S('D','phiHydLow',0,0,'T', myTime, myThid)
CALL MNC_CW_SET_UDIM('phiHydLow', 0, myThid)
CALL MNC_CW_I_W_S('I','phiHydLow',0,0,'iter',myIter,myThid)
CALL MNC_CW_RL_W(pf,'phiHydLow',0,0,'phiHydLow',
& phiHydLow, myThid)
ENDIF
#ifdef ALLOW_NONHYDROSTATIC
IF (nonHydroStatic) THEN
CALL MNC_CW_RL_W(pf,'state',0,0,'phi_nh',phi_nh,myThid)
ENDIF
#endif /* ALLOW_NONHYDROSTATIC */
ENDIF
#endif /* ALLOW_MNC */
ENDIF
RETURN
END