IOC Cleanup
ioc_cleanup provides a reproducible, transparent, and traceable workflow
for cleaning tide gauge data from IOC (Intergovernmental Oceanographic Commission) stations worldwide.
IOC Cleanup database
All stations with clean data between 1st of January 2020 and the 31st of december 2025.
Getting Started
Installation
Minimal example
import searvey
import ioc_cleanup as C
station = "abed"
df_raw = searvey.fetch_ioc_station(station, "2020-01-01", "2026-01-01")
trans = C.load_transformation(station, "bub")
df_clean = C.transform(df_raw, trans)
JSON transformations
Each cleaned station is described by a single JSON file that records every operation applied to the raw signal, so the dataset is fully reproducible from the raw IOC data plus the transformations.
- Automatic -
C.load_transformation(station, sensor)downloads and caches them from Zenodo on first use. See Data Access. - Zenodo - the complete dataset includes
transformations.tar.gz, if you prefer to fetch them by hand. - GitHub - also mirrored on the GitHub releases.
- Build your own - follow the JSON schema and
load it with
C.load_transformation_from_path(...).
Example for maya station:
From raw signal...
... using JSON transformation ...
... to clean signal