%
%               FILE DESCRIBING THE Esbensen Kushnir Climatologies at PMEL
%                            Sea-Air Temperature Difference 

% The preceding empty line is important.
%
% $Id: eskusat.m,v 1.8 1998/11/09 20:26:56 dbyrne Exp $

% $Log: eskusat.m,v $
% Revision 1.8  1998/11/09 20:26:56  dbyrne
% *** empty log message ***
%
% Revision 1.11  1998/11/05 16:01:52  root
% Changed LonVector and LatVector to be used if no Lon returned and tried the update function.
% DataScale and DataNull should now be optional!
%
% Revision 1.6  1998/09/14 01:32:53  dbyrne
% Elminated an inconsistency whereby the depth variable was not scaled
% and had no DataNull etc.  Added check for empty variables to plotscript.m
%
% Revision 1.10  1998/09/13 19:33:23  root
% updated DataNull &c.
%
% Revision 1.9  1998/09/13 19:21:22  root
% Eliminated an inconsistency in DataScale, DataRange, and DataNull, that
% Depth was not included!
%
% Revision 1.8  1998/09/11 08:16:07  dbyrne
% Longitude ranges were messed up in every archive.m file except the
% two I wrote myself.  To eliminate future confusion, 'LLon' 'Llat',
% 'Rlon' and 'Ulat' etc are being eliminated in favor of two-component
% vectors LonRange LatRange TimeRange DepthRange.
%
% Revision 1.7  1998/09/10 21:14:06  dbyrne
% Fixed some small bugs.
%
% Revision 1.6  1998/09/09 20:12:16  dbyrne
% Changing variable names to stay within 14 characters.
%
% Revision 1.5  1998/09/09 19:42:04  dbyrne
% Now serves ALL Esbensen-Kushnir meteorological variables.
%
% Revision 1.4  1998/09/09 07:57:36  dbyrne
% replaced Data_Scale with DataScale, Data_Null with DataNull, and Data_Range
% with DataRange for consistency with other variables in the archive.m files.
%
% Revision 1.3  1998/09/09 07:40:20  dbyrne
% Replaced getrectangular with getrectg
%
% Revision 1.2  1998/09/09 07:34:21  dbyrne
% Eliminating ReturnedVariables
%
% Revision 1.1  1998/05/17 14:18:03  dbyrne
% *** empty log message ***
%
% Revision 1.2  1997/12/08 17:30:30  tom
% fixed 'nc' to correct 'nph-nc'
%
% Revision 1.1.1.1  1997/09/22 14:13:54  tom
% Imported Matlab GUI sources to CVS
%

% FUNCTIONS -- REQUIRED
GetFunctionName = 'getrectg';
% FUNCTIONS -- OPTIONAL
URL_m_File = 'pmelurl';
CatalogServer = 'monthly';

% VARIABLES -- OPTIONAL
Server = 'http://ferret.wrc.noaa.gov/cgi-bin/nph-nc/data/Esbensen_Kushnir.nc';
Nlon = 72;
Nlat = 46;

% VARIABLES -- REQUIRED
LonRange = [20.000 380.000];
LatRange = [-90.000 90.000];
TimeRange = [1800 2000];
DepthRange = [0.0 0.0];
Resolution = 495.0;

DataName = 'Esbensen Kushnir Air-Sea delta T';
TimeName = 'TIME';
LongitudeName = 'ESKUX';
LatitudeName = 'ESKUY';
DepthName = '';
SelectableVariables = str2mat('Temp_Diff','Up_Radiation', ...
'Latent_Heat','Spec_Hum_Diff','Downward_Heat','Sea_Temp', ...
'Sensible_Heat','Insolation','Spec_Humidity', str2mat('Cloud_Cover', ...
'Down_Radiation','Pressure','Wind_Speed'));
DodsName = str2mat('SAT','FUL','FLH','SAH','FDH','SST','FSH', ...
    'FSR','AH', str2mat('CLD','FDR','SLP','SPD'));

% note: DataNull is applied *before* scaling
DataNull = [NaN NaN NaN NaN ...
  9999999790214767953607394487959552.0 ...
  9999999790214767953607394487959552.0 ...
  9999999790214767953607394487959552.0 ...
  9999999790214767953607394487959552.0 ...
  9999999790214767953607394487959552.0 ...
  9999999790214767953607394487959552.0 ...
  9999999790214767953607394487959552.0 ...
  9999999790214767953607394487959552.0 ...
  9999999790214767953607394487959552.0 ...
  9999999790214767953607394487959552.0 ...
  9999999790214767953607394487959552.0 ...
  9999999790214767953607394487959552.0 ...
  9999999790214767953607394487959552.0];
DataScale = [NaN NaN; NaN NaN; NaN NaN; NaN NaN; 0 1; 0 1; 0 1; ...
  0 1; 0 1; 0 1; 0 1; 0 1; 0 1; 0 1; 0 1; 0 1; 0 1];
DataRange =   [NaN NaN; NaN NaN; NaN NaN; NaN NaN; -7.5  7.5; nan nan; ...
  nan nan; nan nan; nan nan; nan nan; nan nan; nan nan; nan nan; ...
  nan nan; nan nan; nan nan; nan nan]; 

% COMMENTS
Comments1 =sprintf('%s\n', ...
'                    Esbensen-Kushnir Heat Budget Climatology at PMEL', ...
'    ', ...
'    The Heat Budget of the Global Ocean, published by Steven Esbensen and Yochanan ', ...
'    Kushnir of the Climate Research Institute at Oregon State University, in 1981. ', ...
'    To calculate the heat budget components, bulk formulas parameterizing the heat ', ...
'    flux mechanisms were applied to monthly mean values of basic surface variables.', ...
'     ', ...
'    Data sources for the basic variables were a global climatology of surface ', ...
'    marine meteorological observations prepared by the by the NCDC and the ', ...
'    Berliand and Strokina cloudiness atlas. ', ...
'    ', ...
'    The atlas includes maps of the monthly mean distributions of the calculated ', ...
'    heat budget components and of the basic variables used in the calculation. ', ...
'    All the fields have a uniform spatial resolution and are presented on a ', ...
'    regular 4degx5deg. grid.  Heat budget components include: ', ...
'    ', ...
'        Net Upward Longwave Flux   Units: W/M2   VariableName: FUL ', ...
'        Latent Heat Flux   Units: W/M2   VariableName: FLH ', ...
'        Sea-Air Specific Humidity Difference   Units: GR/KG   VariableName: SAH ', ...
'        Net Downward Heat Flux   Units: W/M2   VariableName: FDH ', ...
'        Sea Surface Temperature   Units: Deg C   VariableName: SST ', ...
'        Sea-Air Temperature Difference   Units: Deg C   VariableName: SAT ', ...
'        Sensible Heat Flux   Units: W/M2   VariableName: FSH ', ...
'        Available Solar Radiation   Units: W/M2   VariableName: FSR ', ...
'        Specific Humidity   Units: GR/KG   VariableName: AH', ...
'        Cloudiness   Units: Fraction of Sky Cover   VariableName: CLD ', ...
'        Net Downward Radiative Flux   Units: W/M2   VariableName: FDR ', ...
'        Sea Level Pressure   Units: MB   VariableName: SLP ', ...
'        Surface Wind Speed   Units: M/S   VariableName: SPD ', ...
'    ', ...
'    Note:  The origin of the data grid (indicies (1,1)) has a lat/long value of ', ...
'    (-90,20), and a corresponding terminal point (indices (42,76)) corresponding ', ...
'    to (90,375).  Longitude values span 360 degrees, from 20-380 degrees.', ...
'    ', ...
'    References:', ...
'    ', ...
'    Esbensen, S. K. & Kushnir, Y. 1981:  The heat budget of the global ocean: An ', ...
'        atlas based on estimates from surface marine observations. Climatic ', ...
'        Research Institute, Oregon State University. Report No. 29.', ...
'        URL: http://ATS.ORST.EDU:80/Faculty/esbensen/tropical/CRI_Report_29.html');
Comments2 = sprintf('%s\n', ...
'   ', ...
'    Time_Period_of_Content = ', ...
'         Beginning_Date:1800 ', ...
'         Ending_Date:1998 ', ...
'    Spatial_Domain = ', ...
'         Bounding Coordinates: ', ...
'              West Bounding Coordinate:20.0 ', ...
'              East Bounding Coordinate:380.0 ', ...
'              South Bounding Coordinate:-90.00 ', ...
'              North Bounding Coordinate:+90.00 ', ...
'    Units:  Degrees Centigrade ', ...
'    Resolution: .01 deg. C ', ...
'    Accuracy: 1 deg. C ', ...
'   ', ...
'    Point_of_Contact (Science) = ', ...
'         Address: ', ...
'               Steve K. Esbensen ', ...
'               College of Oceanic and Atmospheric Sciences', ...
'               104 Ocean Admin Bldg', ...
'               Oregon State University ', ...
'               Corvallis, Oregon 97331-5503', ...
'               USA ', ...
'               Phone: (541) 737-5687 ', ...
'         Electronic Mail Address:INTERNET > esbensen@ats.orst.edu',...
'               Yochanon Kushnir ', ...
'               104-C Oceanography', ...
'               Lamont-Doherty Earth Observatory', ...
'               Columbia University', ...
'               Palisades, New York 10964', ...
'               USA ', ...
'               Phone: (914) 365-8669', ...
'         Electronic Mail Address:INTERNET > kushnir@ldeo.columbia.edu',...
'    Point_of_Contact (Data Provision) = ', ...
'         Address: ', ...
'               Kevin O''Brien ', ...
'               NOAA/PMEL', ...
'               7600 Sand Point Way NE', ...
'               Seattle, Washington 98115-0070', ...
'               USA ', ...
'               Telephone: (206) 526-6751', ...
'         Electronic Mail Address:INTERNET > ferret@pmel.noaa.gov');



Comments = [Comments1 Comments2];
