Skip to content

Example Data v0.6.0

Choose a tag to compare

View all tags
@DarriEy DarriEy released this 30 Dec 04:42
· 1857 commits to main since this release
examples-data-v0.6.0
594606e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

SYMFLUENCE Example Data v0.6.0

Minimal test data bundle for SYMFLUENCE v0.6.0 CI and testing.

What's Included

domain_bow_banff_minimal

Bow River at Banff, Alberta, Canada

  • Location: 51.18°N, -115.57°W
  • Basin Area: ~2290 km²
  • Forcing: ERA5 hourly reanalysis (January 2004)
  • Observations: WSC streamflow data

Contents:

  • forcing/raw_data/
    • bow_banff_ERA5_200401_3hr.nc - 3-hour forcing for smoke tests (44 KB)
    • bow_banff_ERA5_200401_1month.nc - 1-month forcing for full tests (737 KB)
  • shapefiles/ - Pour point, catchment, river network, basin boundaries
  • attributes/ - DEM (elevation), land cover, soil classification
  • observations/streamflow/ - Preprocessed streamflow observations

Use Cases:

  • CI validation (smoke tests, full pipeline tests)
  • SUMMA workflow testing
  • Calibration workflow testing
  • Documentation examples

Installation

Option 1: Manual Download

  1. Download example_data_v0.6.0.zip
  2. Extract to your SYMFLUENCE data directory: 
    unzip example_data_v0.6.0.zip -d /path/to/SYMFLUENCE_data/

Option 2: Automatic (via pytest fixtures)

The SYMFLUENCE test suite will automatically download and extract this bundle when running tests that require data.

Usage

In Tests

def test_my_workflow(bow_domain):
    """Use bow_domain fixture to access test data."""
    forcing_file = bow_domain / "forcing" / "raw_data" / "bow_banff_ERA5_200401_1month.nc"
    # ... test code

In Examples

from pathlib import Path

# Assuming data was extracted to SYMFLUENCE_data/
data_root = Path("/path/to/SYMFLUENCE_data/example_data_v0.6.0")
domain = data_root / "domain_bow_banff_minimal"

# Use in your workflow
config["DOMAIN_NAME"] = "bow_banff_minimal"
config["EXPERIMENT_TIME_START"] = "2004-01-01 01:00"
config["EXPERIMENT_TIME_END"] = "2004-01-01 04:00"  # 3-hour smoke test

Changes from v0.5.5

  • Smaller bundle size: 17 MB (vs 354 MB in v0.5.5)
  • Focused on complete time series: Only includes Bow domain with full hourly ERA5 forcing
  • Optimized for CI: Separate 3-hour and 1-month forcing subsets for different test levels
  • Removed incomplete data: Elliðaár and Fyrisån domains had incomplete forcing and were removed

Data Sources

  • DEM: Copernicus DEM GLO-30
  • Land cover: MODIS MCD12Q1
  • Soil: SoilGrids250m
  • Forcing: ERA5 (ECMWF Reanalysis v5)
  • Streamflow: Water Survey of Canada (WSC)

Bundle Size Breakdown

  • Total uncompressed: 30.0 MB
  • Total compressed: 17.0 MB
  • Compression ratio: 43% size reduction

Component sizes (uncompressed):

  • Shapefiles: 10.8 MB
  • Observations: 14.5 MB
  • Attributes: 4.0 MB
  • Forcing (1-month): 0.7 MB

License

The example data is provided for testing and evaluation purposes. Original data sources retain their respective licenses.

Related Releases

Assets 3
Loading