Skip to main content

Thredds catalog client

Project description

Thredds Client for Python

Travis Build Install with Conda Join the Chat

Installing Thredds Client


Version Downloads

Thredds client is available as Anaconda package. Install it with the following command:

$ conda install -c birdhouse -c conda-forge threddsclient

From github

Check out code from the birdy GitHub repo and start the installation:

$ git clone
$ cd threddsclient
$ conda env create -f environment.yml
$ source activate threddsclient
$ python develop

Using Thredds Client

Read the Thredds tutorial on catalogs: Thredds Catalog Primer

Get download URLs of a catalog

import threddsclient
urls = threddsclient.download_urls('')

Get OpenDAP URLs of a catalog

import threddsclient
urls = threddsclient.opendap_urls('')

Crawl thredds catalog

Crawl recursive all direct datasets in catalog following the catalog references. Stop recusion at a given depth level.

import threddsclient
for ds in threddsclient.crawl('', depth=2):


Install sources

Check out code from the birdy GitHub repo and start the installation:

$ git clone
$ cd threddsclient
$ conda env create -f environment.yml
$ python develop

Install additional dependencies:

$ conda install pytest flake8 sphinx bumpversion
$ pip install -r requirements_dev.txt

Bump a new version

Make a new version of Birdy in the following steps:

  • Make sure everything is commit to GitHub.

  • Update CHANGES.rst with the next version.

  • Dry Run: bumpversion --dry-run --verbose --new-version 0.3.4 patch

  • Do it: bumpversion --new-version 0.3.4 patch

  • … or: bumpversion --new-version 0.4.0 minor

  • Push it: git push --tags

See the bumpversion documentation for details.

Examples with IPython Notebook



0.4.1 (2019-11-06)

  • fixed docs formatting.

0.4.0 (2019-11-06)

  • drop Python 2.7 (#5)

  • fix pip install (#4)

0.3.5 (2018-10-05)

  • support for Python 3.x (#1)

0.3.4 (2015-10-25)

  • fixed travis build/tests

  • updated docs

0.3.3 (2015-10-24)

  • converted docs to rst.

  • added.

0.3.2 (2015-07-15)

  • append catalog.xml to catalog url if missing

  • crawl method added

0.3.1 (2015-06-14)

  • fixed catalog.follow()

  • using dataset.download_url()

  • added ipython example

  • cleaned up Readme

0.3.0 (2015-06-13)

  • Refactored

  • added catalog.opendap_urls()

0.2.0 (2015-06-08)

  • Refactored

  • using CollectionDataset

  • added catalog.download_urls()

0.1.1 (2015-06-05)

  • Fixed catalog generation.

  • added pytest dependency.

0.1.0 (2015-03-13)

Project details

Download files

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

Source Distribution

threddsclient-0.4.1.tar.gz (16.8 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page