model/src/ini_salt.F

C $Header: /u/gcmpack/MITgcm/model/src/ini_salt.F,v 1.14 2001/09/26 18:09:15 cnh Exp $
C $Name:  $

#include "CPP_OPTIONS.h"

CBOP
C     !ROUTINE: INI_SALT
C     !INTERFACE:
      SUBROUTINE INI_SALT ( myThid )
C     !DESCRIPTION: \bv
C     *==========================================================*
C     | SUBROUTINE INI_SALT                                       
C     | o Set model initial salinity field.                       
C     *==========================================================*
C     | There are several options for setting the initial         
C     | temperature file                                          
C     |  1. Inline code                                           
C     |  2. Vertical profile ( uniform S in X and Y )             
C     |  3. Three-dimensional data from a file. For example from  
C     |     Levitus or from a checkpoint file from a previous     
C     |     integration.                                          
C     | In addition to setting the salinity field we also         
C     | set the initial salinity tendency term here.              
C     *==========================================================*
C     \ev

C     !USES:
      IMPLICIT NONE
C     === Global variables ===
#include "SIZE.h"
#include "EEPARAMS.h"
#include "PARAMS.h"
#include "GRID.h"
#include "DYNVARS.h"

C     !INPUT/OUTPUT PARAMETERS:
C     == Routine arguments ==
C     myThid -  Number of this instance of INI_SALT 
      INTEGER myThid

C     !LOCAL VARIABLES:
C     == Local variables ==
C     bi,bj  - Loop counters
C     I,J,K
      INTEGER bi, bj
      INTEGER I, J, K, localWarnings
      CHARACTER*(MAX_LEN_MBUF) msgBuf
CEOP

C--   Initialise salinity field to the vertical reference profile
      DO bj = myByLo(myThid), myByHi(myThid)
       DO bi = myBxLo(myThid), myBxHi(myThid)
        DO K=1,Nr
         DO J=1-Oly,sNy+Oly
          DO I=1-Olx,sNx+Olx
           salt(I,J,K,bi,bj) = sRef(K)
          ENDDO
         ENDDO
        ENDDO
       ENDDO
      ENDDO

      IF ( hydrogSaltFile .NE. ' ' ) THEN
       _BEGIN_MASTER( myThid )
       CALL READ_FLD_XYZ_RL( hydrogSaltFile, ' ', salt, 0, myThid )
       _END_MASTER(myThid)
       _EXCH_XYZ_R8(salt  , myThid )
      ENDIF

C     Apply mask and test consistancy
      localWarnings=0
      DO bj = myByLo(myThid), myByHi(myThid)
       DO bi = myBxLo(myThid), myBxHi(myThid)
        DO K=1,Nr
         DO J=1-Oly,sNy+Oly
          DO I=1-Olx,sNx+Olx
           IF (maskC(I,J,K,bi,bj).EQ.0.) salt(I,J,K,bi,bj) = 0.
          ENDDO
         ENDDO
         IF ( sRef(k).NE.0. ) THEN
          DO J=1,sNy
           DO I=1,sNx
            IF ( maskC(I,J,K,bi,bj).NE.0.
     &      .AND. salt(I,J,K,bi,bj).EQ.0. ) THEN
              localWarnings=localWarnings+1
            ENDIF
           ENDDO
          ENDDO
         ENDIF
        ENDDO
       ENDDO
      ENDDO
      IF (localWarnings.NE.0) THEN
       WRITE(msgBuf,'(A,A)')
     &  'S/R INI_SALT: salt = 0 identically. If this is intentional',
     &  'you will need to edit ini_salt.F to avoid this safety check'
       CALL PRINT_ERROR( msgBuf , myThid)
       STOP 'ABNORMAL END: S/R INI_SALT'
      ENDIF

      CALL PLOT_FIELD_XYZRL( salt, 'Initial Salinity' , Nr, 1, myThid )

      RETURN
      END
1	C $Header: /u/gcmpack/MITgcm/model/src/ini_salt.F,v 1.14 2001/09/26 18:09:15 cnh Exp $
2	C $Name: $
3
4	#include "CPP_OPTIONS.h"
5
6	CBOP
7	C !ROUTINE: INI_SALT
8	C !INTERFACE:
9	SUBROUTINE INI_SALT ( myThid )
10	C !DESCRIPTION: \bv
11	C ==========================================================
12	C \| SUBROUTINE INI_SALT
13	C \| o Set model initial salinity field.
14	C ==========================================================
15	C \| There are several options for setting the initial
16	C \| temperature file
17	C \| 1. Inline code
18	C \| 2. Vertical profile ( uniform S in X and Y )
19	C \| 3. Three-dimensional data from a file. For example from
20	C \| Levitus or from a checkpoint file from a previous
21	C \| integration.
22	C \| In addition to setting the salinity field we also
23	C \| set the initial salinity tendency term here.
24	C ==========================================================
25	C \ev
26
27	C !USES:
28	IMPLICIT NONE
29	C === Global variables ===
30	#include "SIZE.h"
31	#include "EEPARAMS.h"
32	#include "PARAMS.h"
33	#include "GRID.h"
34	#include "DYNVARS.h"
35
36	C !INPUT/OUTPUT PARAMETERS:
37	C == Routine arguments ==
38	C myThid - Number of this instance of INI_SALT
39	INTEGER myThid
40
41	C !LOCAL VARIABLES:
42	C == Local variables ==
43	C bi,bj - Loop counters
44	C I,J,K
45	INTEGER bi, bj
46	INTEGER I, J, K, localWarnings
47	CHARACTER*(MAX_LEN_MBUF) msgBuf
48	CEOP
49
50	C-- Initialise salinity field to the vertical reference profile
51	DO bj = myByLo(myThid), myByHi(myThid)
52	DO bi = myBxLo(myThid), myBxHi(myThid)
53	DO K=1,Nr
54	DO J=1-Oly,sNy+Oly
55	DO I=1-Olx,sNx+Olx
56	salt(I,J,K,bi,bj) = sRef(K)
57	ENDDO
58	ENDDO
59	ENDDO
60	ENDDO
61	ENDDO
62
63	IF ( hydrogSaltFile .NE. ' ' ) THEN
64	_BEGIN_MASTER( myThid )
65	CALL READ_FLD_XYZ_RL( hydrogSaltFile, ' ', salt, 0, myThid )
66	_END_MASTER(myThid)
67	_EXCH_XYZ_R8(salt , myThid )
68	ENDIF
69
70	C Apply mask and test consistancy
71	localWarnings=0
72	DO bj = myByLo(myThid), myByHi(myThid)
73	DO bi = myBxLo(myThid), myBxHi(myThid)
74	DO K=1,Nr
75	DO J=1-Oly,sNy+Oly
76	DO I=1-Olx,sNx+Olx
77	IF (maskC(I,J,K,bi,bj).EQ.0.) salt(I,J,K,bi,bj) = 0.
78	ENDDO
79	ENDDO
80	IF ( sRef(k).NE.0. ) THEN
81	DO J=1,sNy
82	DO I=1,sNx
83	IF ( maskC(I,J,K,bi,bj).NE.0.
84	& .AND. salt(I,J,K,bi,bj).EQ.0. ) THEN
85	localWarnings=localWarnings+1
86	ENDIF
87	ENDDO
88	ENDDO
89	ENDIF
90	ENDDO
91	ENDDO
92	ENDDO
93	IF (localWarnings.NE.0) THEN
94	WRITE(msgBuf,'(A,A)')
95	& 'S/R INI_SALT: salt = 0 identically. If this is intentional',
96	& 'you will need to edit ini_salt.F to avoid this safety check'
97	CALL PRINT_ERROR( msgBuf , myThid)
98	STOP 'ABNORMAL END: S/R INI_SALT'
99	ENDIF
100
101	CALL PLOT_FIELD_XYZRL( salt, 'Initial Salinity' , Nr, 1, myThid )
102
103	RETURN
104	END