# description
Define a set of power curves for a wind turbine.

# properties.design_bases.description
A list of design bases for turbine certification or describing site-specific environmental conditions. Each contains information about the design point (environmental conditions) for which the power curves in this document are intended.

# properties.design_bases.items.properties.certification.description
Information about the scheme under which this design basis was certified. This is not a required property, so if a turbine is as-yet uncertified, simply leave it out.

# properties.design_bases.items.properties.certification.$comment
We collect these three under a single 'certification' property as a convenient way to require that either all or none are given

# properties.design_bases.items.properties.certification.properties.certificate_reference.description
Identifies the certificate associated with the power curve. Note that multiple design bases may refer to the same certificate.

# properties.design_bases.items.properties.certification.properties.standard.description
The certification scheme under which the power curves were certified.

# properties.design_bases.items.properties.certification.properties.standard.$comment
The use of anyOf allows specification of any string value, whilst adding an enum to indicate the precise values to be selected should your value be in the prescribed list of common items.

# properties.design_bases.items.properties.certification.properties.standard_edition.description
The edition of the standard used in turbine certification

# properties.design_bases.items.properties.certification.properties.standard_edition.$comment
The use of anyOf allows specification of any string value, whilst adding an enum to indicate the precise values to be selected should your value be in the prescribed list of common items.

# properties.design_bases.items.properties.cold_climate.description
As per standard climate in eventuality turbine is equipped with a cold weather package

# properties.design_bases.items.properties.design_class.description
A fully or partially predefined environmental class, (eg IEC or other scheme)

# properties.design_bases.items.properties.design_class.oneOf[].properties.class_label.description
Specify a predefined IEC design class (I, II, or III)

# properties.design_bases.items.properties.design_class.oneOf[].properties.class_modifiers.description
Specify optional additional modifier on the design class (T and/or CC)

# properties.design_bases.items.properties.design_class.oneOf[].properties.annual_average_air_density.description
The annualised average air density for which the turbine is certified [kg/m^3]

# properties.design_bases.items.properties.design_class.oneOf[].properties.annual_average_wind_speed.description
The annualised average wind speed for which the turbine is certified [m/s]

# properties.design_bases.items.properties.design_class.oneOf[].properties.class_label.description
Specify an IEC class with custom parameters (design classes S)

# properties.design_bases.items.properties.design_class.oneOf[].properties.class_modifiers.description
Specify optional additional modifiers on the design class (CC)

# properties.design_bases.items.properties.design_class.oneOf[].properties.design_lifetime.description
Designed lifetime of the turbine in years, typically 20. Note that some design classes require particular minimum lifetimes.

# properties.design_bases.items.properties.design_class.oneOf[].properties.design_lifetime.$comment
Schema team - check if this also needs to be given for T, CC classes as well as S class

# properties.design_bases.items.properties.design_class.oneOf[].properties.inclination_angle.description
The design vertical inclination (inflow) angle [degrees]

# properties.design_bases.items.properties.design_class.oneOf[].properties.reference_wind_speed.description
The 50-year return value of 10-minute average wind speed for which the turbine is certified [m/s]. Note: the Ve50 (the 3s gust wind speed) can be calculated from V50 according to the standard ratio

# properties.design_bases.items.properties.design_class.oneOf[].properties.vertical_shear_exponent.description
The design wind vertical shear exponent [dimensionless]

# properties.design_bases.items.properties.design_class.oneOf[].properties.weibull_shape_factor.description
The Weibull distribution shape factor k [dimensionless]. Tip: You can calculate the Weibull scale factor, 'c', from the weibull_shape_factor and the annual_average_wind_speed.

# properties.design_bases.items.properties.hot_climate.description
As per standard climate in eventuality turbine is equipped with a hot weather package

# properties.design_bases.items.properties.hot_climate.$comment
TODO Schema team - Can we define why this is different in hot climates than it is in standard climates?

# properties.design_bases.items.properties.label.description
A string key identifying the design basis, eg `my_design_basis_1`

# properties.design_bases.items.properties.name.description
A human-readable name matching this basis label (eg for use in UIs)

# properties.design_bases.items.properties.standard_climate.description
Define operating and survival temperatures in standard climates

# properties.design_bases.items.properties.turbulence.description
Specify the IEC turbulence category or one of several custom distributions.

# properties.design_bases.items.properties.turbulence.anyOf[].$comment
This is defined as a single-property object rather than a direct string because it's more explicit to include the category keyword (and allows for later adoption of other predefined profiles requiring more sophistication than a string)

# properties.design_bases.items.properties.turbulence.anyOf[].properties.category.description
Specify a predefined IEC turbulence category

# properties.design_bases.items.properties.turbulence.anyOf[].properties.category.description
Specify a custom/special value of Reference turbulence intensity

# properties.design_bases.items.properties.turbulence.anyOf[].properties.reference_turbulence_intensity.description
Value of Iref, specified as a fraction (eg 0.13)

# properties.design_bases.items.properties.turbulence.anyOf[].title
Characteristic turbulence intensity and slope

# properties.design_bases.items.properties.turbulence.anyOf[].description
Specify characteristic turbulence intensity and slope consistent with IEC61400-1 Ed2

# properties.design_bases.items.properties.turbulence.anyOf[].properties.category.description
Specify characteristic turbulence consistent with IEC61400-1 Ed2

# properties.design_bases.items.properties.turbulence.anyOf[].properties.characteristic_turbulence_intensity.description
Value of turbulence intensity I at 15m/s, specified as a fraction (eg 0.13)

# properties.design_bases.items.properties.turbulence.anyOf[].properties.slope.description
Specify the slope parameter (a). No slope parameter is used for 61400-1 editions 3 or 4.

# properties.design_bases.items.properties.turbulence.anyOf[].title
Normal and Extreme Turbulence Models varying with Wind Speed

# properties.design_bases.items.properties.turbulence.anyOf[].description
Specify Normal and Extreme Turbulence Models (NTM, ETM) using turbulence intensity as a function of wind speed

# properties.design_bases.items.properties.turbulence.anyOf[].$comment
The extreme_turbulence_intensity property is not required, to enable legacy entries from earlier standard editions, but should be included where possible

# properties.design_bases.items.properties.turbulence.anyOf[].properties.category.description
Specify the turbulence category as custom

# properties.design_bases.items.properties.turbulence.anyOf[].properties.extreme_turbulence_intensity.description
Extreme value of I for each wind speed, specified as a fraction (eg 0.13)

# properties.design_bases.items.properties.turbulence.anyOf[].properties.normal_turbulence_intensity.description
Normal value of I for each wind speed, specified as a fraction (eg 0.13)

# properties.design_bases.items.properties.turbulence.anyOf[].properties.wind_speed.description
Wind speed in m/s for each entry in the Normal and Extreme Turbulence Model arrays. Wind speed range must cover the entire operating range (below cut-in to above maximum cut-out).

# properties.design_bases.items.properties.turbulence.anyOf[].title
Normal and Extreme Turbulence Models (NETM) varying with Wind Speed and Lifetime Hours

# properties.design_bases.items.properties.turbulence.anyOf[].description
Specify Normal Turbulence Model (NTM) as a function of wind speed and lifetime hours, and Extreme Turbulence Models (ETM) as a function of wind speed.

# properties.design_bases.items.properties.turbulence.anyOf[].properties.extreme_turbulence_intensity.description
Extreme value of I for each wind speed, specified as a fraction (eg 0.13)

# properties.design_bases.items.properties.turbulence.anyOf[].properties.normal_hours_per_lifetime.description
2d array containing the number of hours spent, through-life, for each wind speed (row) and probability interval (column) [h]

# properties.design_bases.items.properties.turbulence.anyOf[].properties.normal_turbulence_intensity.description
2d array containing normal value of I for each wind speed (row) and probability interval (column), specified as a fraction (eg 0.13). Probability intervals represent evenly spaced bins covering the domain [0,1].

# properties.design_bases.items.properties.turbulence.anyOf[].properties.wind_speed.description
Wind speed in m/s for each entry in the Normal and Extreme Turbulence Model arrays. Wind speed range must cover the entire operating range (below cut-in to above maximum cut-out).

# properties.document.$comment
We've added metadata into a property of `document` to facilitate addition of more prescriptive or specific (ie non dublin-core) properties in the future

# properties.document.properties.metadata.description
Add metadata according to the Dublin Core Metadata Initiative (DCMI) elements/1.1. See https://www.dublincore.org/specifications/dublin-core/dcmi-terms/#section-3 for detailed information on each element.

# properties.power_curves.description
Contains power and thrust curves along with data specific to each operating mode of the turbine

# properties.power_curves.properties.default_operating_mode.description
The label of the mode that should be used by default (must match an entry in 'operating_modes')

# properties.power_curves.properties.operating_modes.description
Different modes that the turbine can operate in / switch between

# properties.power_curves.properties.operating_modes.items.properties.description.description
Short human readable text describing the purpose of this mode, which will be rendered into dropdowns and made searchable.

# properties.power_curves.properties.operating_modes.items.properties.description.examples[]
For general purpose operation in standard climates, or early stage site design

# properties.power_curves.properties.operating_modes.items.properties.description.examples[]
For use in noise-reduced situations eg close to population areas or sites of special scientific interest

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.description
Specify the noise (Sound Pressure Level) emitted by the turbine in this mode of operation

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.$comment
The acoustic_emissions property is not strictly required, in order to facilitate backward compatibility (entering data from existing power curve data sheets which may not contain this data). OEMs should treat this as required, however, and future versions of the standard should consider moving to requiring this field.

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.examples[].$comment
One third octave example, truncated in the wind speed dimension for brevity

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.examples[].$comment
Full octave example, truncated in the wind speed dimension for brevity

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.examples[].$comment
Total SPL example, truncated in the wind speed dimension for brevity

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.oneOf[].properties.frequency.description
Array of frequency values at one-third-octave band locations for which the Sound Pressure Levels are given. The length of this array must match the second dimension of the Sound Pressure Level matrix. The frequency range should span at least 20 bands and be sufficient that error in summation of frequency sources to total SPL is negligible for the intended purpose.

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.oneOf[].properties.frequency.$comment
At full band, 20 values is sufficient, whilst at one-third octave the opposite is true, so 20 items is used as a cutoff criterion between one-third and full-band definitions.

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.oneOf[].properties.sound_pressure_level.title
Sound Pressure Level (one-third octave intervals)

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.oneOf[].properties.sound_pressure_level.description
The sound pressure level [db], specified as a matrix for the given ranges of wind speed and frequency. Total sound pressure level can be derived by summation along the frequency dimension using the logarithmic method.

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.oneOf[].properties.sound_pressure_level.$comment
The sound_pressure_level property is not strictly required for the same reason that its parent, the `acoustic_emissions` property is not required (some existing power curves provide total sound pressure level only). It is however strongly recommended, again for the same reason.

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.oneOf[].properties.frequency.description
Array of frequency values at full-octave band locations for which the Sound Pressure Levels are given. The length of this array must match the second dimension of the Sound Pressure Level matrix. The frequency range should span less than 20 bands and be sufficient that error in summation of frequency sources to total SPL is negligible for the intended purpose.

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.oneOf[].properties.frequency.$comment
The schema team determined that at full band, 20 values is more than enough to span the range, whilst at one-third octave the opposite is true, so 20 items is used as a cutoff criterion for one-third and full-band definitions.

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.oneOf[].properties.sound_pressure_level.title
Sound Pressure Level (one-third octave intervals)

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.oneOf[].properties.sound_pressure_level.description
The sound pressure level [db], specified as a matrix for the given ranges of wind speed and frequency. Total sound pressure level can be derived by summation along the frequency dimension using the logarithmic method.

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.oneOf[].properties.sound_pressure_level.$comment
The sound_pressure_level property is not strictly required for the same reason that its parent, the `acoustic_emissions` property is not required (some existing power curves provide total sound pressure level only). It is however strongly recommended, again for the same reason.

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.oneOf[].properties.sound_pressure_level.description
The total sound pressure level [db], specified for each value of wind speed. Total sound pressure level can be derived by summation along the frequency dimension using the logarithmic method.

# properties.power_curves.properties.operating_modes.items.properties.acoustic_emissions.oneOf[].properties.sound_pressure_level.$comment
Providing total sound pressure levels is not recommended, in favour of one-third band (which covers all users cases), but is provided to enable legacy power curve documents containing only Total SPL information to be encoded.

# properties.power_curves.properties.operating_modes.items.properties.cuts.description
A list of the cut in and out conditions relevant to this power curve

# properties.power_curves.properties.operating_modes.items.properties.cuts.items.properties.kind.description
Select the kind of cut in characteristic to apply

# properties.power_curves.properties.operating_modes.items.properties.cuts.items.properties.period.description
The number of seconds that the reference wind speed is met to apply the cut in/out action [s]

# properties.power_curves.properties.operating_modes.items.properties.cuts.items.properties.wind_speed.description
The wind speed at which the cut in/out will apply [m/s]

# properties.power_curves.properties.operating_modes.items.properties.design_bases.description
A list of the design basis labels relevant to this power curve

# properties.power_curves.properties.operating_modes.items.properties.label.description
A string key identifying the mode, e.g. `power_optimised_1`

# properties.power_curves.properties.operating_modes.items.properties.name.description
A human-readable name for the mode, eg `Power Optimised 1 (PO1)`

# properties.power_curves.properties.operating_modes.items.properties.overrides.description
Override of certain data in the `turbine` section, where that data conflicts with requirements of a mode. For example, some operating modes may reduce rated power, or require a more restrictive range of hub heights for structural reasons

# properties.power_curves.properties.operating_modes.items.properties.parameters.description
Independent parameters for which the power and thrust curves are described

# properties.power_curves.properties.operating_modes.items.properties.parameters.items.allOf[].then.properties.values.description
Values of air density [kg/m^3] for which this power curve is tabulated

# properties.power_curves.properties.operating_modes.items.properties.parameters.items.allOf[].then.properties.values.description
Values of free-stream wind speed [m/s] at hub height for which this power curve is tabulated

# properties.power_curves.properties.operating_modes.items.properties.parameters.items.allOf[].then.properties.values.description
Values of turbulence intensity I [-] (expressed as a factor in the range 0,1 rather than a percentage) for which this power curve is tabulated

# properties.power_curves.properties.operating_modes.items.properties.parameters.items.allOf[].then.properties.values.description
Values of turbulence integral lengthscale l [m] for which this power curve is tabulated

# properties.power_curves.properties.operating_modes.items.properties.parameters.items.allOf[].then.properties.values.description
Values of the the Monin-Obukhov stability parameter zeta [-] for which this power curve is tabulated. Values of zero indicate neutral conditions, vegative condi

# properties.power_curves.properties.operating_modes.items.properties.parameters.items.allOf[].then.properties.values.description
Values of wind shear coefficient alpha [-] for which this power curve is tabulated

# properties.power_curves.properties.operating_modes.items.properties.parameters.items.allOf[].then.properties.values.description
Values of wind direction [???? degrees clockwise from true north????] for which this power curve is tabulated

# properties.power_curves.properties.operating_modes.items.properties.parameters.items.properties.dimension.description
Dimension of the power curve array along which this parameter varies (0-based)

# properties.power_curves.properties.operating_modes.items.properties.parameters.items.properties.label.description
A slugified string key used to identify the parameter (e.g. air-density).

# properties.power_curves.properties.operating_modes.items.properties.power.description
Electrical power expressed as dimensional values or as nondimensional coefficients (as determined by the `power_is_coefficient` property), defined as an N-D array (where N is the number of independent parameters) at the sample points described in the `parameters` property.

# properties.power_curves.properties.operating_modes.items.properties.power.oneOf[].title
2 Parameters (2D Array, e.g. air-density and wind-speed)

# properties.power_curves.properties.operating_modes.items.properties.power.oneOf[].title
3 Parameters (3D Array, e.g. turbulent-intensity, air-density and wind-speed)

# properties.power_curves.properties.operating_modes.items.properties.power.oneOf[].title
4 Parameters (4D Array, e.g. monin-obukhov-stability, turbulent-intensity, air-density and wind-speed)

# properties.power_curves.properties.operating_modes.items.properties.power_is_coefficient.description
True if the `power` array is in nondimensional coefficient form, False if the `power` array contains dimensional Power [W].

# properties.power_curves.properties.operating_modes.items.properties.thrust.description
Thrust expressed as dimensional values or as coefficients (as determined by the `thrust_is_coefficient` property), defined as an N-D array (where N is the number of independent parameters) at the sample points described in the `parameters` property. This array should be the same size and shape as the `power` value. Where coefficient values are provided for a single air density or other parameter, singleton dimensions should be expanded (ie repeat columns to match the size of the `power` array).

# properties.power_curves.properties.operating_modes.items.properties.thrust.oneOf[].title
2 Parameters (2D Array, e.g. air-density and wind-speed)

# properties.power_curves.properties.operating_modes.items.properties.thrust.oneOf[].title
3 Parameters (3D Array, e.g. turbulent-intensity, air-density and wind-speed)

# properties.power_curves.properties.operating_modes.items.properties.thrust.oneOf[].title
4 Parameters (4D Array, e.g. monin-obukhov-stability, turbulent-intensity, air-density and wind-speed)

# properties.power_curves.properties.operating_modes.items.properties.thrust_is_coefficient.description
True if the `thrust` array is in nondimensional coefficient form, False if the `thrust` array contains dimensional Thrust [kgms^-2]

# properties.turbine.description
General information about the physical turbine and its default operational values

# properties.turbine.properties.manufacturer_display_name.description
Shortened or informal name of the manufacturer (for display purposes, eg in dropdown selectors). See also manufacturer_name.

# properties.turbine.properties.manufacturer_name.description
Full name of the manufacturer (eg a legal entity)

# properties.turbine.properties.model_description.description
General description about the turbine model, eg for giving a brief overview in a turbine selection tool.

# properties.turbine.properties.model_description.examples[]
An example simple turbine with only one mode.

# properties.turbine.properties.model_name.description
Name of the turbine model as stated on the Type Certificate, Design Evaluation Confirmity Statement or Statement of Compliance.

# properties.turbine.properties.number_of_blades.description
The number of blades (typically 3, occasionally 2)

# properties.turbine.properties.platform_description.description
Optional general description of the platform on which this turbine model is based.

# properties.turbine.properties.platform_description.examples[]
The 1.x Series platform was designed as a basis for a range of small-scale onshore turbines versatile for a range of site conditions.

# properties.turbine.properties.platform_name.description
Optional name of the platform on which this turbine model is based.

# properties.turbine.properties.rotor_diameter.description
Nominal rotor diameter of the turbine [m]

# properties.turbine.properties.rotor_tilt.description
Shaft angle relative to horizontal used for calculation of inflow losses [degrees]

# $defs.acoustic_emissions_frequency.description
Array of center-band frequency values for full-octave or one-third-octave band locations, for which the Sound Pressure Levels are given. The length of this array must match the second dimension of the Sound Pressure Level matrix.

# $defs.acoustic_emissions_margin.description
A recommended margin of error [dB] which may be added to the given sound pressure levels for practical use.

# $defs.acoustic_emissions_weighting.description
Weighting filter that has been applied to sound pressure level measurements (see IEC 61672:2003 for definitions of curves).

# $defs.acoustic_emissions_wind_speed.description
Array of wind speed values, referred to hub height, for which the Sound Pressure Levels are given. The length of this array must match the leading dimension of the Sound Pressure Level matrix and the length of the total_sound_pressure_level array. The range of wind speeds should span the operating region of the power curve.

# $defs.available_hub_heights.description
Specify either a discrete list or a continuous range of available hub heights [m]. This value may be overriden on a per-mode basis.

# $defs.available_hub_heights.anyOf[].title
Specify a range of available hub heights [m]

# $defs.available_hub_heights.anyOf[].description
Specify a range of available hub heights [m]

# $defs.available_hub_heights.anyOf[].title
Specify a list of discrete available hub heights [m]

# $defs.available_hub_heights.anyOf[].description
Specify a list of discrete available hub heights [m]

# $defs.cut_in_rpm.description
Nominal rotational speed at cut-in (specify 0 for stall-regulated devices) [RPM]. This value may be overriden on a per-mode basis.

# $defs.grid_frequencies.description
The allowable design grid frequencies in Hz

# $defs.rated_power.description
Nominal rated power of the turbine in W. Used for preliminary sizing and search. This value may be overridden on a per-mode basis.

# $defs.rated_rpm.description
Nominal rotational speed at rated power (or at peak power for stall-regulated devices) [RPM]. This value may be overriden on a per-mode basis.

# $defs.thermal_shutdown.examples[].derating[].$comment
Linear ramp down in low temperatures, altitude 2500

# $defs.thermal_shutdown.examples[].derating[].$comment
Linear ramp down in low temperatures, altitude 1250

# $defs.thermal_shutdown.examples[].derating[].$comment
Linear ramp down in low temperatures, altitude 0

# $defs.thermal_shutdown.examples[].derating[].$comment
Linear ramp down to zero in high temperatures, altitude 2500

# $defs.thermal_shutdown.examples[].derating[].$comment
Linear ramp down to zero in high temperatures, altitude 1250

# $defs.thermal_shutdown.examples[].derating[].$comment
Linear ramp down to zero in high temperatures, altitude 0

# $defs.thermal_shutdown.examples[].derating[].$comment
Linear ramp down in low temperatures, air density 1.3

# $defs.thermal_shutdown.examples[].derating[].$comment
Linear ramp down in low temperatures, air density 1.225

# $defs.thermal_shutdown.examples[].derating[].$comment
Linear ramp down in low temperatures, air density 0.9

# $defs.thermal_shutdown.examples[].derating[].$comment
Nonlinear reduction in high temperatures, air density 1.3

# $defs.thermal_shutdown.examples[].derating[].$comment
Nonlinear reduction in high temperatures, air density 1.225

# $defs.thermal_shutdown.examples[].derating[].$comment
Nonlinear reduction in high temperatures, air density 0.9

# $defs.thermal_shutdown.properties.cold.properties.restart_duration.description
Time delay between restart temperature being exceded and turbine switching on [s]

# $defs.thermal_shutdown.properties.cold.properties.restart_temperature.description
Temperature above which the turbine will restart following a thermal shutdown

# $defs.thermal_shutdown.properties.cold.properties.shutdown_temperature.description
Temperature below which the turbine will shut down

# $defs.thermal_shutdown.properties.derating.description
Define any number of thermal derating curves to limit power performance in extreme temperature ranges. Curves can be based on either altitude or air density.

# $defs.thermal_shutdown.properties.derating.items.oneOf[].properties.altitude.description
The altitude at which this derating curve applies [m above the WGS84 spheroid]

# $defs.thermal_shutdown.properties.derating.items.oneOf[].properties.power_limit.description
A list of power limits each corresponding to an atmospheric temperature value in the previous list [W]

# $defs.thermal_shutdown.properties.derating.items.oneOf[].properties.temperature.description
A list of atmospheric temperature values [degrees C]

# $defs.thermal_shutdown.properties.derating.items.oneOf[].properties.air_density.description
The air density at which this derating curve applies [kg/m^3]

# $defs.thermal_shutdown.properties.derating.items.oneOf[].properties.power_limit.description
A list of power limits each corresponding to an atmospheric temperature value in the previous list [W]

# $defs.thermal_shutdown.properties.derating.items.oneOf[].properties.temperature.description
A list of atmospheric temperature values [degrees C]

# $defs.thermal_shutdown.properties.hot.properties.restart_duration.description
Time delay between temperature going below the restart temperature, and turbine switching on [s]

# $defs.thermal_shutdown.properties.hot.properties.restart_temperature.description
Temperature below which the turbine will restart following a thermal shutdown

# $defs.thermal_shutdown.properties.hot.properties.shutdown_temperature.description
Temperature above which the turbine will shut down