📋 Schema Documentation

This page documents the JSON schemas used for validating wind turbine sensor data in the pipeline.

Wind Turbine Sensor Data Schema

v1.0.0

Complete validation schema for wind turbine telemetry data with business rules.

Schema Structure

Field	Type	Required	Constraints
`timestamp`	string (ISO 8601)	✅	Valid datetime format
`turbine_id`	string	✅	Pattern: WT-XXXX
`site_id`	string	✅	Pattern: SITE-XXX
`temperature`	number	✅	-50 to 60°C
`humidity`	number	✅	0 to 100%
`pressure`	number	✅	800 to 1100 hPa
`wind_speed`	number	✅	0 to 50 m/s
`power_output`	number	✅	0 to 5000 kW
`rotation_speed`	number	❌	0 to 30 RPM
`vibration_x/y/z`	number	❌	0 to 100 mm/s
`pipeline_metadata`	object	❌	Audit trail information

👁️ Interactive Viewer 📄 View Raw JSON ⬇️ Download Schema

1️⃣ Raw

Line-by-line ingestion

2️⃣ Schematized

Convert to JSON + metadata

3️⃣ Validated

Apply external schema

4️⃣ Aggregated

Time-window metrics

5️⃣ Anomaly

Exception handling

🔍 Pipeline Metadata Fields

Every record processed includes audit metadata:

pipeline_version - Version of the processing pipeline
pipeline_stage - Which stage processed this record (raw, schematized, validated, etc.)
processing_timestamp - ISO 8601 timestamp of when processed
git_sha - Git commit hash (40 characters) of pipeline code
node_id - Identifier of the processing node
transformation_hash - SHA256 hash of transformation logic for reproducibility

⚡ Business Logic Validation Rules

The schema enforces physics-based constraints:

✅ Minimum Wind for Rotation: Turbine rotation requires wind speed ≥ 3 m/s
✅ High Wind Safety: Wind speed > 25 m/s limits rotation to ≤ 20 RPM
✅ Power Generation: Power output > 100 kW requires wind speed ≥ 5 m/s
✅ Vibration Limits: All axes limited to 100 mm/s maximum
✅ Temperature Range: -50°C to 60°C operational range

Usage Examples

Python Validation

import requests
import jsonschema

# Fetch schema from aerolake.org
schema_url = "https://aerolake.org/schemas/wind-turbine-v1.json"
schema = requests.get(schema_url).json()

# Your data
data = {
    "timestamp": "2024-01-01T12:00:00Z",
    "turbine_id": "WT-0001",
    "site_id": "SITE-TEX",
    "temperature": 25.5,
    "humidity": 65,
    "pressure": 1013.25,
    "wind_speed": 12.5,
    "power_output": 2500,
    "pipeline_metadata": {
        "pipeline_version": "1.0.0",
        "pipeline_stage": "validated",
        "processing_timestamp": "2024-01-01T12:00:05Z",
        "git_sha": "abc123def456...",
        "node_id": "node-001",
        "transformation_hash": "sha256hash..."
    }
}

# Validate
try:
    jsonschema.validate(data, schema)
    print("✅ Data is valid!")
except jsonschema.ValidationError as e:
    print(f"❌ Validation failed: {e.message}")

Direct URL Access

# Current version (v1)
https://aerolake.org/schemas/wind-turbine-v1.json

# Future versions
https://aerolake.org/schemas/wind-turbine-v2.json
https://aerolake.org/schemas/wind-turbine-v3.json

← Back to Main Documentation | View Interactive Schema →

Wind Turbine Data Pipeline | Schema v1.0.0