iec_61400-15-2_eya_def.schema.json

{
  "$defs": {
    "BasicStatistic": {
      "additionalProperties": false,
      "description": "Specification of a statistic that only requires type definition.",
      "properties": {
        "evaluation_period": {
          "anyOf": [
            {
              "exclusiveMinimum": 0,
              "type": "integer"
            },
            {
              "exclusiveMinimum": 0,
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional specification of the evaluation period in years, to be included when relevant to the context and statistic in question. This may for example define a 10-year evaluation period for the standard deviation of an uncertainty distribution or a certain probability of exceedance level.",
          "examples": [
            1.0,
            10.0
          ],
          "title": "Evaluation Period"
        },
        "statistic_type": {
          "description": "Specification of the type of statistic, using the standardised naming conventions.",
          "enum": [
            "sum",
            "mean",
            "median",
            "standard_deviation",
            "minimum",
            "maximum",
            "sample_count"
          ],
          "title": "Statistic Type",
          "type": "string"
        }
      },
      "required": [
        "statistic_type"
      ],
      "title": "BasicStatistic",
      "type": "object"
    },
    "Dataset": {
      "additionalProperties": false,
      "description": "Collection of labelled data for one specific quantity. The data is labelled by specifying dimensions and including coordinates along the dimensions for each data value.",
      "properties": {
        "comments": {
          "anyOf": [
            {
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional comments on the dataset, which should not be empty if the field is included.",
          "title": "Comments"
        },
        "description": {
          "anyOf": [
            {
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional description of the dataset, which should not be empty if the field is included.",
          "title": "Description"
        },
        "dimensions": {
          "anyOf": [
            {
              "items": {
                "description": "Dimension along which dataset values are assigned.",
                "enum": [
                  "minute",
                  "hour",
                  "day",
                  "month",
                  "year",
                  "start_date",
                  "end_date",
                  "start_datetime",
                  "end_datetime",
                  "wind_speed",
                  "wind_from_direction",
                  "wind_dataset_id",
                  "point_id",
                  "height",
                  "wind_farm_id",
                  "turbine_id",
                  "operational_dataset_id",
                  "variable_id"
                ],
                "title": "Dataset Dimension",
                "type": "string"
              },
              "minItems": 1,
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Dimensions along which the dataset is binned. All statistics within the same dataset object must have the same dimensions. The dimensions must correspond to and be listed in the same order as the coordinates for the values of all statistics. A dataset without dimensions can only have a single value for each statistic.",
          "examples": [
            [
              "turbine_id",
              "year"
            ],
            [
              "wind_dataset_id",
              "height"
            ]
          ],
          "title": "Dimensions"
        },
        "label": {
          "anyOf": [
            {
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional label of the dataset, which should not be empty if the field is included.",
          "examples": [
            "Seasonal distribution of net energy"
          ],
          "title": "Label"
        },
        "statistics": {
          "description": "List of dataset statistic objects that each include data values for a specific statistic type. For example, there may be two statistics, one for mean values and one for standard deviation values.",
          "items": {
            "additionalProperties": false,
            "description": "Dataset values for one specific statistic type.",
            "properties": {
              "comments": {
                "anyOf": [
                  {
                    "minLength": 1,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Optional comments on the dataset statistic, which should not be empty if the field is included.",
                "title": "Comments"
              },
              "description": {
                "anyOf": [
                  {
                    "minLength": 1,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Optional description of the dataset statistic, which should not be empty if the field is included.",
                "title": "Description"
              },
              "statistic": {
                "description": "Specification of the statistic that the element of the dataset corresponds to.",
                "discriminator": {
                  "mapping": {
                    "exceedance_level": "#/$defs/ExceedanceLevelStatistic",
                    "inter_annual_variability": "#/$defs/InterAnnualVariabilityStatistic",
                    "maximum": "#/$defs/BasicStatistic",
                    "mean": "#/$defs/BasicStatistic",
                    "median": "#/$defs/BasicStatistic",
                    "minimum": "#/$defs/BasicStatistic",
                    "sample_count": "#/$defs/BasicStatistic",
                    "standard_deviation": "#/$defs/BasicStatistic",
                    "sum": "#/$defs/BasicStatistic"
                  },
                  "propertyName": "statistic_type"
                },
                "oneOf": [
                  {
                    "$ref": "#/$defs/BasicStatistic"
                  },
                  {
                    "$ref": "#/$defs/InterAnnualVariabilityStatistic"
                  },
                  {
                    "$ref": "#/$defs/ExceedanceLevelStatistic"
                  }
                ],
                "title": "Statistic"
              },
              "values": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "items": {
                      "maxItems": 2,
                      "minItems": 2,
                      "prefixItems": [
                        {
                          "items": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "number"
                              },
                              {
                                "minLength": 1,
                                "type": "string"
                              }
                            ]
                          },
                          "type": "array"
                        },
                        {
                          "type": "number"
                        }
                      ],
                      "type": "array"
                    },
                    "minItems": 1,
                    "type": "array"
                  }
                ],
                "description": "Dataset value(s) as a single number or one or more values at coordinates. If more than one value is included the values must be represented together with coordinates. A single value can be included either with or without coordinates. The coordinates must correspond to and be listed the same order as the dimensions specified for the dataset.",
                "title": "Values"
              }
            },
            "required": [
              "statistic",
              "values"
            ],
            "title": "Dataset Statistic",
            "type": "object"
          },
          "minItems": 1,
          "title": "Statistics",
          "type": "array"
        }
      },
      "required": [
        "statistics"
      ],
      "title": "Dataset",
      "type": "object"
    },
    "DerivedDatasetClassification": {
      "additionalProperties": false,
      "description": "Classification of a derived operational dataset.",
      "properties": {
        "data_source_type": {
          "const": "secondary",
          "default": "secondary",
          "description": "The data source type, which for derived data is 'secondary'.",
          "title": "Data Source Type",
          "type": "string"
        },
        "data_type": {
          "const": "derived",
          "default": "derived",
          "description": "The type of operational data, categorised as 'derived' for all derived operational datasets (e.g. operational reports or databases with aggregate data). Details of the data type shall be included in the description of the operational dataset, including the type of derived dataset (e.g. an operational report), who produced it (e.g. the turbine OEM) and any relevant details known about how the data were processed.",
          "title": "Data Type",
          "type": "string"
        }
      },
      "title": "DerivedDatasetClassification",
      "type": "object"
    },
    "ExceedanceLevelStatistic": {
      "additionalProperties": false,
      "description": "Specification of a probability of exceedance level statistic.",
      "properties": {
        "evaluation_period": {
          "anyOf": [
            {
              "exclusiveMinimum": 0,
              "type": "integer"
            },
            {
              "exclusiveMinimum": 0,
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional specification of the evaluation period in years, to be included when relevant to the context and statistic in question. This may for example define a 10-year evaluation period for the standard deviation of an uncertainty distribution or a certain probability of exceedance level.",
          "examples": [
            1.0,
            10.0
          ],
          "title": "Evaluation Period"
        },
        "probability": {
          "description": "The dimensionless probability of exceedance level (i.e. probability value between 0.0 and 1.0) of the statistic.",
          "examples": [
            0.25,
            0.75,
            0.9,
            0.99
          ],
          "maximum": 1.0,
          "minimum": 0.0,
          "title": "Probability",
          "type": "number"
        },
        "statistic_type": {
          "const": "exceedance_level",
          "default": "exceedance_level",
          "description": "Specification of the type of statistic, using the standardised naming conventions. For an exceedance level statistic, the type must always be 'exceedance_level'.",
          "title": "Statistic Type",
          "type": "string"
        }
      },
      "required": [
        "probability"
      ],
      "title": "ExceedanceLevelStatistic",
      "type": "object"
    },
    "FirstPartyAssessmentComponentProvenance": {
      "additionalProperties": false,
      "description": "First party provenance of an EYA or WRA component. First party in this context means an organisation receiving and/or having commissioned the EYA report.",
      "properties": {
        "assessor_type": {
          "default": "receiving_organisation",
          "description": "Type of organisation that undertook the assessment of the EYA or WRA component, which must be one of the options 'issuing_organisation', 'receiving_organisation', 'commissioning_organisation' and 'other_organisation'. The value 'commissioning_organisation' should be used only when the commissioning organisation is not also a receiving organisation.",
          "enum": [
            "receiving_organisation",
            "commissioning_organisation"
          ],
          "title": "Assessor Type",
          "type": "string"
        },
        "is_verified_by_issuing_organisation": {
          "description": "Whether an assessment component provided by a receiving organisation, commissioning organisation or other organisation (e.g. independent third party) has been verified by the issuing organisation(s) of the EYA.",
          "title": "Is Verified By Issuing Organisation",
          "type": "boolean"
        }
      },
      "required": [
        "is_verified_by_issuing_organisation"
      ],
      "title": "FirstPartyAssessmentComponentProvenance",
      "type": "object"
    },
    "InterAnnualVariabilityStatistic": {
      "additionalProperties": false,
      "description": "Specification of an inter-annual variability statistic.",
      "properties": {
        "evaluation_period": {
          "const": 1,
          "default": 1,
          "description": "Specification of the evaluation period in years, which for inter-annual variability must always be 1 (it is by definition the variability of a one-year period relative to the full time period).",
          "title": "Evaluation Period",
          "type": "integer"
        },
        "statistic_type": {
          "const": "inter_annual_variability",
          "default": "inter_annual_variability",
          "description": "Specification of the type of statistic, using the standardised naming conventions. For a standard deviation statistic, the type must always be 'standard_deviation'.",
          "title": "Statistic Type",
          "type": "string"
        }
      },
      "title": "InterAnnualVariabilityStatistic",
      "type": "object"
    },
    "IssuingOrganisationAssessmentComponentProvenance": {
      "additionalProperties": false,
      "description": "Provenance of a component assessed by the issuing organisation.",
      "properties": {
        "assessor_type": {
          "const": "issuing_organisation",
          "default": "issuing_organisation",
          "description": "Type of organisation that undertook the assessment of the EYA or WRA component, which must be one of the options 'issuing_organisation', 'receiving_organisation', 'commissioning_organisation' and 'other_organisation'. The value 'issuing_organisation' means that the component has been assessed by the organisation(s) having undertaken and issued the EYA.",
          "title": "Assessor Type",
          "type": "string"
        }
      },
      "title": "IssuingOrganisationAssessmentComponentProvenance",
      "type": "object"
    },
    "OperationalRestriction": {
      "additionalProperties": false,
      "description": "Specifications of a restriction that limits power output. In the current draft of the schema, 'label', 'description' and 'comments' fields are available to describe the restriction with free text. This is intended to be expanded into a more comprehensive data model.",
      "properties": {
        "comments": {
          "anyOf": [
            {
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional comments on the operational restriction, which should not be empty if the field is included.",
          "title": "Comments"
        },
        "description": {
          "description": "Description of the operational restriction.",
          "minLength": 1,
          "title": "Description",
          "type": "string"
        },
        "end_datetime": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional operational restriction end datetime in the ISO 8601 standard format with the 'T' required between the calendar date and time, i.e. YYYY-MM-DDThh:mm:ss. In cases where the time is not relevant (i.e. only the date is relevant), hours, minutes and seconds shall all be set to zero. If using the time part, the timezone of the data must be consistent with the UTC offset specified for the EYA DEF document.",
          "examples": [
            "2024-12-24T23:15:00",
            "2024-12-31T00:00:00"
          ],
          "title": "End Datetime"
        },
        "label": {
          "description": "Short label to indicate the type of operational restriction.",
          "examples": [
            "WSM curtailment",
            "MEC curtailment"
          ],
          "minLength": 1,
          "title": "Label",
          "type": "string"
        },
        "start_datetime": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional operational restriction start datetime in the ISO 8601 standard format with the 'T' required between the calendar date and time, i.e. YYYY-MM-DDThh:mm:ss. In cases where the time is not relevant (i.e. only the date is relevant), hours, minutes and seconds shall all be set to zero. If using the time part, the timezone of the data must be consistent with the UTC offset specified for the EYA DEF document.",
          "examples": [
            "2023-11-24T05:02:00",
            "2023-11-01T00:00:00"
          ],
          "title": "Start Datetime"
        }
      },
      "required": [
        "label",
        "description"
      ],
      "title": "OperationalRestriction",
      "type": "object"
    },
    "Organisation": {
      "additionalProperties": false,
      "description": "Basic metadata to describe an organisation. This model is for example used for issuing and receiving organisations of an energy yield assessment.",
      "properties": {
        "abbreviation": {
          "anyOf": [
            {
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Abbreviated name of the organisation.",
          "examples": [
            "Torre Egger",
            "Miranda"
          ],
          "title": "Abbreviation"
        },
        "address": {
          "anyOf": [
            {
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Address of the organisation.",
          "examples": [
            "5 Munro Road, Summit Centre, Sgurrsville, G12 0YE, UK"
          ],
          "title": "Address"
        },
        "contact_name": {
          "anyOf": [
            {
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Name(s) of contact person(s) in the organisation.",
          "examples": [
            "Luis Bunuel",
            "Miles Davis, John Coltrane"
          ],
          "title": "Contact Name"
        },
        "name": {
          "description": "Entity name of the organisation.",
          "examples": [
            "The Torre Egger Consultants Limited",
            "Miranda Investments Limited"
          ],
          "minLength": 1,
          "title": "Name",
          "type": "string"
        }
      },
      "required": [
        "name"
      ],
      "title": "Organisation",
      "type": "object"
    },
    "OtherOrganisationAssessmentComponentProvenance": {
      "additionalProperties": false,
      "description": "Provenance of a component assessed by another organisation.",
      "properties": {
        "assessor_organisations": {
          "description": "Specification of the other (third party) organisation(s) that undertook the assessment of the component.",
          "items": {
            "$ref": "#/$defs/Organisation"
          },
          "minItems": 1,
          "title": "Assessor Organisations",
          "type": "array"
        },
        "assessor_type": {
          "const": "other_organisation",
          "default": "other_organisation",
          "description": "Type of organisation that undertook the assessment of the EYA or WRA component, which must be one of the options 'issuing_organisation', 'receiving_organisation', 'commissioning_organisation' and 'other_organisation'. The value 'other_organisation' should be used for independent third parties or any other organisation that has not issued, received or commissioned the EYA.",
          "title": "Assessor Type",
          "type": "string"
        },
        "is_verified_by_issuing_organisation": {
          "description": "Whether an assessment component provided by a receiving organisation, commissioning organisation or other organisation (e.g. independent third party) has been verified by the issuing organisation(s) of the EYA.",
          "title": "Is Verified By Issuing Organisation",
          "type": "boolean"
        }
      },
      "required": [
        "assessor_organisations",
        "is_verified_by_issuing_organisation"
      ],
      "title": "OtherOrganisationAssessmentComponentProvenance",
      "type": "object"
    },
    "PlantPerformanceResults": {
      "additionalProperties": false,
      "description": "Plant performance loss assessment results.",
      "properties": {
        "efficiency": {
          "description": "Dimensionless plant performance efficiency (loss factor) results. The first standard dataset should have no binning dimension (i.e. correspond to the overall value for the wind farm(s) under assessment). Datasets with results binned by turbine should also be included where the efficiency is predicted at the turbine level, such as for the turbine interaction losses. Further results with other dimensions may also be included. All datasets should include the 'mean' and 'standard_deviation', statistics, where the former represents the central estimate and the latter the standard deviation of the associated uncertainty distribution. For the overall plant performance efficiency estimate at the wind farm level (i.e. the result dataset without binning), the statistic 'inter_annual_variability' must also be included. The inter-annual variability may optionally also be included for some or all of the other datasets.",
          "items": {
            "$ref": "#/$defs/Dataset"
          },
          "minItems": 1,
          "title": "Efficiency",
          "type": "array"
        }
      },
      "required": [
        "efficiency"
      ],
      "title": "PlantPerformanceResults",
      "type": "object"
    },
    "SingleSourceDatasetClassification": {
      "additionalProperties": false,
      "description": "Classification of an operational dataset from a single source.",
      "properties": {
        "data_source_type": {
          "description": "The type of the operational data source. Primary data, such as primary SCADA data, comes directly from the source without any intermediary. Secondary data covers all other types of data sources, where the data does not come directly from the source, such as secondary SCADA data provided in harmonised form by a data management service provider.",
          "enum": [
            "primary",
            "secondary"
          ],
          "title": "Operational Data Source Type",
          "type": "string"
        },
        "data_type": {
          "description": "The type of operational data, categorised as 'scada' for data from a Supervisory Control and Data Acquisition (SCADA) system, 'metered' for data from a production meter and 'environmental_measurement' for data from an (on-site) environmental measurement station such as a meteorological mast or a remote sensing device (RSD).",
          "enum": [
            "scada",
            "metered",
            "environmental_measurement"
          ],
          "title": "Data Type",
          "type": "string"
        }
      },
      "required": [
        "data_type",
        "data_source_type"
      ],
      "title": "SingleSourceDatasetClassification",
      "type": "object"
    },
    "TimeResolution": {
      "additionalProperties": false,
      "description": "Resolution of time series data.",
      "properties": {
        "unit": {
          "description": "The measurement unit of time in which the time resolution is specified.",
          "enum": [
            "year",
            "month",
            "day",
            "hour",
            "minute",
            "second"
          ],
          "title": "Time Measurement Unit",
          "type": "string"
        },
        "value": {
          "description": "The value of the time resolution in the specified unit. For example, for 10-minute resolution, the value is '10.0' and the unit is 'minute'",
          "examples": [
            0.5,
            1.0,
            10.0
          ],
          "title": "Value",
          "type": "number"
        }
      },
      "required": [
        "value",
        "unit"
      ],
      "title": "TimeResolution",
      "type": "object"
    },
    "TimeVariabilityType": {
      "description": "Type of time variability considered for an assessment element.",
      "enum": [
        "static",
        "variable"
      ],
      "title": "TimeVariabilityType",
      "type": "string"
    },
    "WindUncertaintyResults": {
      "additionalProperties": false,
      "description": "Wind uncertainty assessment results.",
      "properties": {
        "relative_energy_uncertainty": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/Dataset"
              },
              "minItems": 1,
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Uncertainty assessment results as dimensionless relative values expressed in terms of net annual energy production (AEP) and calculated as the standard deviation of the energy uncertainty distribution divided by the net P50 (50% probability of exceedance level) AEP. The first standard dataset should present results without binning (i.e. correspond to the overall value for the wind farm under assessment). Datasets with other binning dimensions may also be included optionally.",
          "title": "Relative Energy Uncertainty"
        },
        "relative_wind_speed_uncertainty": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/Dataset"
              },
              "minItems": 1,
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Uncertainty assessment results as dimensionless relative values expressed in terms of wind speed and calculated as the standard deviation of the wind speed uncertainty distribution divided by the mean wind speed. The first standard dataset should present results without binning (i.e. correspond to the overall value for the wind farm under assessment). For wind uncertainty components related to a wind dataset (e.g. measurement uncertainty), a second standard dataset should present results with binning dimension 'wind_dataset_id'. Datasets with other binning dimensions may also be included optionally.",
          "title": "Relative Wind Speed Uncertainty"
        }
      },
      "title": "WindUncertaintyResults",
      "type": "object"
    }
  },
  "$id": "https://raw.githubusercontent.com/IEC-61400-15/eya_def/refs/heads/main/json_schema/iec_61400-15-2_eya_def.schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$version": "0.0.1",
  "additionalProperties": true,
  "description": "IEC 61400-15-2 EYA DEF top-level data model.",
  "properties": {
    "$schema": {
      "default": "https://raw.githubusercontent.com/IEC-61400-15/eya_def/refs/heads/main/json_schema/iec_61400-15-2_eya_def.schema.json",
      "description": "URI of the EYA DEF JSON Schema, which should have the field name '$schema' in the JSON document. It is assumed to be the latest published version if not included.",
      "examples": [
        "https://raw.githubusercontent.com/IEC-61400-15/eya_def/refs/heads/main/json_schema/iec_61400-15-2_eya_def.schema.json"
      ],
      "format": "uri",
      "minLength": 1,
      "title": "EYA DEF JSON Schema URI",
      "type": "string"
    },
    "comments": {
      "anyOf": [
        {
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional comments on the energy yield assessment (EYA) report, which should not be empty if the field is included.",
      "examples": [
        "Report labelled as draft. To be finalised following review by all parties."
      ],
      "title": "Comments"
    },
    "commissioning_organisations": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/Organisation"
          },
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional specification of the organisation(s) having commissioned the report, if relevant. This is to be included only if not identical to the receiving  organisation(s). Whenever receiving organisation(s) are specified and commissioning organisation(s) are not, is shall be assumed they are the same. As an example, the commissioning organisation could be a project developer and the receiving organisation a financing bank.",
      "title": "Commissioning Organisations"
    },
    "confidentiality_classification": {
      "anyOf": [
        {
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional confidentiality classification of the report document, if relevant. The field should not be empty if it is included.",
      "examples": [
        "Strictly confidential",
        "Commercial in confidence",
        "Public"
      ],
      "title": "Confidentiality Classification"
    },
    "contract_reference": {
      "anyOf": [
        {
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional reference to contract between the issuing and receiving organisations that governs the energy yield assessment (EYA) report document, if relevant. The field should not be empty if it is included.",
      "examples": [
        "Contract ID.: P-MIR-00239432-0001-C, dated 2022-11-30"
      ],
      "title": "Contract Reference"
    },
    "contributors": {
      "description": "List of report contributors (e.g. author and verifier)",
      "items": {
        "additionalProperties": false,
        "description": "Contributor to an energy yield assessment.",
        "properties": {
          "completion_date": {
            "anyOf": [
              {
                "format": "date",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional contribution completion date (format YYYY-MM-DD).",
            "examples": [
              "2022-10-04"
            ],
            "title": "Completion Date"
          },
          "contribution_comments": {
            "anyOf": [
              {
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional comments to clarify contribution, which should not be empty if the field is included.",
            "examples": [
              "Second author"
            ],
            "title": "Contribution Comments"
          },
          "contributor_type": {
            "description": "Type of contributor.",
            "enum": [
              "author",
              "verifier",
              "approver",
              "other"
            ],
            "title": "Report Contributor Type",
            "type": "string"
          },
          "email_address": {
            "anyOf": [
              {
                "format": "email",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional email address of the contributor, which should not be empty if the field is included.",
            "examples": [
              "j.miro@art.cat",
              "andrei.tarkovsky@cinema.com"
            ],
            "title": "Email Address"
          },
          "name": {
            "description": "Name of the contributor.",
            "examples": [
              "Joan Miro",
              "Andrei Tarkovsky"
            ],
            "minLength": 1,
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "name",
          "contributor_type"
        ],
        "title": "Report Contributor",
        "type": "object"
      },
      "minItems": 1,
      "title": "Contributors",
      "type": "array"
    },
    "description": {
      "anyOf": [
        {
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional description of the energy yield assessment (EYA) report, which should not be empty if the field is included.",
      "examples": [
        "An updated document to incorporate the latest measurement data."
      ],
      "title": "Description"
    },
    "document_id": {
      "anyOf": [
        {
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional ID of the report document; not including the version when 'document_version' is used. This will typically follow the convention of the document management system of the issuing organisation(s). The field should not be empty if it is included.",
      "examples": [
        "C385945/A/UK/R/002",
        "0345.923454.0001"
      ],
      "title": "Document ID"
    },
    "document_version": {
      "anyOf": [
        {
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional version of the report document, also known as revision. As with the 'document_id', this will typically follow the document versioning convention of the document management system of the issuing organisation(s). The field should not be empty if it is included.",
      "examples": [
        "1.2.3",
        "A",
        "Rev. A"
      ],
      "title": "Document Version"
    },
    "epsg_srid": {
      "description": "EPSG Spatial Reference System Identifier (SRID) for the Coordinate Reference System (CRS) used for all spatial data (e.g. turbine locations) in the EYA DEF document. All location coordinates must be reported in this one CRS, which must have an EPSG code. If different CRSs are used, the data must be converted to be consistent with the EPSG code specified here.",
      "examples": [
        27700,
        3006
      ],
      "title": "Epsg Srid",
      "type": "integer"
    },
    "issue_date": {
      "description": "Report issue date in the ISO 8601 standard format for a calendar date, i.e. YYYY-MM-DD.",
      "examples": [
        "2022-10-05"
      ],
      "format": "date",
      "title": "Issue Date",
      "type": "string"
    },
    "issuing_organisations": {
      "description": "The organisation(s) issuing the report (e.g. consultant).",
      "items": {
        "$ref": "#/$defs/Organisation"
      },
      "minItems": 1,
      "title": "Issuing Organisations",
      "type": "array"
    },
    "measurement_stations": {
      "anyOf": [
        {
          "items": {
            "allOf": [
              {
                "$ref": "https://raw.githubusercontent.com/IEA-Task-43/digital_wra_data_standard/master/schema/iea43_wra_data_model.schema.json"
              }
            ],
            "description": "A wind dataset metadata document according to the IEA Wind Task 43 WRA Data Model JSON Schema.",
            "examples": [
              "https://raw.githubusercontent.com/IEA-Task-43/digital_wra_data_standard/master/demo_data/iea43_wra_data_model.json"
            ],
            "title": "Wind Dataset Metadata"
          },
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional list of measurement station metadata documents according to the IEA Wind Task 43 WRA Data Model, including all measurement stations relevant to the EYA, if any. It is recommended that one metadata document be completed for each measurement station, although the WRA Data Model allows for grouping multiple measurement stations into a single document.",
      "title": "Measurement Stations"
    },
    "power_curves": {
      "description": "List of documents specifying power curves and associated information according to the IEC 61400-16 Power Curve Schema, covering all relevant turbine models.",
      "items": {
        "allOf": [
          {
            "$ref": "https://raw.githubusercontent.com/octue/power-curve-schema/main/power-curve-schema/schema.json"
          }
        ],
        "description": "A document specifying power curves and associated information for a turbine model according to the IEC 61400-16 Power Curve Schema.",
        "examples": [
          "https://raw.githubusercontent.com/octue/power-curve-schema/main/power-curve-schema/examples/generic-274-20.json"
        ],
        "title": "Power Curve Document"
      },
      "minItems": 1,
      "title": "Power Curves",
      "type": "array"
    },
    "project_country": {
      "description": "The ISO 3166-1 alpha-2 two-letter code of the country where the project under assessment is located.",
      "enum": [
        "AW",
        "AF",
        "AO",
        "AI",
        "AX",
        "AL",
        "AD",
        "AE",
        "AR",
        "AM",
        "AS",
        "AQ",
        "TF",
        "AG",
        "AU",
        "AT",
        "AZ",
        "BI",
        "BE",
        "BJ",
        "BQ",
        "BF",
        "BD",
        "BG",
        "BH",
        "BS",
        "BA",
        "BL",
        "BY",
        "BZ",
        "BM",
        "BO",
        "BR",
        "BB",
        "BN",
        "BT",
        "BV",
        "BW",
        "CF",
        "CA",
        "CC",
        "CH",
        "CL",
        "CN",
        "CI",
        "CM",
        "CD",
        "CG",
        "CK",
        "CO",
        "KM",
        "CV",
        "CR",
        "CU",
        "CW",
        "CX",
        "KY",
        "CY",
        "CZ",
        "DE",
        "DJ",
        "DM",
        "DK",
        "DO",
        "DZ",
        "EC",
        "EG",
        "ER",
        "EH",
        "ES",
        "EE",
        "ET",
        "FI",
        "FJ",
        "FK",
        "FR",
        "FO",
        "FM",
        "GA",
        "GB",
        "GE",
        "GG",
        "GH",
        "GI",
        "GN",
        "GP",
        "GM",
        "GW",
        "GQ",
        "GR",
        "GD",
        "GL",
        "GT",
        "GF",
        "GU",
        "GY",
        "HK",
        "HM",
        "HN",
        "HR",
        "HT",
        "HU",
        "ID",
        "IM",
        "IN",
        "IO",
        "IE",
        "IR",
        "IQ",
        "IS",
        "IL",
        "IT",
        "JM",
        "JE",
        "JO",
        "JP",
        "KZ",
        "KE",
        "KG",
        "KH",
        "KI",
        "KN",
        "KR",
        "KW",
        "LA",
        "LB",
        "LR",
        "LY",
        "LC",
        "LI",
        "LK",
        "LS",
        "LT",
        "LU",
        "LV",
        "MO",
        "MF",
        "MA",
        "MC",
        "MD",
        "MG",
        "MV",
        "MX",
        "MH",
        "MK",
        "ML",
        "MT",
        "MM",
        "ME",
        "MN",
        "MP",
        "MZ",
        "MR",
        "MS",
        "MQ",
        "MU",
        "MW",
        "MY",
        "YT",
        "NA",
        "NC",
        "NE",
        "NF",
        "NG",
        "NI",
        "NU",
        "NL",
        "NO",
        "NP",
        "NR",
        "NZ",
        "OM",
        "PK",
        "PA",
        "PN",
        "PE",
        "PH",
        "PW",
        "PG",
        "PL",
        "PR",
        "KP",
        "PT",
        "PY",
        "PS",
        "PF",
        "QA",
        "RE",
        "RO",
        "RU",
        "RW",
        "SA",
        "SD",
        "SN",
        "SG",
        "GS",
        "SH",
        "SJ",
        "SB",
        "SL",
        "SV",
        "SM",
        "SO",
        "PM",
        "RS",
        "SS",
        "ST",
        "SR",
        "SK",
        "SI",
        "SE",
        "SZ",
        "SX",
        "SC",
        "SY",
        "TC",
        "TD",
        "TG",
        "TH",
        "TJ",
        "TK",
        "TM",
        "TL",
        "TO",
        "TT",
        "TN",
        "TR",
        "TV",
        "TW",
        "TZ",
        "UG",
        "UA",
        "UM",
        "UY",
        "US",
        "UZ",
        "VA",
        "VC",
        "VE",
        "VG",
        "VI",
        "VN",
        "VU",
        "WF",
        "WS",
        "YE",
        "ZA",
        "ZM",
        "ZW"
      ],
      "title": "Alpha2 Country Code",
      "type": "string"
    },
    "project_name": {
      "description": "Name of the project under assessment.",
      "examples": [
        "Barefoot Wind Farm"
      ],
      "minLength": 1,
      "title": "Project Name",
      "type": "string"
    },
    "receiving_organisations": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/Organisation"
          },
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional specification of the organisation(s) receiving the report (e.g. client), if relevant.",
      "title": "Receiving Organisations"
    },
    "reference_meteorological_datasets": {
      "anyOf": [
        {
          "items": {
            "allOf": [
              {
                "$ref": "https://raw.githubusercontent.com/IEA-Task-43/digital_wra_data_standard/master/schema/iea43_wra_data_model.schema.json"
              }
            ],
            "description": "A wind dataset metadata document according to the IEA Wind Task 43 WRA Data Model JSON Schema.",
            "examples": [
              "https://raw.githubusercontent.com/IEA-Task-43/digital_wra_data_standard/master/demo_data/iea43_wra_data_model.json"
            ],
            "title": "Wind Dataset Metadata"
          },
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional list of metadata documents that describe the reference meteorological datasets used in the long-term prediction process of the EYA and/or used as input wind resource data for calibration against reference operational data. Reference datasets may include ground-based meteorological (met) stations, reanalysis datasets and mesoscale model datasets. The IEA Wind Task 43 WRA Data Model schema shall be used. One metadata document shall be completed for each relevant reference meteorological dataset.",
      "title": "Reference Meteorological Datasets"
    },
    "reference_wind_farms": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": false,
            "description": "Reference wind farm.",
            "properties": {
              "comments": {
                "anyOf": [
                  {
                    "minLength": 1,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Optional comments on the reference wind farm, which should not be empty if the field is included.",
                "title": "Comments"
              },
              "description": {
                "anyOf": [
                  {
                    "minLength": 1,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Optional description of the reference wind farm, which should not be empty if the field is included.",
                "title": "Description"
              },
              "operational_datasets": {
                "description": "List of metadata documents describing the operational datasets from the reference wind farm that were used.",
                "items": {
                  "additionalProperties": false,
                  "description": "Metadata for a reference wind farm operational dataset.",
                  "properties": {
                    "classification": {
                      "description": "Classification of the type of data and the type of data source. Separate schemas are available to classify unprocessed datasets from a single source, including classification of the data type and source, and datasets that have been derived (aggregated and/or processed, such as operational reports and national databases), including only a classification of the data type as 'derived'. For single source data types (e.g. SCADA) it is meaningful to distinguish between primary and secondary source types, whereas for a derived data type the source type is always secondary.",
                      "discriminator": {
                        "mapping": {
                          "derived": "#/$defs/DerivedDatasetClassification",
                          "environmental_measurement": "#/$defs/SingleSourceDatasetClassification",
                          "metered": "#/$defs/SingleSourceDatasetClassification",
                          "scada": "#/$defs/SingleSourceDatasetClassification"
                        },
                        "propertyName": "data_type"
                      },
                      "oneOf": [
                        {
                          "$ref": "#/$defs/SingleSourceDatasetClassification"
                        },
                        {
                          "$ref": "#/$defs/DerivedDatasetClassification"
                        }
                      ],
                      "title": "Classification"
                    },
                    "comments": {
                      "anyOf": [
                        {
                          "minLength": 1,
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "default": null,
                      "description": "Optional comments on the dataset, which should not be empty if the field is included.",
                      "title": "Comments"
                    },
                    "data_variables": {
                      "description": "A list of the data variables included in the dataset and used in the assessment. For a large dataset (such as a full wind turbine SCADA dataset) this field should not include all the variables but only the ones that were used in the analysis.",
                      "items": {
                        "additionalProperties": false,
                        "description": "Reference wind farm operational data variable.",
                        "properties": {
                          "comments": {
                            "anyOf": [
                              {
                                "minLength": 1,
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "default": null,
                            "description": "Optional comments on the data variable, which should not be empty if the field is included.",
                            "title": "Comments"
                          },
                          "data_level": {
                            "description": "Whether the operational data variable is provided for each individual wind turbine ('turbine_level'), is corresponding to or aggregated to the wind farm level ('wind_farm_level') or corresponds to a different ('other') level such as an environmental measurement station.",
                            "enum": [
                              "turbine_level",
                              "wind_farm_level",
                              "other"
                            ],
                            "title": "Operational Data Level",
                            "type": "string"
                          },
                          "description": {
                            "anyOf": [
                              {
                                "minLength": 1,
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "default": null,
                            "description": "Optional description of the data variable, which should not be empty if the field is included. This may include clarification of the point of measurement, where relevant.",
                            "title": "Description"
                          },
                          "label": {
                            "anyOf": [
                              {
                                "minLength": 1,
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "default": null,
                            "description": "Optional label of the data variable, which should not be empty if the field is included. This can be used to provide the label assigned to the variable in the dataset (e.g. field of column name), but does not need to.",
                            "examples": [
                              "Bld1PitchAngle"
                            ],
                            "title": "Label"
                          },
                          "statistic_types": {
                            "anyOf": [
                              {
                                "items": {
                                  "description": "Type of statistic using standardised label.",
                                  "enum": [
                                    "sum",
                                    "mean",
                                    "median",
                                    "standard_deviation",
                                    "minimum",
                                    "maximum",
                                    "sample_count",
                                    "inter_annual_variability",
                                    "exceedance_level"
                                  ],
                                  "title": "Statistic Type",
                                  "type": "string"
                                },
                                "minItems": 1,
                                "type": "array"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Optional list of the types of statistics included for the data variable.",
                            "title": "Statistic Types"
                          },
                          "time_resolution": {
                            "anyOf": [
                              {
                                "$ref": "#/$defs/TimeResolution"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "default": null,
                            "description": "Optional specification of the time resolution for the variable, in case that is different from the dataset main time resolution."
                          },
                          "variable_type": {
                            "description": "The type of operational data variable, selected from the standardised terms based on the ASPECT taxonomy.",
                            "enum": [
                              "active_power",
                              "air_pressure",
                              "air_temperature",
                              "apparent_power",
                              "pitch_angle",
                              "rain_status",
                              "rainfall_amount",
                              "rainfall_rate",
                              "reactive_power",
                              "relative_humidity",
                              "rotor_speed",
                              "rotor_status",
                              "wind_from_direction",
                              "wind_speed",
                              "yaw_angle",
                              "alarm_status",
                              "event_status",
                              "power_limitation",
                              "energy_output",
                              "availability",
                              "production_loss",
                              "data_availability"
                            ],
                            "examples": [
                              "active_power",
                              "wind_speed"
                            ],
                            "minLength": 1,
                            "title": "Operational Data Variable Type",
                            "type": "string"
                          }
                        },
                        "required": [
                          "variable_type",
                          "data_level",
                          "statistic_types"
                        ],
                        "title": "Operational Data Variable",
                        "type": "object"
                      },
                      "minItems": 1,
                      "title": "Data Variables",
                      "type": "array"
                    },
                    "description": {
                      "anyOf": [
                        {
                          "minLength": 1,
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "default": null,
                      "description": "Optional description of the dataset, which should not be empty if the field is included.",
                      "title": "Description"
                    },
                    "end_date": {
                      "description": "End of the data period in the ISO 8601 standard format for a calendar date, i.e. YYYY-MM-DD.",
                      "examples": [
                        "2021-11-30"
                      ],
                      "format": "date",
                      "title": "End Date",
                      "type": "string"
                    },
                    "id": {
                      "description": "Unique ID of the reference operational wind farm dataset",
                      "examples": [
                        "305f27e4-d51e-44dc-a1b1-e54feea36e17",
                        "PharaohWindFarmPhIV_OEM_op_reports"
                      ],
                      "minLength": 1,
                      "title": "Id",
                      "type": "string"
                    },
                    "integrity_verification": {
                      "anyOf": [
                        {
                          "minLength": 1,
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "default": null,
                      "description": "Optional description of how the integrity of the data has been and/or can be verified. This field should not be empty if it is included. If any measures were undertaken to verify data integrity, they should always be described here. When this field is omitted, it shall be interpreted to mean that data integrity verification was not undertaken and/or not possible.",
                      "title": "Integrity Verification"
                    },
                    "label": {
                      "anyOf": [
                        {
                          "minLength": 1,
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Optional label of the reference wind farm dataset, which should not be empty if the field is included.",
                      "examples": [
                        "OEM operational reports"
                      ],
                      "title": "Label"
                    },
                    "start_date": {
                      "description": "Start of the data period in the ISO 8601 standard format for a calendar date, i.e. YYYY-MM-DD.",
                      "examples": [
                        "2015-10-20"
                      ],
                      "format": "date",
                      "title": "Start Date",
                      "type": "string"
                    },
                    "supplying_organisation": {
                      "$ref": "#/$defs/Organisation",
                      "description": "The organisation that supplied the data."
                    },
                    "time_resolution": {
                      "anyOf": [
                        {
                          "$ref": "#/$defs/TimeResolution"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "default": null,
                      "description": "The main time resolution of the operational data, if relevant. For example, a SCADA dataset with all main variables at 10-minute resolution should have the time resolution specified as such, even when some variables (e.g. alarm status) do not have a meaningful time resolution. The time resolution can also be specified at the variable level, in case of deviations from the dataset main resolution."
                    }
                  },
                  "required": [
                    "id",
                    "label",
                    "classification",
                    "supplying_organisation",
                    "start_date",
                    "end_date",
                    "data_variables"
                  ],
                  "title": "Operational Dataset Metadata",
                  "type": "object"
                },
                "minItems": 1,
                "title": "Operational Datasets",
                "type": "array"
              },
              "wind_farm_id": {
                "description": "The ID of the wind farm that was used as reference, which must match the ID value in the 'wind_farms' section of the top-level of the EYA DEF document.",
                "examples": [
                  "fe1dba61-d6d6-45ef-beb4-ff569660fb14",
                  "PharaohWindFarmPhIV"
                ],
                "minLength": 1,
                "title": "Wind Farm Id",
                "type": "string"
              }
            },
            "required": [
              "wind_farm_id",
              "operational_datasets"
            ],
            "title": "Reference Wind Farm",
            "type": "object"
          },
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional list of metadata documents for the reference operational wind farms relevant to the EYA, if any. One metadata document shall be completed for each relevant reference operational wind farm.",
      "title": "Reference Wind Farms"
    },
    "scenarios": {
      "description": "List of energy yield assessment scenarios.",
      "items": {
        "additionalProperties": false,
        "description": "Single unique energy yield assessment scenario.",
        "properties": {
          "comments": {
            "anyOf": [
              {
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional comments on the scenario, which should not be empty if the field is included.",
            "title": "Comments"
          },
          "description": {
            "anyOf": [
              {
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional description of the scenario, which should not be empty if the field is included.",
            "title": "Description"
          },
          "energy_assessment": {
            "additionalProperties": false,
            "description": "Energy assessment details and results, including gross energy, plant performance, net energy and uncertainties.",
            "properties": {
              "gross_energy_assessment": {
                "additionalProperties": false,
                "description": "Details and results for the assessment of gross energy yield.",
                "properties": {
                  "comments": {
                    "anyOf": [
                      {
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Optional comments on the gross energy assessment, which should not be empty if the field is included.",
                    "title": "Comments"
                  },
                  "description": {
                    "anyOf": [
                      {
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Optional description of the gross energy assessment, which should not be empty if the field is included.",
                    "title": "Description"
                  },
                  "results": {
                    "additionalProperties": false,
                    "description": "Gross energy yield assessment (EYA) predictions, covering the central (P50) gross annual energy production (AEP) estimate at the wind farm and turbine levels.",
                    "properties": {
                      "annual_energy_production": {
                        "description": "Gross annual energy production (AEP) estimates in gigawatt hour per annum (GW h year-1). The first standard dataset should have no binning dimension (i.e. correspond to the overall value for the wind farm(s) under assessment). The dimension of the second standard result dataset should be 'turbine_id'. Only the P50 (median) statistics are required. Further results with other dimensions may be included optionally.",
                        "items": {
                          "$ref": "#/$defs/Dataset"
                        },
                        "minItems": 1,
                        "title": "Gross Annual Energy Production",
                        "type": "array"
                      },
                      "capacity_factor": {
                        "anyOf": [
                          {
                            "items": {
                              "$ref": "#/$defs/Dataset"
                            },
                            "minItems": 1,
                            "type": "array"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "description": "Optional gross capacity factor estimates as dimensionless values, calculated by dividing the corresponding gross annual energy production (AEP) estimates by the energy that would have been produced through constant output at full installed (nameplate) capacity. If the gross capacity factor estimates are specified here, it is recommended to include the same binning dimensions and statistics as for the gross AEP estimates. If not specified, the gross capacity factor estimates can be derived from the gross AEP estimates together with the relevant installed capacity values.",
                        "title": "Gross Capacity Factor"
                      },
                      "energy_production": {
                        "anyOf": [
                          {
                            "items": {
                              "$ref": "#/$defs/Dataset"
                            },
                            "minItems": 1,
                            "type": "array"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "description": "Optional gross energy production estimates over a specific period of time in gigawatt hour (GW h). This field should be used for energy production estimates that are not annualised. For all annual energy production (AEP) estimates, the field 'annual_energy_production' should be used. The time period that values correspond to should be made clear (e.g. in description and/or comments fields) if not obvious from the binning dimension(s).",
                        "title": "Gross Energy Production"
                      }
                    },
                    "required": [
                      "annual_energy_production"
                    ],
                    "title": "Gross Energy Assessment Results",
                    "type": "object"
                  }
                },
                "required": [
                  "results"
                ],
                "title": "Gross Energy Assessment",
                "type": "object"
              },
              "net_energy_assessment": {
                "additionalProperties": false,
                "description": "Details and results for the assessment of net energy yield.",
                "properties": {
                  "comments": {
                    "anyOf": [
                      {
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Optional comments on the net energy assessment, which should not be empty if the field is included.",
                    "title": "Comments"
                  },
                  "description": {
                    "anyOf": [
                      {
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Optional description of the net energy assessment, which should not be empty if the field is included.",
                    "title": "Description"
                  },
                  "results": {
                    "additionalProperties": false,
                    "description": "Net energy yield assessment (EYA) predictions, including central (P50) estimates, overall uncertainty standard deviation values, results at various confidence levels, and production profiles describing for example seasonal and diurnal variations.",
                    "properties": {
                      "annual_energy_production": {
                        "description": "Net annual energy production (AEP) estimates in gigawatt hour per annum (GW h year-1). The first standard dataset should have no binning dimension (i.e. correspond to the overall value for the wind farm(s) under assessment) and should include as a minimum the P50 (median) value, the standard deviation value, the P75 value and the P90 value for the full assessment period, for any one year during the first ten years of operation and for the first ten years of operation. The dimension of the second standard result dataset should be 'turbine_id' and should as a minimum include the assessment period P50 (median) value for each individual turbine. Further results with other dimensions may be included optionally.",
                        "items": {
                          "$ref": "#/$defs/Dataset"
                        },
                        "minItems": 1,
                        "title": "Net Annual Energy Production",
                        "type": "array"
                      },
                      "capacity_factor": {
                        "anyOf": [
                          {
                            "items": {
                              "$ref": "#/$defs/Dataset"
                            },
                            "minItems": 1,
                            "type": "array"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "description": "Optional net capacity factor estimates as dimensionless values, calculated by dividing the corresponding net annual energy production (AEP) estimates by the energy that would have been produced through constant output at full installed (nameplate) capacity. If the net capacity factor estimates are specified here, it is recommended to include the same binning dimensions and statistics as for the net AEP estimates. If not specified, the net capacity factor estimates can be derived from the net AEP estimates together with the relevant installed capacity values. Note that, whilst the capacity factor may be a useful indicator for the purpose of high level comparisons, it does not necessarily provide a clear and unambiguous view. For example, the capacity factor may have an upward bias due to an understated turbine nameplate capacity. A detailed and comprehensive comparison cannot rely on the capacity factor alone.",
                        "title": "Net Capacity Factor"
                      },
                      "energy_production": {
                        "description": "Net energy production estimates over a specific period of time in gigawatt hour (GW h). This field should be used for energy production estimates that are not annualised. For all net annual energy production (AEP) estimates, the field 'annual_energy_production' should be used. The time period that values correspond to should be made clear (e.g. in description and/or comments fields) if not obvious from the binning dimension(s). The dimensions of the first standard result dataset should be 'month' and 'hour' (in that order), providing the 12 x 24 matrix of seasonal and diurnal variation in overall energy production. If time variable elements are considered in the assessment, a second standard dataset resolving the time variability should be included. If statistics vary on an annual basis, it should have the dimension 'year'.If statistics vary on a monthly basis (e.g. when considering expected commissioning and availability of turbines for each month), it should have the dimensions 'year' and 'month' (in that order). Further results with other dimensions may be included optionally.",
                        "items": {
                          "$ref": "#/$defs/Dataset"
                        },
                        "minItems": 1,
                        "title": "Net Energy Production",
                        "type": "array"
                      }
                    },
                    "required": [
                      "annual_energy_production",
                      "energy_production"
                    ],
                    "title": "Net Energy Assessment Results",
                    "type": "object"
                  }
                },
                "required": [
                  "results"
                ],
                "title": "Net Energy Assessment",
                "type": "object"
              },
              "plant_performance_assessment": {
                "additionalProperties": false,
                "description": "Plant performance loss assessment categories including results.",
                "properties": {
                  "categories": {
                    "description": "Plant performance loss assessment categories including results.",
                    "items": {
                      "additionalProperties": false,
                      "description": "Plant performance loss assessment category.",
                      "properties": {
                        "comments": {
                          "anyOf": [
                            {
                              "minLength": 1,
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "default": null,
                          "description": "Optional comments on the plant performance loss category, which should not be empty if the field is included.",
                          "title": "Comments"
                        },
                        "description": {
                          "anyOf": [
                            {
                              "minLength": 1,
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "default": null,
                          "description": "Optional description of the plant performance loss category, which should not be empty if the field is included.",
                          "title": "Description"
                        },
                        "label": {
                          "description": "Label of the plant performance loss category.",
                          "enum": [
                            "turbine_interaction",
                            "availability",
                            "electrical",
                            "turbine_performance",
                            "environmental",
                            "curtailment",
                            "other"
                          ],
                          "title": "Plant Performance Category Label",
                          "type": "string"
                        },
                        "results": {
                          "$ref": "#/$defs/PlantPerformanceResults",
                          "description": "Plant performance assessment category results."
                        },
                        "subcategories": {
                          "description": "Plant performance loss assessment subcategories that fall under the category. The subcategory objects include details and results at the subcategory level.",
                          "items": {
                            "additionalProperties": false,
                            "description": "Plant performance loss assessment subcategory.",
                            "properties": {
                              "basis": {
                                "description": "Basis upon which the plant performance loss subcategory has been assessed. The basis describes the method and level of detail of the calculation or assumption used in the assessment of the subcategory.",
                                "enum": [
                                  "time_series_calculation",
                                  "distribution_calculation",
                                  "other_calculation",
                                  "project_specific_assumption",
                                  "regional_assumption",
                                  "generic assumption",
                                  "not_considered"
                                ],
                                "title": "Basis",
                                "type": "string"
                              },
                              "comments": {
                                "anyOf": [
                                  {
                                    "minLength": 1,
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "default": null,
                                "description": "Optional comments on the plant performance loss subcategory, which should not be empty if the field is included.",
                                "title": "Comments"
                              },
                              "description": {
                                "anyOf": [
                                  {
                                    "minLength": 1,
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "default": null,
                                "description": "Optional description of the plant performance loss subcategory, which should not be empty if the field is included.",
                                "title": "Description"
                              },
                              "elements": {
                                "anyOf": [
                                  {
                                    "items": {
                                      "additionalProperties": false,
                                      "description": "Plant performance loss assessment subcategory element.",
                                      "properties": {
                                        "basis": {
                                          "description": "Basis of the plant performance loss subcategory element assessment. The basis describes the method and level of detail of the calculation or assumption used in the assessment of the element.",
                                          "enum": [
                                            "time_series_calculation",
                                            "distribution_calculation",
                                            "other_calculation",
                                            "project_specific_assumption",
                                            "regional_assumption",
                                            "generic assumption",
                                            "not_considered"
                                          ],
                                          "title": "Basis",
                                          "type": "string"
                                        },
                                        "comments": {
                                          "anyOf": [
                                            {
                                              "minLength": 1,
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "default": null,
                                          "description": "Optional comments on the plant performance loss subcategory element, which should not be empty if the field is included.",
                                          "title": "Comments"
                                        },
                                        "description": {
                                          "anyOf": [
                                            {
                                              "minLength": 1,
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "default": null,
                                          "description": "Optional description of the plant performance loss subcategory element, which should not be empty if the field is included.",
                                          "title": "Description"
                                        },
                                        "is_statistically_independent": {
                                          "default": true,
                                          "description": "Whether the plant performance loss subcategory element is statistically independent of all other elements.",
                                          "title": "Is Statistically Independent",
                                          "type": "boolean"
                                        },
                                        "label": {
                                          "description": "Label of the plant performance loss subcategory element.",
                                          "minLength": 1,
                                          "title": "Label",
                                          "type": "string"
                                        },
                                        "provenance": {
                                          "description": "Provenance of the plant performance loss subcategory element assessment, including specification of the assessor type (issuing organisation, receiving organisation, commissioning organisation or other organisation), and if relevant also the assessor organisation and status of verification. Where the specification of the provenance is omitted, it shall be assumed that the assessor is the issuing organisation(s) of the EYA. Further details can be included in the description and comment fields of the plant performance subcategory element.",
                                          "discriminator": {
                                            "mapping": {
                                              "commissioning_organisation": "#/$defs/FirstPartyAssessmentComponentProvenance",
                                              "issuing_organisation": "#/$defs/IssuingOrganisationAssessmentComponentProvenance",
                                              "other_organisation": "#/$defs/OtherOrganisationAssessmentComponentProvenance",
                                              "receiving_organisation": "#/$defs/FirstPartyAssessmentComponentProvenance"
                                            },
                                            "propertyName": "assessor_type"
                                          },
                                          "oneOf": [
                                            {
                                              "$ref": "#/$defs/IssuingOrganisationAssessmentComponentProvenance"
                                            },
                                            {
                                              "$ref": "#/$defs/FirstPartyAssessmentComponentProvenance"
                                            },
                                            {
                                              "$ref": "#/$defs/OtherOrganisationAssessmentComponentProvenance"
                                            }
                                          ],
                                          "title": "Provenance"
                                        },
                                        "results": {
                                          "$ref": "#/$defs/PlantPerformanceResults",
                                          "description": "Plant performance assessment subcategory element results."
                                        },
                                        "variability": {
                                          "$ref": "#/$defs/TimeVariabilityType",
                                          "description": "Considered variability in the plant performance loss subcategory element."
                                        }
                                      },
                                      "required": [
                                        "label",
                                        "basis",
                                        "variability",
                                        "results"
                                      ],
                                      "title": "Plant Performance Subcategory Element",
                                      "type": "object"
                                    },
                                    "minItems": 1,
                                    "type": "array"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "default": null,
                                "description": "Optional plant performance loss assessment elements that fall under the subcategory. The element objects include details and results at the element level. A breakdown of plant performance loss subcategories into elements is optional and can be included only for a subset of the subcategories, as relevant. Whereas the categories and subcategories are fixed, the user may freely define element labels.",
                                "title": "Elements"
                              },
                              "label": {
                                "description": "Label of the plant performance loss subcategory.",
                                "enum": [
                                  "internal_turbine_interaction",
                                  "external_turbine_interaction",
                                  "future_turbine_interaction",
                                  "turbine_availability",
                                  "bop_availability",
                                  "grid_availability",
                                  "electrical_efficiency",
                                  "facility_parasitic_consumption",
                                  "sub_optimal_performance",
                                  "generic_power_curve_adjustment",
                                  "site_specific_power_curve_adjustment",
                                  "high_wind_hysteresis",
                                  "icing",
                                  "degradation",
                                  "external_conditions",
                                  "exposure_changes",
                                  "load_curtailment",
                                  "grid_curtailment",
                                  "environmental_curtailment",
                                  "operational_strategies",
                                  "asymmetric_effects",
                                  "upside_scenarios",
                                  "other"
                                ],
                                "title": "Plant Performance Subcategory Label",
                                "type": "string"
                              },
                              "provenance": {
                                "description": "Provenance of the plant performance loss subcategory assessment, including specification of the assessor type (issuing organisation, receiving organisation, commissioning organisation or other organisation), and if relevant also the assessor organisation and status of verification. Where the specification of the provenance is omitted, it shall be assumed that the assessor is the issuing organisation(s) of the EYA. Further details can be included in the description and comment fields of the plant performance subcategory.",
                                "discriminator": {
                                  "mapping": {
                                    "commissioning_organisation": "#/$defs/FirstPartyAssessmentComponentProvenance",
                                    "issuing_organisation": "#/$defs/IssuingOrganisationAssessmentComponentProvenance",
                                    "other_organisation": "#/$defs/OtherOrganisationAssessmentComponentProvenance",
                                    "receiving_organisation": "#/$defs/FirstPartyAssessmentComponentProvenance"
                                  },
                                  "propertyName": "assessor_type"
                                },
                                "oneOf": [
                                  {
                                    "$ref": "#/$defs/IssuingOrganisationAssessmentComponentProvenance"
                                  },
                                  {
                                    "$ref": "#/$defs/FirstPartyAssessmentComponentProvenance"
                                  },
                                  {
                                    "$ref": "#/$defs/OtherOrganisationAssessmentComponentProvenance"
                                  }
                                ],
                                "title": "Provenance"
                              },
                              "results": {
                                "$ref": "#/$defs/PlantPerformanceResults",
                                "description": "Plant performance assessment subcategory results."
                              },
                              "variability": {
                                "$ref": "#/$defs/TimeVariabilityType",
                                "description": "Considered variability in the plant performance loss subcategory."
                              }
                            },
                            "required": [
                              "label",
                              "basis",
                              "variability",
                              "results"
                            ],
                            "title": "Plant Performance Subcategory",
                            "type": "object"
                          },
                          "minItems": 1,
                          "title": "Subcategories",
                          "type": "array"
                        }
                      },
                      "required": [
                        "label",
                        "subcategories",
                        "results"
                      ],
                      "title": "Plant Performance Category",
                      "type": "object"
                    },
                    "minItems": 1,
                    "title": "Categories",
                    "type": "array"
                  },
                  "results": {
                    "$ref": "#/$defs/PlantPerformanceResults",
                    "description": "Overall plant performance loss assessment results."
                  }
                },
                "required": [
                  "categories",
                  "results"
                ],
                "title": "Plant Performance Assessment",
                "type": "object"
              },
              "wind_uncertainty_assessment": {
                "additionalProperties": false,
                "description": "Details of the wind related uncertainty assessment.",
                "properties": {
                  "categories": {
                    "description": "Wind uncertainty assessment categories including results.",
                    "items": {
                      "additionalProperties": false,
                      "description": "Category of a wind uncertainty assessment.",
                      "properties": {
                        "comments": {
                          "anyOf": [
                            {
                              "minLength": 1,
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "default": null,
                          "description": "Optional comments on the wind uncertainty category, which should not be empty if the field is included.",
                          "title": "Comments"
                        },
                        "description": {
                          "anyOf": [
                            {
                              "minLength": 1,
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "default": null,
                          "description": "Optional description of the wind uncertainty category, which should not be empty if the field is included.",
                          "title": "Description"
                        },
                        "label": {
                          "description": "Label of the wind uncertainty assessment category.",
                          "enum": [
                            "measurement",
                            "historical_wind_resource",
                            "future_assessment_period_variability",
                            "vertical_extrapolation",
                            "horizontal_extrapolation",
                            "other"
                          ],
                          "title": "Wind Uncertainty Category Label",
                          "type": "string"
                        },
                        "results": {
                          "$ref": "#/$defs/WindUncertaintyResults",
                          "description": "Wind uncertainty assessment category results."
                        },
                        "subcategories": {
                          "description": "Wind uncertainty assessment subcategories that fall under the category. The subcategory objects include details and results at the subcategory level.",
                          "items": {
                            "additionalProperties": false,
                            "description": "Subcategory of a wind uncertainty assessment.",
                            "properties": {
                              "comments": {
                                "anyOf": [
                                  {
                                    "minLength": 1,
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "default": null,
                                "description": "Optional comments on the wind uncertainty subcategory, which should not be empty if the field is included.",
                                "title": "Comments"
                              },
                              "description": {
                                "anyOf": [
                                  {
                                    "minLength": 1,
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "default": null,
                                "description": "Optional description of the wind uncertainty subcategory, which should not be empty if the field is included.",
                                "title": "Description"
                              },
                              "elements": {
                                "anyOf": [
                                  {
                                    "items": {
                                      "additionalProperties": false,
                                      "description": "Subcategory element of a wind related uncertainty assessment.",
                                      "properties": {
                                        "comments": {
                                          "anyOf": [
                                            {
                                              "minLength": 1,
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "default": null,
                                          "description": "Optional comments on the wind uncertainty subcategory element, which should not be empty if the field is included.",
                                          "title": "Comments"
                                        },
                                        "description": {
                                          "anyOf": [
                                            {
                                              "minLength": 1,
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "default": null,
                                          "description": "Optional description of the wind uncertainty subcategory element, which should not be empty if the field is included.",
                                          "title": "Description"
                                        },
                                        "label": {
                                          "description": "Label of the wind uncertainty subcategory element.",
                                          "minLength": 1,
                                          "title": "Label",
                                          "type": "string"
                                        },
                                        "results": {
                                          "$ref": "#/$defs/WindUncertaintyResults",
                                          "description": "Wind uncertainty assessment subcategory element results."
                                        }
                                      },
                                      "required": [
                                        "label",
                                        "results"
                                      ],
                                      "title": "Wind Uncertainty Subcategory Element",
                                      "type": "object"
                                    },
                                    "minItems": 1,
                                    "type": "array"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "default": null,
                                "description": "Wind uncertainty assessment elements that fall under the subcategory. The element objects include details and results at the element level. A breakdown of wind uncertainty subcategories into elements is optional and can be included only for a subset of the subcategories, as relevant. Whereas the categories and subcategories are fixed, the user may freely define element labels.",
                                "title": "Elements"
                              },
                              "label": {
                                "description": "Label of the wind uncertainty subcategory.",
                                "enum": [
                                  "wind_speed_measurement",
                                  "wind_direction_measurement",
                                  "other_atmospheric_parameters",
                                  "data_integrity",
                                  "long_term_period_representativeness",
                                  "reference_data_consistency",
                                  "long_term_adjustment",
                                  "wind_speed_distribution_uncertainty",
                                  "on_site_data_synthesis",
                                  "measured_data_representativeness",
                                  "vertical_model_uncertainty",
                                  "excess_propagated_uncertainty",
                                  "horizontal_model_inputs",
                                  "horizontal_model_sensitivity",
                                  "horizontal_model_appropriateness",
                                  "wind_speed_variability",
                                  "climate_change",
                                  "other"
                                ],
                                "title": "Wind Uncertainty Subcategory Label",
                                "type": "string"
                              },
                              "results": {
                                "$ref": "#/$defs/WindUncertaintyResults",
                                "description": "Wind uncertainty assessment subcategory results."
                              }
                            },
                            "required": [
                              "label",
                              "results"
                            ],
                            "title": "Wind Uncertainty Subcategory",
                            "type": "object"
                          },
                          "title": "Subcategories",
                          "type": "array"
                        }
                      },
                      "required": [
                        "label",
                        "subcategories",
                        "results"
                      ],
                      "title": "Wind Uncertainty Category",
                      "type": "object"
                    },
                    "minItems": 1,
                    "title": "Categories",
                    "type": "array"
                  },
                  "results": {
                    "$ref": "#/$defs/WindUncertaintyResults",
                    "description": "Overall wind related uncertainty assessment results."
                  },
                  "wind_speed_to_energy_sensitivity_factor": {
                    "description": "The dimensionless relative wind-speed-to-energy sensitivity factor, calculated as the dimensionless relative difference in net energy divided by the corresponding relative wind speed perturbation.",
                    "examples": [
                      1.6,
                      2.1
                    ],
                    "exclusiveMinimum": 0,
                    "title": "Wind Speed To Energy Sensitivity Factor",
                    "type": "number"
                  }
                },
                "required": [
                  "categories",
                  "results",
                  "wind_speed_to_energy_sensitivity_factor"
                ],
                "title": "Wind Uncertainty Assessment",
                "type": "object"
              }
            },
            "required": [
              "gross_energy_assessment",
              "wind_uncertainty_assessment",
              "plant_performance_assessment",
              "net_energy_assessment"
            ],
            "title": "Energy Assessment",
            "type": "object"
          },
          "id": {
            "anyOf": [
              {
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional unique identifier of the scenario, which should not be empty if the field is included.",
            "examples": [
              "3613a846-1e74-4535-ad40-7368f7ad452d"
            ],
            "title": "Id"
          },
          "is_main_scenario": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional flag to specify whether or not it is the main scenario in the report.",
            "title": "Is Main Scenario"
          },
          "label": {
            "description": "Label of the scenario.",
            "examples": [
              "Sc1",
              "A",
              "B01"
            ],
            "minLength": 1,
            "title": "Label",
            "type": "string"
          },
          "turbine_wind_resource_assessment": {
            "additionalProperties": false,
            "description": "Wind resource assessment at the turbine locations.",
            "properties": {
              "comments": {
                "anyOf": [
                  {
                    "minLength": 1,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Optional comments on the turbine wind resource assessment, which should not be empty if the field is included.",
                "title": "Comments"
              },
              "description": {
                "anyOf": [
                  {
                    "minLength": 1,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Optional description of the turbine wind resource assessment, which should not be empty if the field is included.",
                "title": "Description"
              },
              "results": {
                "additionalProperties": false,
                "description": "Results of the wind resource assessment at the turbine location(s).",
                "properties": {
                  "air_density": {
                    "anyOf": [
                      {
                        "items": {
                          "$ref": "#/$defs/Dataset"
                        },
                        "minItems": 1,
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Final long-term air density estimates at the turbine location(s) at hub height in kilogram per cubic metre (kg m-3). The dimension of the first standard result dataset should be 'turbine_id'. Further results with other dimensions may also be included.",
                    "title": "Air Density"
                  },
                  "ambient_turbulence_intensity": {
                    "anyOf": [
                      {
                        "items": {
                          "$ref": "#/$defs/Dataset"
                        },
                        "minItems": 1,
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Final ambient turbulence intensity estimates at the turbine location(s) at hub height, as dimensionless values. The first standard result dataset should comprise the ambient turbulence intensity as a function of wind speed, with the dimensions 'turbine_id' and 'wind_speed' (in that order). The wind speed coordinates should be 1.0 metre per second bins centered on whole numbers, with the first bin half the width (i.e. 0.25, 1.0, 2.0, 3.0, ...). Further results with other dimensions may also be included.",
                    "title": "Ambient Turbulence Intensity"
                  },
                  "displacement_height": {
                    "anyOf": [
                      {
                        "items": {
                          "$ref": "#/$defs/Dataset"
                        },
                        "minItems": 1,
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Estimated effective displacement of the boundary layer at the turbine location(s) due to vegetation (forestry) in metre. The displacement height is measured as positive upwards from the ground level. This field is optional as it is only relevant at forested sites. The dimension of the first standard result dataset should be 'turbine_id'. Further results with other dimensions, such as displacement height binned by wind direction, may also be included.",
                    "title": "Displacement Height"
                  },
                  "probability": {
                    "anyOf": [
                      {
                        "items": {
                          "$ref": "#/$defs/Dataset"
                        },
                        "minItems": 1,
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Final long-term probability distribution estimates at the turbine location(s) at hub height, as dimensionless values. The first standard result dataset should comprise the joint wind speed and direction probability distributions, with dimensions 'turbine_id', 'wind_speed' and 'wind_from_direction' (in that order). The wind speed coordinates should be 1.0 metre per second bins centered on whole numbers, with the first bin half the width (i.e. 0.25, 1.0, 2.0, 3.0, ...). The wind direction coordinates should be twelve 30.0 degree bins, with the the first bin centered at 0.0. Further results with other dimensions may also be included.",
                    "title": "Probability"
                  },
                  "temperature": {
                    "anyOf": [
                      {
                        "items": {
                          "$ref": "#/$defs/Dataset"
                        },
                        "minItems": 1,
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Final long-term temperature estimates at the turbine location(s) at hub height in degree C. The dimension of the first standard result dataset should be 'turbine_id'. Further results with other dimensions may also be included.",
                    "title": "Temperature"
                  },
                  "wind_shear_exponent": {
                    "anyOf": [
                      {
                        "items": {
                          "$ref": "#/$defs/Dataset"
                        },
                        "minItems": 1,
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Final power law wind shear exponent estimates at the turbine location(s). The dimension of the first standard result dataset should be 'turbine_id'. Further results with other dimensions may also be included.",
                    "title": "Wind Shear Exponent"
                  },
                  "wind_speed": {
                    "description": "Final long-term wind speed estimates at the turbine location(s) at hub height in metre per second (m s-1). The dimension of the first standard result dataset should be 'turbine_id'. Further results with other dimensions may be included optionally.",
                    "items": {
                      "$ref": "#/$defs/Dataset"
                    },
                    "minItems": 1,
                    "title": "Wind Speed",
                    "type": "array"
                  }
                },
                "required": [
                  "wind_speed"
                ],
                "title": "Turbine Wind Resource Results",
                "type": "object"
              },
              "weighting": {
                "anyOf": [
                  {
                    "additionalProperties": false,
                    "description": "Details of weighting applied to estimate turbine wind resource.",
                    "properties": {
                      "source_wind_data": {
                        "anyOf": [
                          {
                            "items": {
                              "$ref": "#/$defs/Dataset"
                            },
                            "minItems": 1,
                            "type": "array"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "description": "Optional specification of the weight applied to the prediction based on each source of wind data when making the final wind resource estimate at each target turbine location. The dimensions of the first standard weighting specification dataset should be 'turbine_id' (the target turbine of the estimate for which the weight is applied), 'wind_dataset_id' (the source wind dataset whose prediction the weight is applied to), and 'variable_id' (if different weights were applied to different variables, such as wind speed and wind direction weighted differently, otherwise omitted). Further results with additional dimensions may optionally be included, in which case the initial set of dimensions must be the same as those for the first standard dataset. For example, if weights are applied by wind direction bin, an additional dataset with dimensions 'turbine_id', 'wind_dataset_id', 'variable_id' and 'wind_from_direction' (i.e. wind direction bin) may be included.",
                        "title": "Source Wind Data"
                      }
                    },
                    "title": "Turbine Wind Resource Weighting",
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Optional specification of the weighting applied to estimate the wind resource at the turbine location(s),relevant for example when predictions from different measurement stations were weighted individually at each turbine based on representativeness."
              },
              "wind_resource_assessment_id_reference": {
                "description": "The ID of the wind resource assessment on which the turbine wind resource assessment is based. This must refer to an ID of a wind resource assessment included at the top level of the EYA DEF. The schema requires that a turbine wind resource assessment is based on only one wind resource assessment.",
                "examples": [
                  "WRA01",
                  "BfWF_WRA_1"
                ],
                "minLength": 1,
                "title": "Wind Resource Assessment Id Reference",
                "type": "string"
              }
            },
            "required": [
              "wind_resource_assessment_id_reference",
              "results"
            ],
            "title": "Turbine Wind Resource Assessment",
            "type": "object"
          },
          "wind_farm_ids": {
            "description": "List of the IDs for all wind farms included in the scenario. Each ID refers to a wind farm configuration data object within the 'wind_farms' section of the top-level of the EYA DEF document. Only wind farms for which turbine interaction effects are modelled shall be included.",
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "title": "Wind Farm Ids",
            "type": "array"
          }
        },
        "required": [
          "label",
          "wind_farm_ids",
          "turbine_wind_resource_assessment",
          "energy_assessment"
        ],
        "title": "Scenario",
        "type": "object"
      },
      "minItems": 1,
      "title": "Scenarios",
      "type": "array"
    },
    "title": {
      "description": "Title of the energy yield assessment (EYA) report.",
      "examples": [
        "Energy yield assessment of the Barefoot Wind Farm"
      ],
      "minLength": 1,
      "title": "Title",
      "type": "string"
    },
    "uri": {
      "anyOf": [
        {
          "format": "uri",
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional URI of the EYA DEF JSON document",
      "examples": [
        "https://foo.com/api/eya?id=8f46a815-8b6d-4870-8e92-c031b20320c6.json"
      ],
      "title": "URI"
    },
    "utc_offset": {
      "description": "The offset in hours of the local time zone used for the EYA relative to Coordinated Universal Time (UTC). It is applied to UTC time to convert it to local time, hence positive for time zones ahead of UTC and negative for time zones behind UTC (e.g. -6.0 for MST and 9.5 for ACST). All data where the time zone is relevant (e.g. hourly time series and diurnal profiles) must be consistent with this one UTC offset.",
      "examples": [
        -6.0,
        0.0,
        1.0,
        9.5
      ],
      "title": "Utc Offset",
      "type": "number"
    },
    "uuid": {
      "anyOf": [
        {
          "format": "uuid",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional UUID of the EYA DEF document.",
      "examples": [
        "8f46a815-8b6d-4870-8e92-c031b20320c6"
      ],
      "title": "UUID"
    },
    "wind_farms": {
      "description": "List of all wind farms considered in the EYA. This should comprise internal, external and future wind farms, including those used as reference wind farms in the wind resource assessment, if any. If different configurations are assessed for one or more internal and/or future wind farms in different scenarios, a wind farm object must be completed for each unique configuration, with the relevant configurations for each scenario referenced by wind farm ID.",
      "items": {
        "additionalProperties": false,
        "description": "A collection of wind turbines considered as one unit (plant).",
        "properties": {
          "abbreviation": {
            "anyOf": [
              {
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional abbreviated label of the wind farm.",
            "examples": [
              "BWF",
              "Summit PhIII"
            ],
            "title": "Abbreviation"
          },
          "assessment_period_end_date": {
            "description": "The assessment period end date of the wind farm in the ISO 8601 standard format for a calendar date, i.e. YYYY-MM-DD.",
            "examples": [
              "2051-03-31",
              "2025-12-31"
            ],
            "format": "date",
            "title": "Assessment Period End Date",
            "type": "string"
          },
          "assessment_period_start_date": {
            "description": "The assessment period start date of the wind farm in the ISO 8601 standard format for a calendar date, i.e. YYYY-MM-DD.",
            "examples": [
              "2026-01-01",
              "2017-04-01"
            ],
            "format": "date",
            "title": "Assessment Period Start Date",
            "type": "string"
          },
          "comments": {
            "anyOf": [
              {
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional comments on the wind farm, which should not be empty if the field is included.",
            "title": "Comments"
          },
          "description": {
            "anyOf": [
              {
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional description of the wind farm, which should not be empty if the field is included.",
            "title": "Description"
          },
          "export_capacity": {
            "anyOf": [
              {
                "exclusiveMinimum": 0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional specification of the maximum permanently transmittable active power (in W) from the wind farm at the grid connection point, or equivalent, if known. If not included, it shall be assumed that the wind farm can transmit the full produced output.",
            "examples": [
              11300000.0,
              2332000000.0
            ],
            "title": "Export Capacity"
          },
          "id": {
            "description": "Unique identifier of the wind farm.",
            "examples": [
              "8994452f-731b-4342-9418-571920e44484"
            ],
            "minLength": 1,
            "title": "Id",
            "type": "string"
          },
          "installed_capacity": {
            "description": "The sum of the individual nameplate active power capacities of the wind turbines that form part of the wind farm (in W). Note that the nameplate power does not always correspond to output under typical conditions.",
            "examples": [
              12300000.0,
              2345000000.0
            ],
            "exclusiveMinimum": 0,
            "title": "Installed Capacity",
            "type": "number"
          },
          "label": {
            "description": "Label or name of the wind farm.",
            "examples": [
              "Barefoot Wind Farm",
              "Project Summit Phase III"
            ],
            "minLength": 1,
            "title": "Label",
            "type": "string"
          },
          "relevance": {
            "description": "The relevance of the wind farm for the assessment ('internal', 'external' or 'future').",
            "enum": [
              "internal",
              "external",
              "future"
            ],
            "title": "Wind Farm Relevance",
            "type": "string"
          },
          "restrictions": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/$defs/OperationalRestriction"
                },
                "minItems": 1,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "List of operational restrictions at the wind farm level.",
            "title": "Restrictions"
          },
          "turbines": {
            "description": "List of specifications for constituent turbines.",
            "items": {
              "additionalProperties": false,
              "description": "Specification of all details for a turbine configuration.",
              "properties": {
                "assessment_period_end_date": {
                  "anyOf": [
                    {
                      "format": "date",
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Optional assessment period end date of the individual turbine in the ISO 8601 standard format for a calendar date, i.e. YYYY-MM-DD.",
                  "examples": [
                    "2051-03-31",
                    "2025-12-31"
                  ],
                  "title": "Assessment Period End Date"
                },
                "assessment_period_start_date": {
                  "anyOf": [
                    {
                      "format": "date",
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Optional assessment period start date of the individual turbine in the ISO 8601 standard format for a calendar date, i.e. YYYY-MM-DD.",
                  "examples": [
                    "2026-01-01",
                    "2017-04-01"
                  ],
                  "title": "Assessment Period Start Date"
                },
                "baseline_operating_mode": {
                  "description": "The unique identifier for the baseline operating mode of the turbine (the operating mode used in the calculation of gross energy yield), which should correspond to the value of the field 'label' under 'power_curves' and 'operating_modes' in the IEC 61400-16 Power Curve Schema.",
                  "examples": [
                    "standard",
                    "PO1",
                    "N/14"
                  ],
                  "minLength": 1,
                  "title": "Baseline Operating Mode",
                  "type": "string"
                },
                "comments": {
                  "anyOf": [
                    {
                      "minLength": 1,
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Optional comments on the turbine, which should not be empty if the field is included.",
                  "title": "Comments"
                },
                "description": {
                  "anyOf": [
                    {
                      "minLength": 1,
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Optional description of the turbine, which should not be empty if the field is included.",
                  "title": "Description"
                },
                "ground_level_altitude": {
                  "description": "The ground level altitude (base elevation) of the turbine (in m).",
                  "title": "Ground Level Altitude",
                  "type": "number"
                },
                "hub_height": {
                  "description": "The hub height of the turbine above ground level (in m).",
                  "title": "Hub Height",
                  "type": "number"
                },
                "id": {
                  "description": "Unique identifier of the turbine.",
                  "examples": [
                    "b55caeac-f152-4b13-8217-3fddeab792cf",
                    "T1-scenario-1"
                  ],
                  "minLength": 1,
                  "title": "Id",
                  "type": "string"
                },
                "label": {
                  "anyOf": [
                    {
                      "minLength": 1,
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Label of the turbine, if different from the 'id'.",
                  "examples": [
                    "T1",
                    "WTG02",
                    "WEA_003"
                  ],
                  "title": "Label"
                },
                "location": {
                  "additionalProperties": false,
                  "description": "The horizontal spatial location of the turbine.",
                  "properties": {
                    "x": {
                      "description": "Location x-coordinate (typically easting).",
                      "examples": [
                        419665.0
                      ],
                      "title": "X",
                      "type": "number"
                    },
                    "y": {
                      "description": "Location y-coordinate (typically northing).",
                      "examples": [
                        6195240.0
                      ],
                      "title": "Y",
                      "type": "number"
                    }
                  },
                  "required": [
                    "x",
                    "y"
                  ],
                  "title": "Location",
                  "type": "object"
                },
                "power_curve_document_id": {
                  "description": "The unique identifier of the turbine model power curve document, which should correspond to the value for the term 'Identifier' under 'document' and 'metadata' in the IEC 61400-16 Power Curve Schema.",
                  "examples": [
                    "ba44fc3f-6963-45a9-a29f-e4fb855d881c",
                    "XYZ/200/20MW/1.2.3"
                  ],
                  "minLength": 1,
                  "title": "Power Curve Document Id",
                  "type": "string"
                },
                "restrictions": {
                  "anyOf": [
                    {
                      "items": {
                        "$ref": "#/$defs/OperationalRestriction"
                      },
                      "minItems": 1,
                      "type": "array"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "List of operational restrictions at the turbine level.",
                  "title": "Restrictions"
                },
                "turbine_model": {
                  "description": "The unique identifier for the model of the turbine, which should correspond to the value of the field 'model_name' under 'turbine' in the IEC 61400-16 Power Curve Schema.",
                  "examples": [
                    "GT 3.45-117",
                    "XYZ/200/20MW"
                  ],
                  "minLength": 1,
                  "title": "Turbine Model",
                  "type": "string"
                }
              },
              "required": [
                "id",
                "location",
                "ground_level_altitude",
                "hub_height",
                "turbine_model",
                "power_curve_document_id",
                "baseline_operating_mode"
              ],
              "title": "Turbine Configuration",
              "type": "object"
            },
            "minItems": 1,
            "title": "Turbines",
            "type": "array"
          }
        },
        "required": [
          "id",
          "label",
          "turbines",
          "relevance",
          "assessment_period_start_date",
          "assessment_period_end_date",
          "installed_capacity"
        ],
        "title": "Wind Farm Configuration",
        "type": "object"
      },
      "minItems": 1,
      "title": "Wind Farms",
      "type": "array"
    },
    "wind_resource_assessments": {
      "description": "List of wind resource assessments, including results, at the measurement station locations.",
      "items": {
        "additionalProperties": false,
        "description": "Wind resource assessment at the measurement location(s).",
        "properties": {
          "comments": {
            "anyOf": [
              {
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional comments on the wind resource assessment, which should not be empty if the field is included.",
            "title": "Comments"
          },
          "dataset_statistics": {
            "additionalProperties": false,
            "description": "Statistics relating to the wind resource assessment datasets, such as data availability.",
            "properties": {
              "data_availability": {
                "description": "Dimensionless raw data availability (also known as data recovery rate and data coverage) for the primary inputs to the wind resource assessment. The standard required dataset(s) should report data availability on a monthly basis, with the dimensions 'wind_dataset_id', 'point_id', 'year' and 'month' (in that order) for datasets from wind measurement stations and meteorological reference sources; and 'wind_farm_id', 'operational_dataset_id', 'variable_id' (where data availability is not identical across all relevant variables within the operational dataset, otherwise omitted), 'turbine_id' (for variables at the turbine level and where data availability is not identical across all turbines, otherwise omitted), 'year' and 'month' (in that order) for operational reference wind farm datasets. Additional datasets with other dimensions may be included optionally. The raw data availability is defined as the proportion of samples available in the raw dataset relative to the possible maximum amount of samples within a certain time frame (i.e. if no data were missing), before the author of the EYA has undertaken any data filtering. The raw dataset may include filtering inherent in the process of creating it, such as quality filtering implemented in the firmware of remote sensing devices (RSDs), and the raw data availability then describes the state of the dataset after such filtering has been applied.",
                "items": {
                  "$ref": "#/$defs/Dataset"
                },
                "minItems": 1,
                "title": "Data Availability",
                "type": "array"
              }
            },
            "required": [
              "data_availability"
            ],
            "title": "Wind Resource Dataset Statistics",
            "type": "object"
          },
          "description": {
            "anyOf": [
              {
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional description of the wind resource assessment, which should not be empty if the field is included.",
            "title": "Description"
          },
          "id": {
            "description": "Unique ID of the wind resource assessment within the EYA DEF document, used to reference it from other parts of the document.",
            "examples": [
              "WRA01",
              "BfWF_WRA_1",
              "A"
            ],
            "minLength": 1,
            "title": "Id",
            "type": "string"
          },
          "results": {
            "additionalProperties": false,
            "description": "Final results of the wind resource assessment at the measurement location(s). Results should generally be included at the primary measurement height and extrapolated to all assessed turbine hub heights at each measurement location, as relevant.",
            "properties": {
              "air_density": {
                "anyOf": [
                  {
                    "items": {
                      "$ref": "#/$defs/Dataset"
                    },
                    "minItems": 1,
                    "type": "array"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Final long-term air density estimates at the measurement location(s) in kilogram per cubic metre (kg m-3). This field is optional since some wind measurement stations may lack measurements required to derive air density estimates, but it should always be included when relevant data are available. The dimensions of the first standard result dataset should be 'wind_dataset_id' and 'height' (in that order). Further results with other dimensions may also be included.",
                "title": "Air Density"
              },
              "ambient_turbulence_intensity": {
                "anyOf": [
                  {
                    "items": {
                      "$ref": "#/$defs/Dataset"
                    },
                    "minItems": 1,
                    "type": "array"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Final ambient turbulence intensity estimates at the measurement location(s), as dimensionless values. This field is optional since some measurement devices may lack meaningful turbulence measurements, but it should always be included when relevant turbulence data are available. The first standard result dataset should comprise the ambient turbulence intensity as a function of wind speed, with the dimensions 'wind_dataset_id', 'height' and 'wind_speed' (in that order). The wind speed coordinates should be 1.0 metre per second bins centered on whole numbers, with the first bin half the width (i.e. 0.25, 1.0, 2.0, 3.0, ...). Further results with other dimensions may also be included.",
                "title": "Ambient Turbulence Intensity"
              },
              "displacement_height": {
                "anyOf": [
                  {
                    "items": {
                      "$ref": "#/$defs/Dataset"
                    },
                    "minItems": 1,
                    "type": "array"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Estimated effective displacement of the boundary layer at the measurement location(s) due to vegetation (forestry) in metre. The displacement height is measured as positive upwards from the ground level. This field is optional as it is only relevant at forested sites. The dimension of the first standard result dataset should be 'wind_dataset_id'. Further results with other dimensions, such as displacement height binned by wind direction, may also be included.",
                "title": "Displacement Height"
              },
              "probability": {
                "description": "Final long-term probability distribution estimates at the measurement location(s), as dimensionless values. The first standard result dataset should comprise the joint wind speed and direction probability distributions, with dimensions 'wind_dataset_id', 'height', 'wind_speed' and 'wind_from_direction' (in that order). The wind speed coordinates should be 1.0 metre per second bins centered on whole numbers, with the first bin half the width (i.e. 0.25, 1.0, 2.0, 3.0, ...). The wind direction coordinates should be twelve 30.0 degree bins, with the the first bin centered at 0.0. Further results with other dimensions may be included optionally.",
                "items": {
                  "$ref": "#/$defs/Dataset"
                },
                "minItems": 1,
                "title": "Probability",
                "type": "array"
              },
              "temperature": {
                "anyOf": [
                  {
                    "items": {
                      "$ref": "#/$defs/Dataset"
                    },
                    "minItems": 1,
                    "type": "array"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Final long-term temperature estimates at the measurement location(s) in degree C. This field is optional since some wind measurement stations may lack measurements of temperature, but it should always be included when relevant temperature data are available. The dimensions of the first standard result dataset should be 'wind_dataset_id' and 'height' (in that order). Further results with other dimensions may also be included.",
                "title": "Temperature"
              },
              "wind_shear_exponent": {
                "anyOf": [
                  {
                    "items": {
                      "$ref": "#/$defs/Dataset"
                    },
                    "minItems": 1,
                    "type": "array"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Final long-term power law wind shear exponent estimates at the measurement location(s). This field is optional since some wind measurement stations may only include a single measurement height, but it should always be included when relevant wind shear exponent data are available. The dimension of the first standard result dataset should be 'wind_dataset_id'. Further results with other dimensions may also be included.",
                "title": "Wind Shear Exponent"
              },
              "wind_speed": {
                "description": "Final long-term wind speed estimate(s) at the measurement location(s) in metre per second (m s-1). The dimensions of the first standard result dataset should be 'wind_dataset_id' and 'height' (in that order). Further results with other dimensions may be included optionally.",
                "items": {
                  "$ref": "#/$defs/Dataset"
                },
                "minItems": 1,
                "title": "Wind Speed",
                "type": "array"
              }
            },
            "required": [
              "wind_speed",
              "probability"
            ],
            "title": "Wind Resource Results",
            "type": "object"
          }
        },
        "required": [
          "id",
          "dataset_statistics",
          "results"
        ],
        "title": "Wind Resource Assessment",
        "type": "object"
      },
      "minItems": 1,
      "title": "Wind Resource Assessments",
      "type": "array"
    }
  },
  "required": [
    "title",
    "project_name",
    "project_country",
    "issue_date",
    "contributors",
    "issuing_organisations",
    "epsg_srid",
    "utc_offset",
    "wind_farms",
    "wind_resource_assessments",
    "power_curves",
    "scenarios"
  ],
  "title": "IEC 61400-15-2 EYA DEF Schema",
  "type": "object"
}