/[MITgcm]/manual/s_phys_pkgs/text/exf.tex
ViewVC logotype

Diff of /manual/s_phys_pkgs/text/exf.tex

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

revision 1.7 by heimbach, Mon Oct 3 18:12:27 2005 UTC revision 1.8 by heimbach, Tue Jun 27 20:00:18 2006 UTC
# Line 86  Table \ref{tab:pkg:exf:cpp} summarizes t Line 86  Table \ref{tab:pkg:exf:cpp} summarizes t
86        \hline        \hline
87           \multicolumn{2}{|c|}{\textit{used in conjunction with relaxation to prescribed (climatological) fields}} \\           \multicolumn{2}{|c|}{\textit{used in conjunction with relaxation to prescribed (climatological) fields}} \\
88           \hline           \hline
         \texttt{ALLOW\_CLIMTEMP\_RELAXATION} &  
           relaxation to 3-D temperature climatology \\  
         \texttt{ALLOW\_CLIMSALT\_RELAXATION} &  
           relaxation to 3-D salinity climatology \\  
89          \texttt{ALLOW\_CLIMSST\_RELAXATION} &          \texttt{ALLOW\_CLIMSST\_RELAXATION} &
90            relaxation to 2-D SST climatology \\            relaxation to 2-D SST climatology \\
91          \texttt{ALLOW\_CLIMSSS\_RELAXATION} &          \texttt{ALLOW\_CLIMSSS\_RELAXATION} &
# Line 292  c               |  Typical range: -0.5 < Line 288  c               |  Typical range: -0.5 <
288  c               |  Southwest C-grid V point  c               |  Southwest C-grid V point
289  c               |  Input field  c               |  Input field
290  c----------------------------------------------------------------------  c----------------------------------------------------------------------
291    c     hs        :: sensible heat flux into ocean in W/m^2
292    c               |  > 0 for increase in theta (ocean warming)
293    c----------------------------------------------------------------------
294    c     hl        :: latent   heat flux into ocean in W/m^2
295    c               |  > 0 for increase in theta (ocean warming)
296    c----------------------------------------------------------------------
297  c     hflux     :: Net upward surface heat flux in W/m^2  c     hflux     :: Net upward surface heat flux in W/m^2
298  c               |  excluding shortwave (on input)  c               |  excluding shortwave (on input)
299  c               |  hflux = latent + sensible + lwflux  c               |  hflux = latent + sensible + lwflux
# Line 328  c               |  Typical range: -10 < Line 330  c               |  Typical range: -10 <
330  c               |  Southwest C-grid V point  c               |  Southwest C-grid V point
331  c               |  Input or input/output field  c               |  Input or input/output field
332  c----------------------------------------------------------------------  c----------------------------------------------------------------------
333    c     wspeed    :: Surface (10-m) wind speed in m/s
334    c               |  >= 0 sqrt(u^2+v^2)
335    c               |  Typical range: 0 < wspeed < 10
336    c               |  Input or input/output field
337    c----------------------------------------------------------------------
338  c     atemp     :: Surface (2-m) air temperature in deg K  c     atemp     :: Surface (2-m) air temperature in deg K
339  c               |  Typical range: 200 < atemp < 300  c               |  Typical range: 200 < atemp < 300
340  c               |  Southwest C-grid tracer point  c               |  Southwest C-grid tracer point
# Line 357  c               |  Typical range: 0 < pr Line 364  c               |  Typical range: 0 < pr
364  c               |  Southwest C-grid tracer point  c               |  Southwest C-grid tracer point
365  c               |  Input or input/output field  c               |  Input or input/output field
366  c----------------------------------------------------------------------  c----------------------------------------------------------------------
367    c    snowprecip :: snow in m/s
368    c               |  > 0 for decrease in salt (ocean salinity)
369    c               |  Typical range: 0 < precip < 5e-7
370    c               |  Input or input/output field
371    c----------------------------------------------------------------------
372  c     runoff    :: River and glacier runoff in m/s  c     runoff    :: River and glacier runoff in m/s
373  c               |  > 0 for decrease in salt (ocean salinity)  c               |  > 0 for decrease in salt (ocean salinity)
374  c               |  Typical range: 0 < runoff < ????  c               |  Typical range: 0 < runoff < ????
# Line 402  c ... Line 414  c ...
414  c  exf_getforcing (TOP LEVEL ROUTINE)  c  exf_getforcing (TOP LEVEL ROUTINE)
415  c  |  c  |
416  c  |-- exf_getclim (get climatological fields used e.g. for relax.)  c  |-- exf_getclim (get climatological fields used e.g. for relax.)
 c  |   |--- exf_set_climtemp (relax. to 3-D temperature field)  
 c  |   |--- exf_set_climsalt (relax. to 3-D salinity field)  
417  c  |   |--- exf_set_climsst  (relax. to 2-D SST field)  c  |   |--- exf_set_climsst  (relax. to 2-D SST field)
418  c  |   |--- exf_set_climsss  (relax. to 2-D SSS field)  c  |   |--- exf_set_climsss  (relax. to 2-D SSS field)
419  c  |   o  c  |   o
# Line 414  c  |   |      depending on CPP options ( Line 424  c  |   |      depending on CPP options (
424  c  |   |      consecutive in time are read in and interpolated onto  c  |   |      consecutive in time are read in and interpolated onto
425  c  |   |      current time step).  c  |   |      current time step).
426  c  |   |   2. If forcing is atmos. state and control is atmos. state,  c  |   |   2. If forcing is atmos. state and control is atmos. state,
427  c  |   |      then the control variable anomalies are read here  c  |   |      then the control variable anomalies are read here via ctrl_get_gen
428  c  |   |          * ctrl_getatemp  c  |   |      (atemp, aqh, precip, swflux, swdown, uwind, vwind).
 c  |   |          * ctrl_getaqh  
 c  |   |          * ctrl_getuwind  
 c  |   |          * ctrl_getvwind  
429  c  |   |      If forcing and control are fluxes, then  c  |   |      If forcing and control are fluxes, then
430  c  |   |      controls are added later.  c  |   |      controls are added later.
431  c  |   o  c  |   o
432  c  |  c  |
433  c  |-- exf_check_range  c  |-- exf_radiation
434  c  |   |   1. Check whether read fields are within assumed range  c  |   |    Compute net or downwelling radiative fluxes via
435  c  |   |      (may capture mismatches in units)  c  |   |    Stefan-Boltzmann law in case only one is known.
436    c  |   o
437    c  |-- exf_wind
438    c  |   |   Computes wind speed and stresses, if required.
439  c  |   o  c  |   o
440  c  |  c  |
441  c  |-- exf_bulkformulae  c  |-- exf_bulkformulae
442  c  |   |   1. Compute net or downwelling radiative fluxes via  c  |   |   Compute air-sea buoyancy fluxes from
443  c  |   |      Stefan-Boltzmann law in case only one is known.  c  |   |   atmospheric state following Large and Pond, JPO, 1981/82
 c  |   |   2. Compute air-sea momentum and buoyancy fluxes from  
 c  |   |      atmospheric state following Large and Pond, JPO, 1981/82  
444  c  |   o  c  |   o
445  c  |  c  |
446  c  |-- < add time-mean river runoff here, if available >  c  |-- < hflux is sum of sensible, latent, longwave rad. >
447    c  |-- < sflux is sum of evap. minus precip. minus runoff  >
448    c  |
449    c  |-- exf_getsurfacefluxes
450    c  |   If forcing and control is flux, then the
451    c  |   control vector anomalies are read here via ctrl_get_gen
452    c  |   (hflux, sflux, ustress, vstress)
453  c  |  c  |
454  c  |-- < update tile edges here >  c  |-- < update tile edges here >
455  c  |  c  |
456  c  |-- exf_getsurfacefluxes  c  |-- exf_check_range
457  c  |   |   1. If forcing and control are fluxes, then  c  |   |   Check whether read fields are within assumed range
458  c  |   |      controls are added here.  c  |   |   (may capture mismatches in units)
459  c  |   o  c  |   o
460  c  |  c  |
461  c  |-- < treatment of hflux w.r.t. swflux >  c  |-- < add shortwave to hflux for diagnostics >
462  c  |  c  |
463  c  |-- exf_diagnostics_fill  c  |-- exf_diagnostics_fill
464  c  |   |   1. Do EXF-related diagnostics output here.  c  |   |   Do EXF-related diagnostics output here.
465  c  |   o  c  |   o
466  c  |  c  |
467  c  |-- exf_mapfields  c  |-- exf_mapfields
468  c  |   |   1. Map the EXF variables onto the core MITgcm  c  |   |   Forcing fields from exf package are mapped onto
469  c  |   |      forcing fields.  c  |   |   mitgcm forcing arrays.
470    c  |   |   Mapping enables a runtime rescaling of fields
471  c  |   o  c  |   o
472  c  |  C  o
 c  |-- exf_bulkformulae  
 c  |   If ALLOW_BULKFORMULAE, compute fluxes via bulkformulae  
 c  |  
 c  |-- exf_getsurfacefluxes  
 c  |   If forcing and control is flux, then the  
 c  |   control vector anomalies are read here  
 c  |      * ctrl_getheatflux  
 c  |      * ctrl_getsaltflux  
 c  |      * ctrl_getzonstress  
 c  |      * call ctrl_getmerstress  
 c  |  
 c  |-- exf_mapfields  
 c  |   Forcing fields from exf package are mapped onto  
 c  |   mitgcm forcing arrays.  
 c  |   Mapping enables a runtime rescaling of fields  
   
473  \end{verbatim}  \end{verbatim}
474  }  }
475    
476  Bulk formula routine: \texttt{exf\_bulkformulae.F}  Radiation calculation: \texttt{exf\_radiation.F}
477    
478    Wind speed and stress calculation: \texttt{exf\_wind.F}
479    
480    Bulk formula: \texttt{exf\_bulkformulae.F}
481    
482  Generic I/O routine: \texttt{exf\_set\_gen.F}  Generic I/O: \texttt{exf\_set\_gen.F}
483    
484  Interpolation routine: \texttt{exf\_interp.F}  Interpolation: \texttt{exf\_interp.F}
485    
486  Header routines  Header routines
487    
# Line 500  Table \ref{tab:pkg:exf:diagnostics}. Line 503  Table \ref{tab:pkg:exf:diagnostics}.
503  ------------------------------------------------------  ------------------------------------------------------
504   <-Name->|Levs|grid|<--  Units   -->|<- Tile (max=80c)   <-Name->|Levs|grid|<--  Units   -->|<- Tile (max=80c)
505  ------------------------------------------------------  ------------------------------------------------------
506     EXFhs   |  1 | SM | W/m^2          | Sensible heat flux into ocean, >0 increases theta
507     EXFhl   |  1 | SM | W/m^2          | Latent heat flux into ocean, >0 increases theta
508     EXFlwnet|  1 | SM | W/m^2          | Net upward longwave radiation, >0 decreases theta
509     EXFswnet|  1 | SM | W/m^2          | Net upward shortwave radiation, >0 decreases theta
510   EXFlwdn |  1 | SM | W/m^2          | Downward longwave radiation, >0 increases theta   EXFlwdn |  1 | SM | W/m^2          | Downward longwave radiation, >0 increases theta
511   EXFswdn |  1 | SM | W/m^2          | Downward shortwave radiation, >0 increases theta   EXFswdn |  1 | SM | W/m^2          | Downward shortwave radiation, >0 increases theta
512   EXFqnet |  1 | SM | W/m^2          | Net upward heat flux (turb+rad), >0 decreases theta   EXFqnet |  1 | SM | W/m^2          | Net upward heat flux (turb+rad), >0 decreases theta
# Line 507  Table \ref{tab:pkg:exf:diagnostics}. Line 514  Table \ref{tab:pkg:exf:diagnostics}.
514   EXFtauy |  1 | SV | N/m^2          | meridional surface wind stress, >0 increases vVel   EXFtauy |  1 | SV | N/m^2          | meridional surface wind stress, >0 increases vVel
515   EXFuwind|  1 | SM | m/s            | zonal 10-m wind speed, >0 increases uVel   EXFuwind|  1 | SM | m/s            | zonal 10-m wind speed, >0 increases uVel
516   EXFvwind|  1 | SM | m/s            | meridional 10-m wind speed, >0 increases uVel   EXFvwind|  1 | SM | m/s            | meridional 10-m wind speed, >0 increases uVel
517     EXFwspee|  1 | SM | m/s            | 10-m wind speed modulus ( >= 0 )
518   EXFatemp|  1 | SM | degK           | surface (2-m) air temperature   EXFatemp|  1 | SM | degK           | surface (2-m) air temperature
519   EXFaqh  |  1 | SM | kg/kg          | surface (2-m) specific humidity   EXFaqh  |  1 | SM | kg/kg          | surface (2-m) specific humidity
520   EXFevap |  1 | SM | m/s            | evaporation, > 0 increases salinity   EXFevap |  1 | SM | m/s            | evaporation, > 0 increases salinity
521   EXFpreci|  1 | SM | m/s            | evaporation, > 0 decreases salinity   EXFpreci|  1 | SM | m/s            | evaporation, > 0 decreases salinity
522     EXFsnow |  1 | SM | m/s            | snow precipitation, > 0 decreases salinity
523   EXFempmr|  1 | SM | m/s            | net upward freshwater flux, > 0 increases salinity   EXFempmr|  1 | SM | m/s            | net upward freshwater flux, > 0 increases salinity
524   EXFpress|  1 | SM | N/m^2          | atmospheric pressure field   EXFpress|  1 | SM | N/m^2          | atmospheric pressure field
525  \end{verbatim}  \end{verbatim}

Legend:
Removed from v.1.7  
changed lines
  Added in v.1.8

  ViewVC Help
Powered by ViewVC 1.1.22