Schema Overview

8
Required Fields
11
Optional Fields
6
Metadata Fields
3
Business Rules

This JSON Schema defines the structure and validation rules for wind turbine sensor telemetry data. It includes environmental readings, operational metrics, and pipeline processing metadata for complete audit trails.

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://aerolake.org/schemas/wind-turbine-v1.json",
  "title": "Wind Turbine Sensor Data",
  "version": "1.0.0"
}

Required Fields

timestamp
REQUIRED string
ISO 8601 timestamp of the sensor reading
format: date-time example: "2024-01-01T12:00:00Z"
turbine_id
REQUIRED string
Unique identifier for the wind turbine
pattern: ^WT-[0-9]{4}$ example: "WT-0001"
site_id
REQUIRED string
Site location identifier
pattern: ^SITE-[A-Z]{3}$ example: "SITE-TEX"
temperature
REQUIRED number
Ambient temperature in Celsius
min: -50 max: 60 unit: °C
humidity
REQUIRED number
Relative humidity percentage
min: 0 max: 100 unit: %
pressure
REQUIRED number
Atmospheric pressure
min: 800 max: 1100 unit: hPa
wind_speed
REQUIRED number
Wind speed measurement
min: 0 max: 50 unit: m/s
power_output
REQUIRED number
Current power generation
min: 0 max: 5000 unit: kW

Optional Fields

rotation_speed
OPTIONAL number
Rotor rotation speed
min: 0 max: 30 unit: RPM
vibration_x / vibration_y / vibration_z
OPTIONAL number
3-axis vibration measurements
min: 0 max: 100 unit: mm/s

Pipeline Metadata

Every processed record includes comprehensive metadata for audit trails and data lineage:

pipeline_version

Version of the processing pipeline (e.g., "1.0.0")

pipeline_stage

Processing stage: raw, schematized, validated, aggregated, or anomaly

processing_timestamp

ISO 8601 timestamp of when the record was processed

git_sha

40-character Git commit hash of the pipeline code

node_id

Identifier of the processing node

transformation_hash

SHA256 hash of transformation logic for reproducibility

Business Validation Rules

⚡ Minimum Wind for Rotation

Turbine rotation requires a minimum wind speed of 3 m/s. If rotation_speed > 0, then wind_speed must be ≥ 3.

🛡️ High Wind Safety Limit

For safety, when wind speed exceeds 25 m/s, rotation speed must be limited to ≤ 20 RPM.

⚙️ Power Generation Requirements

Significant power generation (> 100 kW) requires sufficient wind speed (≥ 5 m/s).

Examples

Valid Example

{
  "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,
  "rotation_speed": 18,
  "pipeline_metadata": {
    "pipeline_version": "1.0.0",
    "pipeline_stage": "validated",
    "processing_timestamp": "2024-01-01T12:00:05Z",
    "git_sha": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0",
    "node_id": "node-001",
    "transformation_hash": "sha256_hash_here..."
  }
}

Invalid Example (violates business rule)

{
  "timestamp": "2024-01-01T12:00:00Z",
  "turbine_id": "WT-0001",
  "site_id": "SITE-TEX",
  "temperature": 25.5,
  "humidity": 65,
  "pressure": 1013.25,
  "wind_speed": 2.0,  // ❌ Too low for rotation
  "power_output": 100,
  "rotation_speed": 15  // ❌ Rotation without sufficient wind
}

Download & Integration

Get the schema for your validation pipeline

📄 View Raw JSON ⬇️ Download Schema

Direct URL for programmatic access:

https://aerolake.org/schemas/wind-turbine-v1.json