/[MITgcm]/MITgcm/pkg/exf/exf_fields.h
ViewVC logotype

Diff of /MITgcm/pkg/exf/exf_fields.h

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

revision 1.1.4.7 by dimitri, Thu May 22 20:49:14 2003 UTC revision 1.18 by jmc, Mon Apr 16 23:46:54 2007 UTC
# Line 24  c     ustress   :: Zonal surface wind st Line 24  c     ustress   :: Zonal surface wind st
24  c                  > 0 for increase in uVel, which is west to  c                  > 0 for increase in uVel, which is west to
25  c                      east for cartesian and spherical polar grids  c                      east for cartesian and spherical polar grids
26  c                  Typical range: -0.5 < ustress < 0.5  c                  Typical range: -0.5 < ustress < 0.5
 c                  Southwest C-grid U point  
27  c                  Input field  c                  Input field
28  c  c
29  c     vstress   :: Meridional surface wind stress in N/m^2  c     vstress   :: Meridional surface wind stress in N/m^2
30  c                  > 0 for increase in vVel, which is south to  c                  > 0 for increase in vVel, which is south to
31  c                      north for cartesian and spherical polar grids  c                      north for cartesian and spherical polar grids
32  c                  Typical range: -0.5 < vstress < 0.5  c                  Typical range: -0.5 < vstress < 0.5
 c                  Southwest C-grid V point  
33  c                  Input field  c                  Input field
34  c  c
35  c     hflux     :: Net upward surface heat flux excluding shortwave in W/m^2  c     hflux     :: Net upward surface heat flux excluding shortwave in W/m^2
36  c                  hflux = latent + sensible + lwflux  c                  hflux = latent + sensible + lwflux
37  c                  > 0 for decrease in theta (ocean cooling)  c                  > 0 for decrease in theta (ocean cooling)
38  c                  Typical range: -250 < hflux < 600  c                  Typical range: -250 < hflux < 600
 c                  Southwest C-grid tracer point  
39  c                  Input field  c                  Input field
40  c  c
41  c     sflux     :: Net upward freshwater flux in m/s  c     sflux     :: Net upward freshwater flux in m/s
42  c                  sflux = evap - precip - runoff  c                  sflux = evap - precip - runoff
43  c                  > 0 for increase in salt (ocean salinity)  c                  > 0 for increase in salt (ocean salinity)
44  c                  Typical range: -1e-7 < sflux < 1e-7  c                  Typical range: -1e-7 < sflux < 1e-7
 c                  Southwest C-grid tracer point  
45  c                  Input field  c                  Input field
46  c  c
47  c     swflux    :: Net upward shortwave radiation in W/m^2  c     swflux    :: Net upward shortwave radiation in W/m^2
48  c                  swflux = - ( swdown - ice and snow absorption - reflected )  c                  swflux = - ( swdown - ice and snow absorption - reflected )
49  c                  > 0 for decrease in theta (ocean cooling)  c                  > 0 for decrease in theta (ocean cooling)
50  c                  Typical range: -350 < swflux < 0  c                  Typical range: -350 < swflux < 0
 c                  Southwest C-grid tracer point  
51  c                  Input field  c                  Input field
52  c  c
53  c     uwind     :: Surface (10-m) zonal wind velocity in m/s  c     uwind     :: Surface (10-m) zonal wind velocity in m/s
54  c                  > 0 for increase in uVel, which is west to  c                  > 0 for increase in uVel, which is west to
55  c                      east for cartesian and spherical polar grids  c                      east for cartesian and spherical polar grids
56  c                  Typical range: -10 < uwind < 10  c                  Typical range: -10 < uwind < 10
 c                  Southwest C-grid U point  
57  c                  Input or input/output field  c                  Input or input/output field
58  c  c
59  c     vwind     :: Surface (10-m) meridional wind velocity in m/s  c     vwind     :: Surface (10-m) meridional wind velocity in m/s
60  c                  > 0 for increase in vVel, which is south to  c                  > 0 for increase in vVel, which is south to
61  c                      north for cartesian and spherical polar grids  c                      north for cartesian and spherical polar grids
62  c                  Typical range: -10 < vwind < 10  c                  Typical range: -10 < vwind < 10
63  c                  Southwest C-grid V point  c                  Input or input/output field
64    c
65    c     wspeed    :: Surface (10-m) wind speed in m/s
66    c                  >= 0 sqrt(u^2+v^2)
67    c                  Typical range: 0 < wspeed < 10
68  c                  Input or input/output field  c                  Input or input/output field
69  c  c
70  c     atemp     :: Surface (2-m) air temperature in deg K  c     atemp     :: Surface (2-m) air temperature in deg K
71  c                  Typical range: 200 < atemp < 300  c                  Typical range: 200 < atemp < 300
 c                  Southwest C-grid tracer point  
72  c                  Input or input/output field  c                  Input or input/output field
73  c  c
74  c     aqh       :: Surface (2m) specific humidity in kg/kg  c     aqh       :: Surface (2m) specific humidity in kg/kg
75  c                  Typical range: 0 < aqh < 0.02  c                  Typical range: 0 < aqh < 0.02
 c                  Southwest C-grid tracer point  
76  c                  Input or input/output field  c                  Input or input/output field
77  c  c
78  c     lwflux    :: Net upward longwave radiation in W/m^2  c     lwflux    :: Net upward longwave radiation in W/m^2
79  c                  lwflux = - ( lwdown - ice and snow absorption - emitted )  c                  lwflux = - ( lwdown - ice and snow absorption - emitted )
80  c                  > 0 for decrease in theta (ocean cooling)  c                  > 0 for decrease in theta (ocean cooling)
81  c                  Typical range: -20 < lwflux < 170  c                  Typical range: -20 < lwflux < 170
 c                  Southwest C-grid tracer point  
82  c                  Input field  c                  Input field
83  c  c
84  c     evap      :: Evaporation in m/s  c     evap      :: Evaporation in m/s
85  c                  > 0 for increase in salt (ocean salinity)  c                  > 0 for increase in salt (ocean salinity)
86  c                  Typical range: 0 < evap < 2.5e-7  c                  Typical range: 0 < evap < 2.5e-7
 c                  Southwest C-grid tracer point  
87  c                  Input, input/output, or output field  c                  Input, input/output, or output field
88  c  c
89  c     precip    :: Precipitation in m/s  c     precip    :: Precipitation in m/s
90  c                  > 0 for decrease in salt (ocean salinity)  c                  > 0 for decrease in salt (ocean salinity)
91  c                  Typical range: 0 < precip < 5e-7  c                  Typical range: 0 < precip < 5e-7
92  c                  Southwest C-grid tracer point  c                  Input or input/output field
93    c
94    c     snowprecip :: snow in m/s
95    c                  > 0 for decrease in salt (ocean salinity)
96    c                  Typical range: 0 < precip < 5e-7
97  c                  Input or input/output field  c                  Input or input/output field
98  c  c
99  c     runoff    :: River and glacier runoff in m/s  c     runoff    :: River and glacier runoff in m/s
100  c                  > 0 for decrease in salt (ocean salinity)  c                  > 0 for decrease in salt (ocean salinity)
101  c                  Typical range: 0 < runoff < ????  c                  Typical range: 0 < runoff < ????
 c                  Southwest C-grid tracer point  
102  c                  Input or input/output field  c                  Input or input/output field
 c                  !!! WATCH OUT: Default exf_inscal_runoff !!!  
 c                  !!! in exf_readparms.F is not 1.0        !!!  
103  c  c
104  c     swdown    :: Downward shortwave radiation in W/m^2  c     swdown    :: Downward shortwave radiation in W/m^2
105  c                  > 0 for increase in theta (ocean warming)  c                  > 0 for increase in theta (ocean warming)
106  c                  Typical range: 0 < swdown < 450  c                  Typical range: 0 < swdown < 450
 c                  Southwest C-grid tracer point  
107  c                  Input/output field  c                  Input/output field
108  c  c
109  c     lwdown    :: Downward longwave radiation in W/m^2  c     lwdown    :: Downward longwave radiation in W/m^2
110  c                  > 0 for increase in theta (ocean warming)  c                  > 0 for increase in theta (ocean warming)
111  c                  Typical range: 50 < lwdown < 450  c                  Typical range: 50 < lwdown < 450
 c                  Southwest C-grid tracer point  
112  c                  Input/output field  c                  Input/output field
113  c  c
114  c     apressure :: Atmospheric pressure field in N/m^2  c     apressure :: Atmospheric pressure field in N/m^2
115  c                  > 0 for ????  c                  > 0 for ????
116  c                  Typical range: ???? < apressure < ????  c                  Typical range: ???? < apressure < ????
 c                  Southwest C-grid tracer point  
117  c                  Input field  c                  Input field
118  c  c
119    c     hs        :: sensible heat flux into ocean in W/m^2
120    c                  > 0 for increase in theta (ocean warming)
121    c
122    c     hl        :: latent   heat flux into ocean in W/m^2
123    c                  > 0 for increase in theta (ocean warming)
124    c
125  c  c
126  c     NOTES:  c     NOTES:
127  c     ======  c     ======
128  c  c
129    c     All surface forcing fields are defined at the center of
130    c     each grid (the rVel location in model/inc/GRID.h) with
131    c     one exception.  When both ALLOW_BULKFORMULAE and
132    c     USE_EXF_INTERPOLATION are undefined, ustress and vstress are
133    c     defined at the Southwest C-grid U and V points, respectively.
134    c
135  c     Input and output units and sign conventions can be customized  c     Input and output units and sign conventions can be customized
136  c     using variables exf_inscal_* and exf_outscal_*, which are set  c     using variables exf_inscal_* and exf_outscal_*, which are set
137  c     by exf_readparms.F  c     by exf_readparms.F
# Line 138  c Line 142  c
142  c     #ifndef SHORTWAVE_HEATING, hflux includes shortwave,  c     #ifndef SHORTWAVE_HEATING, hflux includes shortwave,
143  c     that is, hflux = latent + sensible + lwflux +swflux  c     that is, hflux = latent + sensible + lwflux +swflux
144  c  c
 c     If (EXFwindOnBgrid .EQ. .TRUE.), uwind and vwind are  
 c     defined on southwest B-grid U and V points, respectively.  
 c  
145  c     Arrays *0 and *1 below are used for temporal interpolation.  c     Arrays *0 and *1 below are used for temporal interpolation.
146  c  c
147    
148        common /exf_stress_r/ ustress, vstress        common /exf_stress_r/ ustress, vstress
149        _RL ustress   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL ustress   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
150        _RL vstress   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL vstress   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
151          common /exfl_ustress_r/ ustress0, ustress1
152          _RL ustress0  (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
153          _RL ustress1  (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
154          common /exfl_vstress_r/ vstress0, vstress1
155          _RL vstress0  (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
156          _RL vstress1  (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
157    
158          common /exf_wspeed_r/ wspeed
159          _RL wspeed   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
160          common /exfl_wspeed_r/ wspeed0, wspeed1
161          _RL wspeed0  (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
162          _RL wspeed1  (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
163    
 #ifdef ALLOW_ATM_WIND  
164        common /exf_atm_wind_r/ uwind, vwind        common /exf_atm_wind_r/ uwind, vwind
165        _RL uwind     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL uwind     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
166        _RL vwind     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL vwind     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
# Line 158  c Line 170  c
170        common /exfl_vwind_r/ vwind0, vwind1        common /exfl_vwind_r/ vwind0, vwind1
171        _RL vwind0    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL vwind0    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
172        _RL vwind1    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL vwind1    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
 #else  
       common /exfl_ustress_r/ ustress0, ustress1  
       _RL ustress0  (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)  
       _RL ustress1  (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)  
       common /exfl_vstress_r/ vstress0, vstress1  
       _RL vstress0  (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)  
       _RL vstress1  (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)  
 #endif  
173    
174        common /exf_hsflux_r/ hflux, sflux        common /exf_hsflux_r/ hflux, sflux
175        _RL hflux     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL hflux     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
176        _RL sflux     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL sflux     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
177          common /exfl_hflux_r/ hflux0, hflux1
178  #if defined(ALLOW_ATM_TEMP) || defined(EXF_READ_EVAP)        _RL hflux0    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
179        common /exf_evap/ evap        _RL hflux1    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
180        _RL evap      (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        common /exfl_sflux_r/ sflux0, sflux1
181  #endif        _RL sflux0    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
182          _RL sflux1    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
183    
184  #ifdef ALLOW_ATM_TEMP  #ifdef ALLOW_ATM_TEMP
185        common /exf_atm_temp_r/ atemp, aqh, lwflux, precip        common /exf_atm_temp_r/ atemp, aqh, lwflux, precip, snowprecip
186        _RL atemp     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL atemp     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
187        _RL aqh       (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL aqh       (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
188        _RL lwflux    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL lwflux    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
189        _RL precip    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL precip    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
190          _RL snowprecip (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
191        common /exfl_atemp_r/ atemp0, atemp1        common /exfl_atemp_r/ atemp0, atemp1
192        _RL atemp0    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL atemp0    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
193        _RL atemp1    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL atemp1    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
# Line 194  c Line 200  c
200        common /exfl_precip_r/ precip0, precip1        common /exfl_precip_r/ precip0, precip1
201        _RL precip0   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL precip0   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
202        _RL precip1   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL precip1   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
203  #else        common /exfl_snowprecip_r/ snowprecip0, snowprecip1
204        common /exfl_hflux_r/ hflux0, hflux1        _RL snowprecip0(1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
205        _RL hflux0    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL snowprecip1(1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
206        _RL hflux1    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        common /exfl_turb_r/ hs, hl
207        common /exfl_sflux_r/ sflux0, sflux1        _RL hs        (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
208        _RL sflux0    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL hl        (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
       _RL sflux1    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)  
209  #endif  #endif
210    
211          common /exfl_wind_r/ us, cw, sw, sh
212          _RL us        (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
213          _RL cw        (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
214          _RL sw        (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
215          _RL sh        (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
216    
217  #if defined(ALLOW_ATM_TEMP) || defined(SHORTWAVE_HEATING)  #if defined(ALLOW_ATM_TEMP) || defined(SHORTWAVE_HEATING)
218        common /exf_swflux_r/ swflux        common /exf_swflux_r/ swflux
219        _RL swflux    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL swflux    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
# Line 211  c Line 222  c
222        _RL swflux1   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL swflux1   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
223  #endif  #endif
224    
225  #ifdef EXF_READ_EVAP  #if defined(ALLOW_ATM_TEMP) || defined(EXF_READ_EVAP)
226          common /exf_evap/ evap
227          _RL evap      (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
228        common /exfl_evap_r/ evap0, evap1        common /exfl_evap_r/ evap0, evap1
229        _RL evap0     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL evap0     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
230        _RL evap1     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL evap1     (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
231  #endif  #endif
232    
 #if defined (ALLOW_RUNOFF) || defined (ALLOW_SEAICE)  
       common /exfl_runoff_r/ runoff  
       _RL runoff    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)  
 #endif  
   
233  #ifdef ALLOW_DOWNWARD_RADIATION  #ifdef ALLOW_DOWNWARD_RADIATION
234        common /exf_rad_down_r/        common /exf_rad_down_r/
235       &     swdown, lwdown, swdown0, swdown1, lwdown0, lwdown1       &     swdown, lwdown, swdown0, swdown1, lwdown0, lwdown1
# Line 239  c Line 247  c
247        _RL apressure0(1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL apressure0(1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
248        _RL apressure1(1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)        _RL apressure1(1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
249  #endif  #endif
250    
251    #if defined (ALLOW_RUNOFF) || defined (ALLOW_SEAICE)
252          common /exfl_runoff_r/ runoff, runoff0, runoff1
253          _RL runoff    (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
254          _RL runoff0   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
255          _RL runoff1   (1-olx:snx+olx,1-oly:sny+oly,nsx,nsy)
256    #endif
Legend:
Removed from v.1.1.4.7  
changed lines
  Added in v.1.18
  ViewVC Help
Powered by ViewVC 1.1.22