awesIO

Input/output standard for airborne wind energy systems.

awesIO provides JSON Schema-based validation for AWE system configurations and was developed in the context of IEA Wind Task 48. The terminology/ontology used follows the Airborne Wind Europe Glossary: https://airbornewindeurope.org/glossary-2

Available Schemas

Currently includes schemas for:

• Complete airborne systems
• Power curves
• Wind resource data
• Operational constraints

Installation for users using pip and pixi

Install the latest version from the main branch without cloning:

pip install git+https://github.com/awegroup/awesIO.git

pixi add --pypi "awesio @ git+https://github.com/awegroup/awesIO.git"

Install from a specific branch:

pip install git+https://github.com/awegroup/awesIO.git@branch-name

pixi add --pypi "awesio @ git+https://github.com/awegroup/awesIO.git@branch-name"

Install from a specific commit or tag:

pip install git+https://github.com/awegroup/awesIO.git@commit-hash
pip install git+https://github.com/awegroup/awesIO.git@v0.1.0

pixi add --pypi "awesio @ git+https://github.com/awegroup/awesIO.git@commit-hash"
pixi add --pypi "awesio @ git+https://github.com/awegroup/awesIO.git@v0.1.0"

Usage

After installation, you can import and use awesIO:

from awesio.validator import validate

# Validates YAML file (auto-detects schema from file metadata)
data = validate("path/to/config.yml")

You can also add the restrictive=True option to enforce that no additional properties are allowed beyond those defined in the schema. This can help catch typos or unintended fields in your YAML files.

Installation for developers

Fetch the latest version from git:

git clone https://github.com/awegroup/awesIO
cd awesIO

pip

pip install -e .
pip install -r docs/requirements.txt

Examples

Example YAML configuration files are available in the examples/ directory.

Contributing

Please check the developer guide in the documentation: