From a4a13db6dbd67852967ef37eead3b4c3443b9267 Mon Sep 17 00:00:00 2001
From: Fabian Pedregosa <fabian.pedregosa@inria.fr>
Date: Wed, 6 Jan 2010 09:27:50 +0000
Subject: [PATCH] Added the narr module to load NCEP NARR data sets (reanalysis
 of around 190 variables). Depends on pydap.

From: dhuard <dhuard@cb17146a-f446-4be1-a4f7-bd7c5bb65646>

git-svn-id: https://scikit-learn.svn.sourceforge.net/svnroot/scikit-learn/trunk@248 22fbfee3-77ab-4535-9bad-27d1bd3bc7d8
---
 scikits/learn/datasets/narr/__init__.py       |   8 +
 scikits/learn/datasets/narr/data.py           | 182 ++++++++++++++++++
 .../narr/doc/narr_data_documentation.pdf      | Bin 0 -> 60799 bytes
 scikits/learn/datasets/narr/doc/overview.pdf  | Bin 0 -> 10031 bytes
 scikits/learn/datasets/setup.py               |   2 +
 5 files changed, 192 insertions(+)
 create mode 100644 scikits/learn/datasets/narr/__init__.py
 create mode 100644 scikits/learn/datasets/narr/data.py
 create mode 100644 scikits/learn/datasets/narr/doc/narr_data_documentation.pdf
 create mode 100644 scikits/learn/datasets/narr/doc/overview.pdf

diff --git a/scikits/learn/datasets/narr/__init__.py b/scikits/learn/datasets/narr/__init__.py
new file mode 100644
index 0000000000..a60cd86263
--- /dev/null
+++ b/scikits/learn/datasets/narr/__init__.py
@@ -0,0 +1,8 @@
+#! /usr/bin/env python
+# Last Change: Fri Jun 08 12:00 PM 2007 J
+import data as _narr
+__doc__     = _narr.DESCRLONG
+copyright   = _narr.COPYRIGHT
+source      = _narr.SOURCE
+
+load        = _narr.load
diff --git a/scikits/learn/datasets/narr/data.py b/scikits/learn/datasets/narr/data.py
new file mode 100644
index 0000000000..d2a5e216ad
--- /dev/null
+++ b/scikits/learn/datasets/narr/data.py
@@ -0,0 +1,182 @@
+"""
+=============
+NCEP NARR data sets
+=============
+
+This module provides access to the National Center for Environment Prediction 
+(NCEP) North American Regional Reanalysis (NARR) data sets through the 
+Data Access Protocol (DAP). The documentation describing the data set
+variables is included in the doc directory. 
+
+See the `pydap home page`_ for information on the DAP client. 
+
+.. _pydap home page: http://pydap.org/
+"""
+
+__docformat__ = 'restructuredtext'
+
+TITLE       = "NCEP North American Regional Reanalysis (NARR)"
+
+COPYRIGHT   = """The information on government servers are in the public domain,
+unless specifically annotated otherwise, and may be used freely by the public so
+long as you do not 1) claim it is your own (e.g. by claiming copyright for NWS 
+information -- see below), 2) use it in a manner that implies an endorsement 
+or affiliation with NOAA/NWS, or 3) modify it in content and then present it as 
+official government material. You also cannot present information of your own 
+in a way that makes it appear to be official government information..
+
+The user assumes the entire risk related to its use of this data. NWS is 
+providing this data "as is," and NWS disclaims any and all warranties, whether
+express or implied, including (without limitation) any implied warranties of 
+merchantability or fitness for a particular purpose. In no event will NWS be 
+liable to you or to any third party for any direct, indirect, incidental, 
+consequential, special or exemplary damages or lost profit resulting from any 
+use or misuse of this data.
+
+As required by 17 U.S.C. 403, third parties producing copyrighted works 
+consisting predominantly of the material appearing in NWS Web pages must 
+provide notice with such work(s) identifying the NWS material incorporated 
+and stating that such material is not subject to copyright protection."""
+
+DISCLAIMER = """While every effort has been made to ensure that data are
+accurate and reliable within the limits of the current state of
+the art, NOAA cannot assume liability for any damages caused by
+any errors or omissions in the data, nor as a result of the
+failure of the data to function on a particular system.
+NOAA makes no warranty, expressed or implied, nor does the fact
+of distribution constitute such a warranty.
+The data used to produce these analyses and forecasts has
+undergone automated quality checks.
+"""
+ 
+SOURCE      = """National Centers for Environmental Prediction (NCEP) _`North American Regional Reanalysis (NARR)` _`NOMADS web interface`.
+
+.. __North American Regional Reanalysis (NARR): http://wwwt.emc.ncep.noaa.gov/mmb/rreanl/index.html
+.. _NOMADS web interface: http://nomads.ncdc.noaa.gov/data.php#narr_datasets
+
+References: 
+    Mesinger, F., et al, 2004: NCEP North American Regional
+Reanalysis, 15th Symp. On Global Change and Climate Variations,
+Seattle, WA, 11-15 Jan 2004.
+
+    Shafran, P., J. Woollen, W. Ebisuzaki, W. Shi, Y. Fan, R. W.
+Grumbine, M. Fennessy, 2004: Observational Data Used for Assimilation in 
+the NCEP North American Regional Reanalysis, 20th Intl. Conf. On Interactive
+Information Processing Systems for Meteor. Ocean. And Hydrology. Seattle, WA, 11-15
+Jan 2004.
+
+    Ebisuzaki, W., J. Alpert, J. Wang, D. Jovic, P. Shafran, 2004: North American
+Regional Reanalysis: end user access to large data sets, 20th Intl. Conf. On
+Interactive Information Processing Systems for Meteor. Ocean. And Hydrology. Seattle,
+WA, 11-15 Jan 2004.
+
+    Mesinger, F., G. DiMego, E. Kalnay, P. Shafran, W. Ebisuzaki, Y. Fan, R. Grumbine,
+W. Higgins, Y. Lin, K. Mitchell, D. Parrish, E. Rogers, W. Shi, D. Stokes, J. Woolen,
+2003: NCEP Regional Reanalysis, Symp. on Observing and Understanding the Variability
+of Water in Weather and Climate, Long Beach, CA, Feb.9-13, 2003.
+"""
+
+DESCRSHORT  = """NCEP NARR data sets"""
+
+DESCRLONG   = """The NARR is a reanalysis of
+historical observations using a 32 km version of the NCEP 1993
+operational ETA model and ETA data assimilation system (EDAS).
+The domain of analyses includes North and Central America as
+well as small parts of the UK, Eastern Asia and South America
+and the oceans in between. The period of the reanalyses is from
+October 1978 to the present and analyses were made 8 times
+daily. Horizontal boundary conditions were derived from the
+NCEP/DOE Reanalysis.
+The "merged" dataset provides a high spatial (32 km) and
+temporal (3 hour) analyses of North America and adjacent oceans
+and land masses from October 1978 to the present. Advantages
+over the widely used NCEP/NCAR Reanalysis are its higher
+resolution and a much better treatment of the land surface
+through a better land-surface model (NOAH), through the
+assimilation of more surface data (observed precipitation and
+surface winds) and through a better representation of the
+terrain (heights, vegetation, soil type).
+This data set contains "conventional" atmospheric analyses as
+well as model-derived fields which contain estimates of
+subsurface, surface, and radiative properties.
+"""
+
+import dap.client
+import datetime
+import numpy as np
+
+NARR_A_URL = "http://nomads.ncdc.noaa.gov:9091/dods/NCEP_NARR_DAILY"
+
+def load(year, month, day, verbose=True):
+    """
+    Load the National Center for Environment Prediction (NCEP) North American 
+    Regional Reanalysis (NARR) data at the given date. The data is available 
+    through Data Access Protocol (DAP) from a remote server. The returned 
+    object is not the entire data set, but only the metadata describing the 
+    data set content. Individual variables are properties of the object, and
+    are downloaded only on explicit request (see example below).  
+    
+    Parameters:
+        year : int
+        month : int 
+        day : int
+        
+    Note:
+    The data is available starting on 1979-01-01 and up to the the month before
+    last. Each dataset contains around 190 different variables at 3h intervals. 
+    The DAP protocol was formerly known as the Distributed Oceanographic Data 
+    Systems (DODS).
+    
+    
+    Some variables included in the set:
+        ugrd10m : Wind speed (u) at 10 m altitude [m/s].
+        vgrd10m : Wind speed (v) at 10 m altitude [m/s].
+        mslet: Mean sea level pressure (eta model) [pa].
+        tmpsfc : Surface temperature [K].
+        dswrfsfc : Surface downward shortwave radiation flux [W/m^2]. 
+        time : Days since 1-1-1  00:00:00.
+        lat : Latitude (0 to 89.625) at 0.375 degree resolution [deg].
+        lon : Longitude (-220 to -0.625) at 0.375 degree resolution [deg]. 
+    
+    Example:
+        narr = load(2005, 6, 23)
+        temp = narr.tmpsfc[:][:][:] # Slices refer to time, lat, lon.
+        time = narr.time[:]
+        lat = narr.lat[:]
+        lon = narr.lon[:]
+    
+    """
+
+    tail = 'narr-a_221_' 
+    dir1 = '%d%02d'%(year, month)
+    dir2 = dir1+'%02d'%day
+    tail = tail +dir2+'_0000_000'
+    url = '/'.join([NARR_A_URL, dir1, dir2, tail])
+    if verbose:
+        print 'Accessing DODS server: ', url
+    return dap.client.open(url)
+
+
+
+def convert_time(time):
+    """Return datetime objects. 
+    
+    The NARR dataset provides time in days since 1-1-1 00:00:00:0.0. This 
+    function converts the NARR time into a datetime.datetime object. 
+    
+    Note:
+    There seems to be a discrepancy between the days counting of NARR and 
+    python datetime. To achieve the fit, two days must be substracted from the
+    NARR time.
+    """
+    time = time-2
+    t0 = datetime.datetime(1,1, 1, 0,0,0)
+    hour = datetime.timedelta(hours=1)
+    day = datetime.timedelta(days=1)
+    time = np.atleast_1d(time)
+    days = time.astype(int)
+    hours =  ((time%1)*24).astype(int)
+    return t0+days*day+hours*hour
+    
+    
+narr = load(1979, 1,1)
diff --git a/scikits/learn/datasets/narr/doc/narr_data_documentation.pdf b/scikits/learn/datasets/narr/doc/narr_data_documentation.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..fe5727b11e94a1d230f131a75a66c067db7da588
GIT binary patch
literal 60799
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

literal 0
HcmV?d00001

diff --git a/scikits/learn/datasets/narr/doc/overview.pdf b/scikits/learn/datasets/narr/doc/overview.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..aedba53e76d2743195e14ae9746846bdb5d4766a
GIT binary patch
literal 10031
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
Q<K;qHR%K{t247eO0Q&~ibN~PV

literal 0
HcmV?d00001

diff --git a/scikits/learn/datasets/setup.py b/scikits/learn/datasets/setup.py
index 4926774d39..e7493dff0f 100644
--- a/scikits/learn/datasets/setup.py
+++ b/scikits/learn/datasets/setup.py
@@ -8,6 +8,8 @@ def configuration(parent_package='',top_path=None):
     config.add_subpackage('iris')
     config.add_subpackage('heart')
     config.add_subpackage('german')
+    config.add_subpackage('nwis')
+    config.add_subpackage('narr')
     config.add_subpackage('misc')
     config.make_config_py() # installs __config__.py
     return config
-- 
GitLab