Wind Farm¶

The wind farm schema deals with parameters of the wind farm. Required are a layouts definition and a turbines definition. Additional properties can be included as needed, but don’t currently have associated schemas.

name: IEA Wind Task 37 Case study 3, 25WT Wind Farm
layouts: 
    initial_layout: 
        coordinates:
            x: [
                10363.7833, 9894.9437, 8450.2895, 9008.9311, 9567.5726, 10126.2142, 7862.2807, 8537.7355, 9213.1903, 9888.6451, 7274.2718, 8066.5399, 8858.8079, 9651.0760, 6686.2630, 7371.5049, 8056.7467, 8741.9886, 9427.2305, 6098.2541, 6750.8566, 7403.4592, 8056.0622, 8708.6700, 9361.2778
            ]
            y: [
                6490.2719, 6316.9180, 6455.3421, 6043.4997, 5631.6572, 5219.8148, 5665.8933, 5093.7148, 4521.5362, 3949.3577, 4876.4446, 4143.9299, 3411.4153, 2678.9006, 4086.9958, 3416.8405, 2746.6851, 2076.5297, 1406.3743, 3297.5471, 2665.4498, 2033.3525, 1401.2557, 769.1637, 137.0718
            ]
turbines: !include ../plant_energy_turbine/IEA37_10MW_turbine.yaml

Properties¶

layoutsObject: An object that has a required property coordinates, which is an object that consists of two arrays, x and y, which contain the x- and y-coordinates for the turbines.
turbinesObject: An object containing a nested dictionary with various turbine-defining parameters. For specfic properties, see below.

turbine Properties¶

nameString

Unique identifier of the turbine.

hub_heightNumber

A number specifying the hub height of the turbine in meters.

rotor_diameterNumber

A number specifying the rotor diameter of the turbine in meters.

TSRNumber

A number specifying the tip-speed ratio of the turbine.

performanceObject

An object containing a nested dictionary of turbine performance characteristics. Required combinations of properties include:

Cp_curve and Ct_curve
power_curve and Ct_curve
rated_power, rated_wind_speed, cutin_wind_speed, cutout_wind_speed, and Ct_curve.

For specific properties, see below.

performance Properties¶

Cp_curveObject: An object containing a nested dictionary of Cp performance characteristics. Requires two arrays of Cp_values and Cp_wind_speeds.
power_curveObject: An object containing a nested dictionary of power performance characteristics. Requires two arrays of power_values and power_wind_speeds.
Ct_curveObject: An object containing a nested dictionary of Cp performance characteristics. Requires two arrays of Ct_values and Ct_wind_speeds.
rated_wind_speedNumber: A number specifying the rated wind speed of the turbine in m/s.
cutin_wind_speedNumber: A number specifying the cut-in wind speed of the turbine in m/s.
cutout_wind_speedNumber: A number specifying the cut-out wind speed of the turbine in m/s.
rated_powerNumber: A number specifying the rated power of the turbine in W.

Examples¶

Both Farm Examples and Turbine Examples are included below.

Farm Examples¶

Three farm examples are shown below, all taken from the IEA Wind Task 37 Layout Optimization Case Studies. Details of the case studies are given here.

IEA Wind Task 37 Case study 1+2, 16WT Wind Farm¶

In this example, the IEA Wind Task 37 Case study 1+2, 16WT Wind Farm is defined.

name: IEA Wind Task 37 Case study 1+2, 16WT Wind Farm
layouts: 
    initial_layout: 
        coordinates:
            x: [
                0., 650., 200.861, -525.861, -525.861, 200.861, 1300., 1051.7221,
                401.7221, -401.7221, -1051.7221, -1300., -1051.7221, -401.7221,
                401.7221, 1051.7221
            ]
            y: [
                0., 0., 618.1867, 382.0604, -382.0604, -618.1867, 0., 764.1208,
                1236.3735, 1236.3735, 764.1208, 0., -764.1208, -1236.3735, -1236.3735,
                -764.1208
            ]
turbines:
    name: IEA Wind Task 37 case study 3.35MW Onshore Reference Turbine
    performance:
        rated_power: 3350000
        rated_wind_speed: 9.8
        cutin_wind_speed: 4.0
        cutout_wind_speed: 25.0
        Ct_curve:
            Ct_values: [0, 0, 0.888888889, 0.888888889, 0, 0]
            Ct_wind_speeds: [0, 3.99, 4, 25, 25.01, 100.0]
    hub_height: 110.0
    rotor_diameter: 130.0

IEA Wind Task 37 Case study 3, 25WT Wind Farm¶

In this example, the IEA Wind Task 37 Case study 3, 25WT Wind Farm is defined.

name: IEA Wind Task 37 Case study 3, 25WT Wind Farm
layouts: 
    initial_layout: 
        coordinates:
            x: [
                10363.7833, 9894.9437, 8450.2895, 9008.9311, 9567.5726, 10126.2142, 7862.2807, 8537.7355, 9213.1903, 9888.6451, 7274.2718, 8066.5399, 8858.8079, 9651.0760, 6686.2630, 7371.5049, 8056.7467, 8741.9886, 9427.2305, 6098.2541, 6750.8566, 7403.4592, 8056.0622, 8708.6700, 9361.2778
            ]
            y: [
                6490.2719, 6316.9180, 6455.3421, 6043.4997, 5631.6572, 5219.8148, 5665.8933, 5093.7148, 4521.5362, 3949.3577, 4876.4446, 4143.9299, 3411.4153, 2678.9006, 4086.9958, 3416.8405, 2746.6851, 2076.5297, 1406.3743, 3297.5471, 2665.4498, 2033.3525, 1401.2557, 769.1637, 137.0718
            ]
turbines: !include ../plant_energy_turbine/IEA37_10MW_turbine.yaml

IEA Wind Task 37 Case study 4, 81WT Wind Farm¶

In this example, the IEA Wind Task 37 Case study 4, 81WT Wind Farm is defined.

name: IEA Wind Task 37 Case study 4, 81WT Wind Farm
layouts: 
    initial_layout: 
        coordinates:
            x: [
                10363.7833, 9894.9437, 8450.2895, 9022.1294, 9593.9692, 10165.8090, 7979.8825, 8642.5333, 9305.1840, 9967.8348, 7509.4754, 8074.5717, 8639.6679, 9204.7642, 9769.8606, 7039.0683, 7672.2728, 8305.4773, 8938.6818, 9571.8863, 6568.6612, 7277.1539, 7985.6467, 8694.1395, 9402.6323, 6098.2541, 6750.8566, 7403.4592, 8056.0622, 8708.6700, 9361.2778, 8297.1401, 7057.9009, 7755.3966, 6537.0543, 7213.6530, 6016.2077, 6671.9094, 5495.3611, 6130.1658, 4974.5145, 5588.4223, 3267.0701, 4145.9677, 5107.1349, 6054.6902, 2213.8627, 2951.0233, 3743.0302, 4525.9626, 1160.6553, 1756.0788, 2378.9255, 2997.2350, 107.4479, 561.1344, 1014.8209, 1468.5074, 6764.9216, 6034.3987, 4878.0741, 5729.6775, 3934.6503, 4573.3529, 5212.0555, 2991.2265, 3842.8300, 4694.4335, 2047.8027, 2757.4723, 3467.1419, 4176.8115, 8953.7052, 7846.3157, 6738.9262, 5631.5367, 4524.1472, 8001.0152, 6893.6257, 5806.1713, 7048.3252
            ]
            y: [
                6490.2719, 6316.9180, 6455.3421, 6114.0806, 5772.8191, 5431.5577, 5823.7831, 5340.1365, 4856.4899, 4372.8434, 5192.2241, 4722.7003, 4253.1766, 3783.6529, 3314.1291, 4560.6651, 3984.3525, 3408.0400, 2831.7274, 2255.4149, 3929.1061, 3244.9222, 2560.7382, 1876.5542, 1192.3703, 3297.5471, 2665.4498, 2033.3525, 1401.2557, 769.1637, 137.0718, 7398.8969, 7669.1317, 6677.3823, 7017.0094, 5955.8679, 6364.8870, 5234.3534, 5712.7647, 4512.8390, 5060.6424, 3791.3245, 10100.6305, 9596.9976, 9278.5659, 8925.3415, 9767.0876, 9359.4397, 8951.7917, 8544.1437, 9433.5446, 8951.7917, 8586.4789, 8162.9460, 9100.0017, 8660.5839, 8221.1661, 7781.7483, 8399.6839, 7957.6709, 7928.0749, 7103.2410, 7692.2704, 7073.6450, 6455.0196, 7456.4659, 6631.6320, 5806.7981, 7220.6614, 6533.2998, 5845.9382, 5158.5767, 11901.4945, 11550.7937, 11200.0929, 10849.3921, 10498.6913, 10716.4728, 10365.7720, 10066.8889, 9531.4511
            ]
turbines: !include ../plant_energy_turbine/IEA37_10MW_turbine.yaml

Turbine Examples¶

Three IEA Wind Task 37 reference turbine definitions are given below as examples of how to define turbines within the wind plant schema.

IEA Wind Task 37 3.35MW Reference Turbine¶

In this example, the IEA 37 3.35MW reference turbine is specified using the rated power, rated/cut-in/cut-out wind speeds, the Ct curve, hub height, and rotor diameter.

name: IEA Wind Task 37 case study 3.35MW Onshore Reference Turbine
performance:
  rated_power: 3350000
  rated_wind_speed: 9.8
  cutin_wind_speed: 4.0
  cutout_wind_speed: 25.0
  Ct_curve:
    Ct_values: [0,0,.888888889,.888888889,0,0]
    Ct_wind_speeds: [0,3.99,4, 25,25.01,100.0]
hub_height: 110.0
rotor_diameter: 130.0

IEA Wind Task 37 10MW Reference Turbine¶

In this example, the IEA 37 10MW reference turbine is specified using the rated power, rated/cut-in/cut-out wind speeds, the Ct curve, hub height, and rotor diameter.

name: IEA Wind Task 37 10MW Offshore Reference Turbine
performance:
  rated_power: 10000000
  rated_wind_speed: 11.0
  cutin_wind_speed: 4.0
  cutout_wind_speed: 25.0
  Ct_curve:
    Ct_values: [0.770113776, 0.776301765, 0.782430404, 0.781982993, 0.780246928, 0.777153006, 0.771853687, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.776845963, 0.767521911, 0.765104347, 0.758675026, 0.505649564, 0.431035612, 0.370827539, 0.320855929, 0.278805531, 0.243151019, 0.212773558, 0.186803785, 0.164542221, 0.145414565, 0.128943645, 0.114730283, 0.102438991, 0.091786964, 0.082535328, 0.074482009, 0.067455867, 0.061311766, 0.05592648,  0.051195261, 0.047029125]
    Ct_wind_speeds: [4.0, 4.514652562, 5.000795688, 5.457350016, 5.883301884, 6.277705571, 6.639685402, 6.968437691, 7.263232527, 7.523415391, 7.748408611, 7.937712648, 8.090907197, 8.20765213, 8.287688244, 8.330837837, 8.337005108, 8.367833853, 8.435590166, 8.540123611, 8.681202099, 8.858512398, 9.071660837, 9.320174171, 9.603500641, 9.921011189, 10.27200086, 10.65569038, 10.75773635, 11.51769068, 11.9940876, 12.49936091, 13.03238875, 13.59198769, 14.17691527, 14.7858728, 15.41750825, 16.07041923, 16.74315611, 17.43422525, 18.1420923, 18.86518562, 19.60189976, 20.35059904, 21.10962115, 21.87728087, 22.65187381, 23.43168018, 24.21496861, 25.0]
hub_height: 119.0
rotor_diameter: 198.0

IEA Wind Task 37 15MW Reference Turbine¶

In this example, the IEA 37 15MW reference turbine is specified using the Cp/Ct curves, hub height, and rotor diameter.

name: IEA Wind Task 37 15MW Offshore Reference Turbine
performance:
  Cp_curve:
    Cp_values: [0.100335552, 0.272197208, 0.359305118, 0.409156685, 0.42729002, 0.441819614, 0.452708049, 0.475270298, 0.479478644, 0.482871263, 0.484447627, 0.485186337, 0.485905846, 0.487114154, 0.488094793, 0.488866488, 0.488988058, 0.489050152, 0.489088858, 0.489114531, 0.489127764, 0.48915576, 0.489165047, 0.489154466, 0.489163867, 0.489224161, 0.489263048, 0.48928802, 0.489293116, 0.489304304, 0.489319143, 0.48938292, 0.489378059, 0.486507177, 0.472991558, 0.470349316, 0.467724941, 0.465119143, 0.462537044, 0.462021882, 0.461765284, 0.461636557, 0.46150846, 0.461380941, 0.461317766, 0.459972382, 0.447424184, 0.435324299, 0.406934831, 0.380965216, 0.357157168, 0.335295525, 0.263718683, 0.211136579, 0.171651956, 0.108080744, 0.072394937, 0.050842443, 0.037062292]
    Cp_wind_speeds: [2.999999831, 3.499999916, 4, 4.500000084, 4.750000126, 5.000000169, 5.249999874, 5.999999663, 6.199999966, 6.40000027, 6.499999747, 6.55000016, 6.599999899, 6.700000051, 6.800000202, 6.900000354, 6.919999845, 6.929999928, 6.94000001, 6.950000093, 6.960000175, 6.969999584, 6.980000341, 6.989999749, 6.999999831, 7.499999916, 8, 8.500000084, 9.000000169, 9.500000253, 10.00000034, 10.2499997, 10.49999975, 10.60000057, 10.70000005, 10.72000022, 10.73999971, 10.76000055, 10.78000004, 10.78400034, 10.78600049, 10.78699989, 10.78799997, 10.78899937, 10.78950042, 10.8000002, 10.89999968, 10.99999983, 11.24999987, 11.50000059, 11.75000063, 11.99999933, 12.99999949, 13.99999966, 14.99999983, 17.50000025, 20.00000067, 22.49999975, 24.99999882]
  Ct_curve:
    Ct_values: [0.819748943, 0.801112031, 0.808268424, 0.821910918, 0.822876237, 0.823265981, 0.830989358, 0.834932456, 0.833618598, 0.83180478, 0.829011103, 0.826909201, 0.824740997, 0.820429675, 0.816176257, 0.811200233, 0.809740903, 0.808780765, 0.808102306, 0.807566626, 0.807251977, 0.80662442, 0.806495512, 0.806806173, 0.806651158, 0.805469658, 0.804571567, 0.803949121, 0.803904895, 0.803708734, 0.80345211, 0.801706154, 0.801777393, 0.768657554, 0.70731525, 0.698507743, 0.690211963, 0.682335591, 0.674835939, 0.673371183, 0.672646111, 0.672283185, 0.671921569, 0.671564033, 0.671386994, 0.667639697, 0.635292304, 0.607277698, 0.548965866, 0.501379105, 0.460982977, 0.425965654, 0.32116631, 0.2511023, 0.201415182, 0.125653944, 0.08506697, 0.061026446, 0.045814967]
    Ct_wind_speeds: [2.999999831, 3.499999916, 4, 4.500000084, 4.750000126, 5.000000169, 5.249999874, 5.999999663, 6.199999966, 6.40000027, 6.499999747, 6.55000016, 6.599999899, 6.700000051, 6.800000202, 6.900000354, 6.919999845, 6.929999928, 6.94000001, 6.950000093, 6.960000175, 6.969999584, 6.980000341, 6.989999749, 6.999999831, 7.499999916, 8, 8.500000084, 9.000000169, 9.500000253, 10.00000034, 10.2499997, 10.49999975, 10.60000057, 10.70000005, 10.72000022, 10.73999971, 10.76000055, 10.78000004, 10.78400034, 10.78600049, 10.78699989, 10.78799997, 10.78899937, 10.78950042, 10.8000002, 10.89999968, 10.99999983, 11.24999987, 11.50000059, 11.75000063, 11.99999933, 12.99999949, 13.99999966, 14.99999983, 17.50000025, 20.00000067, 22.49999975, 24.99999882]
hub_height: 150.0
rotor_diameter: 240.0