Merge pull request #140 from octue/reactive-power-derating

Reactive power derating

Author: thclark

power-curve-schema/examples/generic-274-20.json

@@ -70,6 +70,24 @@
           "air_density": 0.9,
           "temperature": [40, 41, 42, 43, 44, 45],
           "power_limit": [2e6, 1.98e6, 1.88e6, 2.0e6, 1.7e6, 1.1e6]
+        },
+        {
+          "legend": "High temperature derating, reactive power 0 VAr",
+          "reactive_power": 0,
+          "temperature": [35, 36, 37, 38, 39, 40],
+          "power_limit": [20e6, 18.8e6, 17.5e6, 16.5e6, 15.3e6, 14e6]
+        },
+        {
+          "legend": "High temperature derating, reactive power 1.8 MVAr",
+          "reactive_power": 1.8e6,
+          "temperature": [30, 32, 34, 36, 38, 40],
+          "power_limit": [20e6, 18e6, 16e6, 14.5e6, 13.3e6, 12.3e6]
+        },
+        {
+          "legend": "High temperature derating, reactive power 2.7 MVAr",
+          "reactive_power": 2.7e6,
+          "temperature": [30, 32, 34, 36, 38, 40, 41],
+          "power_limit": [20e6, 16.5e6, 14e6, 12.5e6, 11.2e6, 10.2e6, 0]
         }
       ],
       "cold": {

power-curve-schema/schema.json

@@ -202,7 +202,7 @@
         },
         "derating": {
           "title": "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.",
+          "description": "Define any number of thermal derating curves to limit power performance in extreme temperature ranges. Curves can be based on altitude, air density, or reactive power output.",
           "type": "array",
           "minItems": 1,
           "items": {
@@ -296,6 +296,38 @@
                     }
                   }
                 }
+              },
+              {
+                "title": "Reactive power and temperature based derating",
+                "required": ["reactive_power", "power_limit", "temperature"],
+                "additionalProperties": false,
+                "properties": {
+                  "legend": {
+                    "title": "Legend",
+                    "description": "A note related to the applicability or extra context describing the derating",
+                    "type": "string",
+                    "maxLength": 80
+                  },
+                  "reactive_power": {
+                    "description": "The absolute value of reactive power at which this derating curve applies [VAr]",
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  "temperature": {
+                    "description": "A list of atmospheric temperature values [degrees C]",
+                    "type": "array",
+                    "items": {
+                      "type": "number"
+                    }
+                  },
+                  "power_limit": {
+                    "description": "A list of power limits each corresponding to an atmospheric temperature value in the previous list [W]",
+                    "type": "array",
+                    "items": {
+                      "type": "number"
+                    }
+                  }
+                }
               }
             ]
           }

test/fixtures/generic-274-20-alpha-3.json

@@ -69,6 +69,24 @@
           "air_density": 0.9,
           "temperature": [40, 41, 42, 43, 44, 45],
           "power_limit": [2e6, 1.98e6, 1.88e6, 2.0e6, 1.7e6, 1.1e6]
+        },
+        {
+          "legend": "High temperature derating, reactive power 0 VAr",
+          "reactive_power": 0,
+          "temperature": [35, 36, 37, 38, 39, 40],
+          "power_limit": [20e6, 18.8e6, 17.5e6, 16.5e6, 15.3e6, 14e6]
+        },
+        {
+          "legend": "High temperature derating, reactive power 1.8 MVAr",
+          "reactive_power": 1.8e6,
+          "temperature": [30, 32, 34, 36, 38, 40],
+          "power_limit": [20e6, 18e6, 16e6, 14.5e6, 13.3e6, 12.3e6]
+        },
+        {
+          "legend": "High temperature derating, reactive power 2.7 MVAr",
+          "reactive_power": 2.7e6,
+          "temperature": [30, 32, 34, 36, 38, 40, 41],
+          "power_limit": [20e6, 16.5e6, 14e6, 12.5e6, 11.2e6, 10.2e6, 0]
         }
       ],
       "cold": {

test/test_turbine.py

@@ -166,3 +166,78 @@ def test_invalid_regulation_type(subschema, generic_turbine):
     with pytest.raises(ValidationError) as e:
         validate(instance=generic_turbine, schema=subschema)
     assert "'aeroflap' is not one of ['pitch', 'stall', 'other']" in str(e)
+
+
+def test_reactive_power_derating(subschema, generic_turbine):
+    """Validation should pass for reactive power based thermal derating"""
+    generic_turbine["turbine"]["thermal_regulation"] = {
+        "derating": [
+            {
+                "legend": "High temperature derating, reactive power 0 VAr",
+                "reactive_power": 0,
+                "temperature": [35, 36, 37, 38, 39, 40],
+                "power_limit": [20e6, 18.8e6, 17.5e6, 16.5e6, 15.3e6, 14e6],
+            }
+        ]
+    }
+    validate(instance=generic_turbine, schema=subschema)
+
+
+def test_reactive_power_derating_with_multiple_curves(subschema, generic_turbine):
+    """Validation should pass for multiple reactive power based thermal derating curves"""
+    generic_turbine["turbine"]["thermal_regulation"] = {
+        "derating": [
+            {
+                "legend": "High temperature derating, reactive power 0 VAr",
+                "reactive_power": 0,
+                "temperature": [35, 40],
+                "power_limit": [20e6, 14e6],
+            },
+            {
+                "legend": "High temperature derating, reactive power 6.5 MVAr",
+                "reactive_power": 6.5e6,
+                "temperature": [30, 40],
+                "power_limit": [20e6, 12.3e6],
+            },
+            {
+                "legend": "High temperature derating, reactive power 9.5 MVAr",
+                "reactive_power": 9.5e6,
+                "temperature": [30, 40, 41],
+                "power_limit": [20e6, 10.2e6, 0],
+            },
+        ]
+    }
+    validate(instance=generic_turbine, schema=subschema)
+
+
+def test_reactive_power_derating_negative_value_invalid(subschema, generic_turbine):
+    """Validation should fail for negative reactive power values"""
+    generic_turbine["turbine"]["thermal_regulation"] = {
+        "derating": [
+            {
+                "reactive_power": -1000,
+                "temperature": [35, 40],
+                "power_limit": [20e6, 14e6],
+            }
+        ]
+    }
+    with pytest.raises(ValidationError) as e:
+        validate(instance=generic_turbine, schema=subschema)
+    assert "minimum" in str(e)
+
+
+def test_reactive_power_derating_missing_required_field(subschema, generic_turbine):
+    """Validation should fail if reactive_power derating is missing temperature or power_limit"""
+    generic_turbine["turbine"]["thermal_regulation"] = {
+        "derating": [
+            {
+                "reactive_power": 0,
+                "temperature": [35, 40],
+                # missing power_limit
+            }
+        ]
+    }
+    with pytest.raises(ValidationError) as e:
+        validate(instance=generic_turbine, schema=subschema)
+    # Since derating uses anyOf, the error message indicates it doesn't match any schema
+    assert "is not valid under any of the given schemas" in str(e)