v0.1.0

README.rst

@@ -0,0 +1,50 @@
+climata
+=======
+
+climata is a pythonic interface for loading and processing time series data
+from the Applied Climate Information System (ACIS).  climata leverages the
+webservices available at http://data.rcc-acis.org.
+
+Getting Started
+---------------
+
+::
+
+    pip install climata
+
+See https://github.com/heigeo/climata to report any issues.
+climata is powered by `wq.io <http://wq.io/wq.io>`_.
+
+Usage
+-----
+Command-line interface:
+
+::
+
+    # Load metadata for sites in Mississippi Headwaters HUC4
+    acis_sites.py 0701 > sites.csv
+
+    # Load daily average temperature for these sites
+    acis_data.py 0701 avgt > data.csv
+
+
+Python API:
+
+::
+
+    from climata import StationDataIO
+
+    # Load average temperature for sites in Mississippi Headwaters HUC8
+    sites = StationDataIO(
+        basin="07010101",
+        sdate="2012-12-01",
+        edate="2012-12-31",
+        elems="avgt"
+    )
+
+    # Display site information and time series data
+    for site in sites:
+        print site.name
+        for evt in site.data:
+            print evt.date, evt.avgt
+

setup.py

@@ -2,7 +2,8 @@
 from setuptools import setup, find_packages
 
 LONG_DESCRIPTION = """
-Library for iterating over Applied Climate Information System time series data
+A python library for iterating over Applied Climate Information System (ACIS)
+time series data.  Powered by wq.io.
 """
 
 def long_description():
@@ -16,18 +17,18 @@ def long_description():
 
 setup(
     name='climata',
-    version='0.1.0-dev',
+    version='0.1.0',
     author='HEI Geo',
     author_email='gis@houstoneng.com',
     url='https://github.com/heigeo/climata',
     license='MIT',
     packages=find_packages(),
-    description='Load Applied Climate Information System time series data',
+    description='A pythonic interface for Applied Climate Information System (ACIS) data',
     long_description=long_description(),
     install_requires=['wq.io>=0.3.0'],
     scripts=['climata/bin/acis_sites.py', 'climata/bin/acis_data.py'],
     classifiers = [
-        'Development Status :: 3 - Alpha',
+        'Development Status :: 2 - Pre-Alpha',
         'Environment :: Web Environment',
         'License :: OSI Approved :: MIT License',
         'Natural Language :: English',