Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Loads climate and hydrology data from ACIS (NOAA RCCs), CoCoRaHS, Hydromet (USBR), SNOTEL AWDB (NRCS) and NWIS (USGS).

Project Description
.. image:: https://raw.githubusercontent.com/heigeo/climata-viewer/master/app/images/logo-small.png
:target: http://climata.houstoneng.net
:alt: Climata
:align: center

**climata** is a pythonic interface for loading and processing time series data
from climate and flow monitoring stations and observers. climata leverages
a number of webservices as listed below. climata is powered by
`wq.io <http://wq.io/wq.io>`_, and shares its goal of maximizing the reusability of
data parsing code, by smoothing over some of the differences between various data formats.


.. image:: https://img.shields.io/pypi/v/climata.svg
:target: https://pypi.python.org/pypi/climata
:alt: Latest PyPI Release

.. image:: https://img.shields.io/github/release/heigeo/climata.svg
:target: https://github.com/heigeo/climata/releases
:alt: Release Notes

.. image:: https://img.shields.io/pypi/l/climata.svg
:target: https://github.com/heigeo/climata/blob/master/LICENSE
:alt: License

.. image:: https://img.shields.io/github/stars/heigeo/climata.svg
:target: https://github.com/heigeo/climata/stargazers
:alt: GitHub Stars

.. image:: https://img.shields.io/github/forks/heigeo/climata.svg
:target: https://github.com/heigeo/climata/network
:alt: GitHub Forks

.. image:: https://img.shields.io/github/issues/heigeo/climata.svg
:target: https://github.com/heigeo/climata/issues
:alt: GitHub Issues
|
.. image:: https://img.shields.io/travis/heigeo/climata.svg
:target: https://travis-ci.org/heigeo/climata
:alt: Travis Build Status

.. image:: https://img.shields.io/pypi/pyversions/climata.svg
:target: https://pypi.python.org/pypi/climata
:alt: Python Support


Getting Started
---------------

::

pip3 install climata

See https://github.com/heigeo/climata to report any issues.

Available Services
------------------

=================== ================================================================ ============== ============
Module Classes Data Source Agency/Org.
=================== ================================================================ ============== ============
climata.acis_ ``StationMetaIO``, ``StationDataIO`` ACIS_ NOAA RCCs
climata.cocorahs_ ``CocorahsIO`` CoCoRaHS_ CoCoRaHS
climata.hydromet_ ``DailyDataIO``, ``InstantDataIO``, ``AgrimetRecentIO`` Hydromet_ USBR
climata.nws_ ``HydroForecastIO``, ``EnsembleForecastIO``, ``EnsembleSiteIO`` CNRFC_ NWS
climata.snotel_ ``StationIO``, ``StationDailyDataIO``, ``RegionDailyDataIO`` `SNOTEL AWDB`_ NRCS
climata.usgs_ ``SiteIO``, ``DailyValueIO``, ``InstantValueIO`` NWIS_ USGS
=================== ================================================================ ============== ============

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.acis import StationDataIO

# Load average temperature for sites in Mississippi Headwaters HUC8
sites = StationDataIO(
basin="07010101",
start_date="2012-12-01",
end_date="2012-12-31",
parameter="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


More Python code examples are available via the `climata-viewer website`_.

.. _ACIS: http://data.rcc-acis.org/
.. _CoCoRaHS: http://data.cocorahs.org/cocorahs/export/exportmanager.aspx
.. _Hydromet: http://www.usbr.gov/pn/hydromet/arcread.html
.. _CNRFC: http://www.cnrfc.noaa.gov/
.. _SNOTEL AWDB: http://www.wcc.nrcs.usda.gov/web_service/awdb_web_service_landing.htm
.. _NWIS: http://waterdata.usgs.gov/nwis
.. _climata.acis: https://github.com/heigeo/climata/blob/master/climata/acis/__init__.py
.. _climata.cocorahs: https://github.com/heigeo/climata/blob/master/climata/cocorahs/__init__.py
.. _climata.hydromet: https://github.com/heigeo/climata/blob/master/climata/hydromet/__init__.py
.. _climata.nws: https://github.com/heigeo/climata/blob/master/climata/nws/__init__.py
.. _climata.snotel: https://github.com/heigeo/climata/blob/master/climata/snotel/__init__.py
.. _climata.usgs: https://github.com/heigeo/climata/blob/master/climata/usgs/__init__.py
.. _climata-viewer website: http://climata.houstoneng.net/datarequests/
Release History

Release History

This version
History Node

0.4.1

History Node

0.4.0

History Node

0.3.2

History Node

0.3.1

History Node

0.3.0

History Node

0.2.0

History Node

0.1.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
climata-0.4.1.tar.gz (21.3 kB) Copy SHA256 Checksum SHA256 Source Mar 29, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting