siphon

library0.10.0pypypi✓ verified 85d ago

Siphon is a collection of Python utilities for interacting with the Unidata technology stack, particularly for accessing and downloading remote datasets via THREDDS Data Servers (TDS). Current version 0.10.0 requires Python >=3.10. Releases are periodic, roughly yearly.

data http-networking

pip install siphon

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · SIPHON

siphon

datapythonv0.10.0

Install

9.1s avg

Import

653ms

Disk

171MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.10.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.686s · 171.3MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 9.1s · import 0.620s · 164MB

171MB installed

● package 171MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TDSCatalog

✓ from siphon.catalog import TDSCatalog

✗ from siphon import TDSCatalog

TDSCatalog is not in the top-level siphon namespace; must import from siphon.catalog.

NCSS

✓ from siphon.ncss import NCSS

✗ from siphon import NCSS

NCSS (NetCDF Subset Service) is in siphon.ncss.

remote_open

✓ from siphon.ncss import remote_open

remote_open is a utility function in the ncss module.

Connects to a THREDDS Data Server catalog and lists available datasets.

from siphon.catalog import TDSCatalog # Create a catalog object for the Unidata THREDDS server cat = TDSCatalog('https://thredds.ucar.edu/thredds/catalog.xml') # List datasets print(list(cat.datasets)[:5])

Debug

Known issues

breakingSiphon 0.9.0 dropped support for Python 2.7 and older Python 3.x. Python >=3.6 required; from 0.10.0, Python >=3.10 required.

fix

Use Python 3.10 or newer for siphon >=0.10.0.

affects: 0.9.0+

deprecatedThe 'siphon.cdmr' module is deprecated as of siphon 0.9.0 and may be removed in a future release.

fix

Migrate to using 'siphon.ncss' or direct NetCDF4 access via remote_open.

affects: 0.9.0+

gotchaWhen using TDSCatalog with a remote server, ensure the URL points to a valid catalog.xml, not a dataset access URL. Otherwise, parsing may fail silently.

fix

Append '/catalog.xml' to the base THREDDS server URL if not already present.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'siphon'

Siphon is not installed or installed in a different environment.

fix

Run 'pip install siphon' in the correct Python environment.

AttributeError: module 'siphon' has no attribute 'TDSCatalog'

TDSCatalog is not in the top-level siphon module.

fix

Use 'from siphon.catalog import TDSCatalog'.

requests.exceptions.ConnectionError: HTTPSConnectionPool

Network issue or incorrect URL when accessing a THREDDS server.

fix

Verify the catalog URL is correct and reachable. Use 'https://thredds.ucar.edu/thredds/catalog.xml' as a test.

Upgrade

Version history

0.10.0latest on PyPI · released Dec 13, 2024

Audit

Dependencies

beautifulsoup4requiredRequired for parsing XML/HTML responses from TDS catalogs.

requestsrequiredUsed for HTTP requests to remote data servers.

Agent activity

14 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/Unidata/siphon ↗

packagehttps://pypi.org/project/siphon/ ↗

homepagehttps://unidata.github.io/siphon/ ↗

docshttps://unidata.github.io/siphon/ ↗

changeloghttps://github.com/Unidata/siphon/releases ↗