Skip to content

README.md

Latest commit

 

History

History
52 lines (43 loc) · 1.79 KB

README.md

File metadata and controls

52 lines (43 loc) · 1.79 KB
Raw

DAB-PYNB

📘 DAB Python Notebooks

This repository contains a small collection of Jupyter notebooks demonstrating how to programmatically access DAB (Discovery and Access Broker) services using the dab-py Python library.

The notebooks focus on accessing:

  • WHOS (WMO Hydrological Observing System)
  • HIS-Central

via the OGC OM-JSON API, showing how to discover features, retrieve observations, and download data programmatically.

📂 Repository contents

Notebook Description
dab_py_demo_his_central.ipynb Tutorial on accessing HIS-Central data using HISCentralClient
dab_py_demo_whos.ipynb Tutorial on accessing WHOS data using WHOSClient

Each notebook is self-contained and includes:

  • Client initialization with API tokens
  • Feature discovery and filtering
  • Observation retrieval
  • Optional pagination
  • Conversion to pandas DataFrames
  • Basic time-series plotting
  • Optional data download workflow (for HIS-Central)

🚀 Open in Google Colab

All notebooks can be executed directly in Google Colab, which means:

  • No local installation required
  • Interactive execution in your browser
  • Easy testing and learning Click the badges in each notebook to open them in Colab.

🐍 Prerequisites

These notebooks rely on the dab-py Python package. If running locally:

pip install dab-py

Or inside a notebook:

!pip install --upgrade dab-py

Note: It’s recommended to keep dab-py up-to-date to ensure compatibility with the latest DAB services.

🔑 Authentication

Access to WHOS and HIS-Central requires a valid API token. Tokens are issued after registration with the relevant DAB service providers.

🔗 Related repositories

dab-py (Python client library) https://github.com/ESSI-Lab/dab-py