Skip to main content

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

Project description

Climata

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, and shares its goal of maximizing the reusability of data parsing code, by smoothing over some of the differences between various data formats.

Latest PyPI Release Release Notes License GitHub Stars GitHub Forks GitHub Issues

Travis Build Status Python Support

Getting Started

# Recommended: create virtual environment
# python3 -m venv venv
# . venv/bin/activate
pip 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.epa

WqxDomainIO

WQX

EPA

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 Upper Klamath Lake basin
wq cat climata.acis.StationMetaIO "basin=18010203" > sites.csv

# Load daily average temperature for these sites
PARAMS="basin=18010203,start_date=2017-01-01,end_date=2017-01-31,parameter=avgt"
wq cat climata.acis.StationDataIO "$PARAMS" > data.csv

Python API:

from climata.acis import StationDataIO

# Load average temperature for sites in Upper Klamath Lake basin
sites = StationDataIO(
    basin="18010203",
    start_date="2017-01-01",
    end_date="2017-01-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.

Download files

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

Source Distribution

climata-0.5.0.tar.gz (22.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page