threddsclient 0.4.2

Thredds catalog client

Thredds Client for Python

Installing Thredds Client

Anaconda

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

$ conda install -c conda-forge threddsclient

From github

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

$ git clone https://github.com/bird-house/threddsclient.git
$ cd threddsclient
$ conda env create -f environment.yml
$ source activate threddsclient
$ python setup.py 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('http://example.com/thredds/catalog.xml')

Get OpenDAP URLs of a catalog

import threddsclient
urls = threddsclient.opendap_urls('http://example.com/thredds/catalog.xml')

Navigate in catalog

Start reading a catalog

import threddsclient
cat = threddsclient.read_url('http://example.com/thredds/catalog.xml')

Get a list of references to other catalogs & follow them

refs = cat.references

print refs[0].name
cat2 = refs[0].follow()

Get a list of datasets in this catalog

data  = cat.datasets

Get flat list of all direct datasets (data files) in the catalog

datasets = cat.flat_datasets()

Get flat list of all references in the catalog

references = cat.flat_references()

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('http://example.com/thredds/catalog.xml', depth=2):
    print ds.name

Development

Install sources

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

$ git clone https://github.com/bird-house/threddsclient.git
$ cd threddsclient
$ conda env create -f environment.yml
$ python setup.py develop

Install additional dependencies:

$ conda install pytest flake8 sphinx bumpversion
OR
$ 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

• NOAA Thredds Catalog

Authors

• Scott Wales [e-mail]

• Carsten Ehbrecht [e-mail]

Changes

0.4.2 (2019-11-20)

• fixed conda links in Readme.

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.

• MANIFEST.in 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)

• Version by https://github.com/ScottWales/threddsclient.