Skip to main content

Will get time series from different sources on the internet

Project description

Tests Test Coverage Latest release BSD-3 clause license PyPI - Python Version

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

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’.

about

Display version number and system information.

cdec

US/CA station E,H,D,M: California Department of Water Resources

coops

global station 1T,6T,H,D,M: Center for Operational Oceanographic Products and Services

cpc

US/region W: Climate Prediction Center, Weekly Drought Index

daymet

NAmerica 1km 1980- D,M:Daymet, daily meteorology by the Oak Ridge National Laboratory

fawn

US/FL 15T,H,D,M:Florida Automated Weather Network (FAWN)

hydstra_ts

Kisters Hydstra Webservice - time series values

hydstra_catalog

Kisters Hydstra Webservice - variable catalog for a station

hydstra_stations

Kisters Hydstra Webservice - station list for a server

ldas

grid: Land Data Assimilation System, includes all ldas_* (NLDAS, GLDAS2, TRMM, SMERGE, GRACE, MERRA)

ldas_gldas_noah

global 0.25deg 2000- 3H:GLDAS NOAH hydrology model results

ldas_grace

NAmerica 0.125deg 2002- 7D:Groundwater and soil moisture from GRACE

ldas_merra

global 0.5x0.625deg 1980- H:MERRA-2 Land surface forcings

ldas_merra_update

global 0.5x0.667deg 1980-2016 H:MERRA-2 Analysis update

ldas_nldas_fora

NAmerica 0.125deg 1979- H:NLDAS Weather Forcing A (surface)

ldas_nldas_noah

NAmerica 0.125deg 1979- H:NLDAS NOAH hydrology model results

ldas_smerge

global 0.125deg 1997- D:SMERGE-Noah-CCI root zone soil moisture

ldas_trmm_tmpa

global 0.25deg 1997- 3H:TRMM (TMPA) rainfall estimate

metdata

NAmerica 4km 1980- D: Download daily data from METDATA based on PRISM.

modis

global 250m,500m,1000m 2000- 4D,8D,16D,A:Download MODIS derived data.

ncei_ghcnd_ftp

global station D:NCEI Global Historical Climatology Network - Daily (GHCND)

ncei_ghcnd

global station D:Global Historical Climatology Network - Daily (GHCND)

ncei_gsod

global station D:NCEI Global Summary of the Day (GSOD)

ncei_gsom

global station M:NCEI Global Summary of Month (GSOM)

ncei_gsoy

global station A:NCEI Global Summary of Year (GSOY)

ncei_normal_ann

global station A: NCEI annual normals

ncei_normal_dly

global station D:NCEI Daily Normals

ncei_normal_hly

global station H:NCEI Normal hourly

ncei_normal_mly

global station M:NCEI Monthly Summaries.

ncei_precip_15

global station 15T:NCEI 15 minute precipitation

ncei_precip_hly

global station H:NCEI hourly precipitation

ncei_annual

global station A:NCEI annual data summaries

ncei_ghcndms

global station M:NCEI GHCND Monthly Summaries (GHCNDMS)

ncei_ish

global station H:Integrated Surface Database

ndbc

US station T,6T,10T,15T,H,D:Download historical from the National Data Buoy Center.

nwis

US station:Use the nwis_* functions instead.

nwis_iv

US station E:USGS NWIS Instantaneous Values

nwis_dv

US station D:USGS NWIS Daily Values

nwis_site

US station:USGS NWIS Site Database

nwis_gwlevels

US station:USGS NWIS Groundwater Levels

nwis_measurements

US station:USGS NWIS Measurements

nwis_peak

US station:USGS NWIS Peak

nwis_stat

US station:USGS NWIS Statistic

epa_wqp

US station E:EPA Water Quality Portal.

rivergages

US station:USACE river gages

swtwc

US/region station:USACE Southwest Division, Tulsa Water Control

terraclimate

global 1/24deg 1958- M:Download monthly data from Terraclimate.

terraclimate2C

global 1/24deg M:Monthly normals from Terraclimate with 2deg C hotter climate.

terraclimate4C

global 1/24deg M:Monthly normals from Terraclimate with 4deg C hotter climate.

terraclimate19611990

global 1/24deg M:Monthly normals using TerraClimate monthly data from 1961 to 1990.

terraclimate19812010

global 1/24deg M:Monthly normals using TerraClimate monthly data from 1981 to 2010.

twc

US/TX station D:Download Texas Weather Connection (TWC) data.

unavco

US station: Download data from the Unavco web services.

Usage Summary - Python Library

To use the tsgettoolbox in a project:

from tsgettoolbox import tsgettoolbox
df = tsgettoolbox.nwis_dv(sites="02329500", startDT="2000-01-01")

Refer to the API Documentation at tsgettoolbox_api.

Usage Summary - Command Line

tsgettoolbox nwis_dv –sites 02329500 –startDT 2000-01-01

Refer to the command line documentation at tsgettoolbox_cli.

Development

Development is managed on bitbucket or github. https://bitbucket.org/timcera/tsgettoolbox/overview. https://github.com/timcera/tsgettoolbox

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

tsgettoolbox-26.1.0.tar.gz (94.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tsgettoolbox-26.1.0-py3-none-any.whl (858.0 kB view details)

Uploaded Python 3

File details

Details for the file tsgettoolbox-26.1.0.tar.gz.

File metadata

  • Download URL: tsgettoolbox-26.1.0.tar.gz
  • Upload date:
  • Size: 94.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for tsgettoolbox-26.1.0.tar.gz
Algorithm Hash digest
SHA256 9d8959528e8980cb88191bae7d02266a3d95e9a4b09fb8d29e0d46d9e74e716e
MD5 f613a8334c17393e77d5d4584d38f504
BLAKE2b-256 88e4947eb544d58de25172d83be3b8f32a8d8e073214e3dcc8e0b2183ea6e7e6

See more details on using hashes here.

Provenance

The following attestation bundles were made for tsgettoolbox-26.1.0.tar.gz:

Publisher: pypi-package.yml on timcera/tsgettoolbox

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tsgettoolbox-26.1.0-py3-none-any.whl.

File metadata

  • Download URL: tsgettoolbox-26.1.0-py3-none-any.whl
  • Upload date:
  • Size: 858.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for tsgettoolbox-26.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 777d32a033818fde7e90f7a4e09fd15b5b0ebe56e8eb4643ca95f9e58152758e
MD5 0809103585b2343f02dd0f5e17fbeb54
BLAKE2b-256 1f49b090eec7880cc7ae7d4d38d042953dff35f2b38ace983d189d457c79b613

See more details on using hashes here.

Provenance

The following attestation bundles were made for tsgettoolbox-26.1.0-py3-none-any.whl:

Publisher: pypi-package.yml on timcera/tsgettoolbox

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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