Skip to content

OWI Metadatabase SDK

PyPI version Python versions License Documentation

What is the OWI Metadatabase SDK?

The OWI Metadatabase SDK is a Python package that provides tools for accessing and processing geometry and location data from the OWI-Lab metadatabase for offshore wind installations. It serves as the core package in a modular namespace architecture, with optional extras that install the soil, results, and SHM extensions into the same namespace.

  • Geometry — offshore wind turbine geometry data and structural processing
  • Locations — project site and asset location queries
  • Extensions — optional soil, results, and SHM packages installed through core extras

Get started

pip install owi-metadatabase

from owi.metadatabase.geometry.io import GeometryAPI
from owi.metadatabase.locations.io import LocationsAPI

geometry_api = GeometryAPI(token="your-token")
locations_api = LocationsAPI(token="your-token")

Extension packages

The SDK uses namespace packages so additional domains can be installed alongside the core:

See Extension overview for a side-by-side comparison of the deployed extras.

Extension Install Import
Soil pip install "owi-metadatabase[soil]" from owi.metadatabase.soil import SoilAPI
Results pip install "owi-metadatabase[results]" from owi.metadatabase.results import ResultsAPI
SHM pip install "owi-metadatabase[shm]" from owi.metadatabase.shm import ShmAPI

Citation

@software{owi_metadatabase_sdk,
  author = {OWI-Lab},
  title = {OWI-metadatabase SDK},
  year = {2026},
  url = {https://github.com/OWI-Lab/owi-metadatabase-sdk},
  doi = {10.5281/zenodo.10620568}
}

Acknowledgements

This package was developed as part of the ETF Smartlife (FOD165) and WILLOW (EUAR157) projects.

Support