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!

Will get time series from different sources on the internet.

Project Description

tsgettoolbox - Quick Guide

The ‘tsgettoolbox’ is a Python script and library to get time-series data from different web services. The tsgettoolbox will work with Python 2.6+ and 3.0+.

Documentation

Reference documentation is at tsgettoolbox_documentation.

Installation

At the command line:

$ pip install tsgettoolbox
# OR
$ easy_install tsgettoolbox

Or, if you have virtualenvwrapper installed:

$ mkvirtualenv tsgettoolbox
$ pip install tsgettoolbox

Usage Summary - Command Line

Just run ‘tsgettoolbox –help’ to get a list of subcommands. To get detailed help for a particular sub-command, for instance ‘coops’, type ‘tsgettoolbox coops –help’.

coops
Download data from Center for Operational Oceanographic Products and Services (CO-OPS). Detailed documentation about the National Ocean Service CO-OPS web services is at http://tidesandcurrents.noaa.gov/api/
daymet
Download data from the Daymet dataset created by the Oak Ridge National Laboratory. Detailed documentation is at http://daymet.ornl.gov/
ldas
Download data from the Land Data Assimilation Service (LDAS). Two projects are available, the National LDAS (0.125x0.125 degree hourly) and the Global LDAS (0.25x0.25 degree 3 hourly).
darksky
Download data from http://api.darksky.net. Detailed documentation about the Forecast.io service is at https://darksky.net/dev/docs. You have to get an API key from https://darksky.net/dev/register
ghcnd

If you use this data, please read ftp://ftp.ncdc.noaa.gov/pub/data/ghcn/daily/readme.txt about “How to cite”.

GHCN (Global Historical Climatology Network)-Daily is an integrated database of daily climate summaries from land surface stations across the globe. Like its monthly counterpart (GHCN-Monthly) , GHCN-Daily is comprised of daily climate records from numerous sources that have been integrated and subjected to a common suite of quality assurance reviews.

modis

Download datasets developed using the MODIS satellite imagery.

Documentation: https://modis.ornl.gov/documentation.html

Policies: https://lpdaac.usgs.gov/products/modis_policies

Citation: https://lpdaac.usgs.gov/citing_our_data

Product Name
MCD12Q1 MODIS/Terra+Aqua Land Cover (LC) Type Yearly L3 Global 500m SIN Grid
MCD12Q2 MODIS/Terra+Aqua Land Cover Dynamics (LCD) Yearly L3 Global 500m SIN Grid
MCD43A1 MODIS/Terra+Aqua BRDF/Albedo (BRDF/MCD43A1) 16-Day L3 Global 500m SIN Grid
MCD43A2 MODIS/Terra+Aqua BRDF/Model Quality (BRDF/MCD43A2) 16-Day L3 Global 500m SIN Grid V005
MCD43A4 MODIS/Terra+Aqua Nadir BRDF-Adjusted Reflectance (NBAR) 16-Day L3 Global 500m SIN Grid
MOD09A1 MODIS/Terra Surface Reflectance (SREF) 8-Day L3 Global 500m SIN Grid
MOD11A2 MODIS/Terra Land Surface Temperature/Emissivity (LST) 8-Day L3 Global 1km SIN Grid
MOD13Q1 MODIS/Terra Vegetation Indices (NDVI/EVI) 16-Day L3 Global 250m SIN Grid [Collection 5]
MOD15A2 Leaf Area Index (LAI) and Fraction of Photosynthetically Active Radiation (FPAR) 8-Day Composite [Collection 5]
MOD16A2 MODIS/Terra Evapotranspiration (ET) 8-Day L4 Global Collection 5
MOD17A2 MODIS/Terra Gross Primary Production (GPP) 8-Day L4 Global [Collection 5.1]
MOD17A3 MODIS/Terra Net Primary Production (NPP) Yearly L4 Global 1km SIN Grid
MYD09A1 MODIS/Aqua Surface Reflectance (SREF) 8-Day L3 Global 500m SIN Grid
MYD11A2 MODIS/Aqua Land Surface Temperature/Emissivity (LST)8-Day L3 Global 1km SIN Grid
MYD13Q1 MODIS/Aqua Vegetation Indices (NDVI/EVI) 16-Day L3 Global 1km SIN Grid
MYD15A2 MODIS/Aqua Leaf Area Index (LAI) and Fraction of Photosynthetically Active Radiation (FPAR) 8 Day Composite
MYD17A2 MODIS/Aqua Gross Primary Production (GPP) 8 Day L4 Global
ncdc_ghcnd_ftp
Download from the Global Historical Climatology Network - Daily.
ncdc_ghcnd
Download from the Global Historical Climatology Network - Daily. Requires registration and free API key.
ncdc_gsom
National Climatic Data Center Global Summary of the Month (GSOM) Requires registration and free API key.
ncdc_gsoy
National Climatic Data Center Global Summary of the YEAR (GSOY) Requires registration and free API key.
ncdc_normal_ann
National Climatic Data Center annual normals. Requires registration and free API key.
ncdc_normal_dly
National Climatic Data Center Daily Normals. Requires registration and free API key.
ncdc_normal_hly
National Climatic Data Center GHCND Monthly Summaries. Requires registration and free API key.
ncdc_normal_mly
National Climatic Data Center GHCND Monthly Summaries. Requires registration and free API key.
ncdc_precip_15
National Climatic Data Center 15 minute precipitation. Requires registration and free API key.
ncdc_precip_hly
National Climatic Data Center hourly precipitation. Requires registration and free API key.
ncdc_annual
National Climatic Data Center annual data summaries. Requires registration and free API key.
ncdc_ghcndms
National Climatic Data Center GHCND Monthly Summaries. Requires registration and free API key.
ndbc
Download data from the National Data Buoy Center.
nwis
Download time-series from the USGS National Water Information Service (NWIS). There are three main NWIS databases. The ‘tsgettoolbox’ can currently pull from the Instantaneous Value database (–database=iv) for sub-daily interval data starting in 2007, and the Daily Values database (–database=dv). Detailed documnetation is available at http://waterdata.usgs.gov/nwis
unavco

Detailed information at: http://www.unavco.com/data/web-services/web-services.html

Returns ‘met’, ‘pore_temperature’, ‘pore_pressure’, ‘tilt’, ‘strain’, or ‘positional’ data for UNAVCO stations.

Usage Summary - Python Library

To use the tsgettoolbox in a project:

from tsgettoolbox import tsgettoolbox

Refer to the API Documentation at tsgettoolbox_documentation.

Development

Development is managed on bitbucket at https://bitbucket.org/timcera/tsgettoolbox/overview.

Release History

Release History

This version
History Node

9.14.5.8

History Node

9.13.5.8

History Node

8.13.5.8

History Node

7.13.5.8

History Node

6.13.5.8

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
tsgettoolbox-9.14.5.8.tar.gz (78.5 kB) Copy SHA256 Checksum SHA256 Source Apr 23, 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