A Python package for loading, processing, and visualizing data from the WBTS (Western Boundary Time Series) project. This package provides tools for handling oceanographic CTD (Conductivity-Temperature-Depth) data with functions for data loading, conversion, plotting, and analysis.

• Load and process CTD oceanographic data from NetCDF files
• Data conversion utilities for WBTS datasets
• Visualization functions for time series and profile data
• Data merging and quality control tools
• Support for ADCP velocity data
• Integration with the scientific Python ecosystem (xarray, pandas, matplotlib)

Clone the repository and install in development mode:

git clone https://github.com/ocean-uhh/WBTSdata.git
cd WBTSdata
pip install -e .

Create a conda environment with all dependencies:

git clone https://github.com/ocean-uhh/WBTSdata.git
cd WBTSdata
conda env create -f environment.yml
conda activate WBTSdata
pip install -e . --no-deps

from WBTSdata import plotters, tools, convert

# Load and plot oceanographic data
# (See notebooks/ directory for detailed examples)

• API Documentation: https://ocean-uhh.github.io/WBTSdata/
• Examples: See the notebooks/ directory for Jupyter notebook examples
• Data: Example datasets are available in the data/ directory

WBTSdata/
├── WBTSdata/           # Main package
│   ├── plotters.py     # Visualization functions
│   ├── convert.py      # Data conversion utilities  
│   ├── tools.py        # General utility functions
│   ├── load_vel_files.py # Velocity data loading
│   └── merge_datasets.py # Dataset merging
├── notebooks/          # Example Jupyter notebooks
├── data/              # Data files
├── docs/              # Documentation source
└── tests/             # Test suite

git clone https://github.com/ocean-uhh/WBTSdata.git
cd WBTSdata
pip install -r requirements-dev.txt
pip install -e .

pytest

cd docs/
make html

The built documentation will be available in docs/build/html/.

This project uses pre-commit hooks for code quality:

pip install pre-commit
pre-commit install
pre-commit run --all-files

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-feature)
3. Make your changes
4. Run tests and ensure code passes pre-commit checks
5. Commit your changes (git commit -m 'Add new feature')
6. Push to the branch (git push origin feature/new-feature)
7. Open a Pull Request

If you use this software in your research, please cite it:

@software{wbtsdata,
  author = {Moritz, Till and Frajka-Williams, Eleanor},
  title = {WBTSdata},
  version = {0.0.1},
  year = {2025},
  url = {https://github.com/ocean-uhh/WBTSdata}
}

This project is licensed under the terms specified in the LICENSE file.

• Till Moritz - University of Hamburg
• Eleanor Frajka-Williams - University of Hamburg

• Western Boundary Time Series project
• AOML/NOAA for data provision
• University of Hamburg - Institute of Oceanography