cdo-toolkit 0.1.0

CDO-based NetCDF regridding with chunking, parallel workers, and optional CMIP filename helpers

cdo-toolkit

CDO-based NetCDF regridding toolkit: weight caching, time-chunked processing, parallel workers, Rich progress UI, and optional surface/seafloor level extraction.

Works with general NetCDF files. CMIP6 filename helpers (tos_Omon_... variable filtering, nominal_resolution metadata) live in cdo_toolkit.cmip but are optional.

Requirements

• Python ≥ 3.10
• CDO binary on PATH (e.g. conda install -c conda-forge cdo)

Install

pip install cdo-toolkit
# editable from source
pip install -e .

CLI

cdo-toolkit /path/to/data -o /path/to/out -r 1.0 1.0 -w 4
python -m cdo_toolkit /path/to/file.nc --extract-surface

Python API

from pathlib import Path
from cdo_toolkit import CDORegridPipeline, regrid_directory, regrid_single_file

regrid_directory(Path("data/"), target_resolution=(1.0, 1.0), max_workers=8)

Package layout

Module	Role
pipeline	CDORegridPipeline core
api	High-level regrid_directory, regrid_single_file, …
workers	Process-pool worker entrypoints
ui	Rich progress bars
cmip	Optional CMIP6 filename/metadata helpers
paths	Weight-cache and intermediate-file path helpers

License

BSD-3-Clause