New LoadFlow balanceTypes and ActivePowerControl extension participation factor

pages/documentation/grid/model/extensions.md

@@ -19,18 +19,20 @@ Every extension is considered as serializable unless explicitly specified as non
 {:toc}
 
 ## Active power control
-This extension is used to configure the participation factor of the generator, typically in the case of a load flow computation with distributed slack enabled (with balance type on generator `Pmax`). This extension is attached to a [generator](index.md#generator) or a [battery](index.md#battery).
+This extension is used to configure the participation factor of the generator, typically in the case of a load flow computation with distributed slack enabled (with [balance type](../../simulation/powerflow/index.md#balanceType) on generator). This extension is attached to a [generator](index.md#generator) or a [battery](index.md#battery).
 
-| Attribute | Type | Unit | Required | Default value | Description |
-| --------- | ---- | ---- | -------- | ------------- | ----------- |
-| participate | boolean | - | yes | - | The participation status |
-| droop | double | None (repartition key) | yes | - | The participation factor equals Pmax / droop |
+| Attribute            | Type     | Unit                   | Required | Default value | Description                                  |
+|----------------------|----------|------------------------|----------|---------------|----------------------------------------------|
+| participate          | boolean  | -                      | yes      | -             | The participation status                     |
+| droop                | double   | None (repartition key) | no       | -             | The participation factor equals Pmax / droop |
+| participation factor | double   | None (repartition key) | no       | -             | Defines the participation factor explictly   |
 
 Here is how to add an active power control extension to a generator:
 ```java
 generator.newExtension(ActivePowerControlAdder.class)
     .withParticipate(true)
     .withDroop(4)
+    .withParticipationFactor(1.5)
     .add();
 ```
 

pages/documentation/simulation/powerflow/index.md

@@ -99,7 +99,9 @@ The `distributedSlack` property is an optional property that defines if the acti
 **balanceType**  
 The `balanceType` property is an optional property that defines, if `distributedSlack` parameter is set to true, how to manage the distribution. Several algorithms are supported. All algorithms follow the same scheme: only some elements are participating in the slack distribution, with a given participation factor. Three options are available:
 - If using `PROPORTIONAL_TO_GENERATION_P_MAX` then the participating elements are the generators. The participation factor is computed using the maximum active power target $$MaxP$$ and the active power control droop. The default droop value is `4`. If present, the simulator uses the droop of the generator given by the [active power control extension](../../grid/model/extensions.md#active-power-control).
-- If using `PROPORTIONAL_TO_GENERATION_P` then the participating elements are the generators. The participation factor is computed using the active power set point $$TargetP$$ and the active power control droop. The default droop value is `4`. If present, the simulator uses the droop of the generator given by the [active power control extension](../../grid/model/extensions.md#active-power-control).
+- If using `PROPORTIONAL_TO_GENERATION_P` then the participating elements are the generators. The participation factor is computed using the active power set point $$TargetP$$.
+- If using `PROPORTIONAL_TO_GENERATION_REMAINING_MARGIN` then the participating elements are the generators. The participation factor is computed using the difference between the maximum active power target $$MaxP$$ with active power set point $$TargetP$$.
+- If using `PROPORTIONAL_TO_GENERATION_PARTICIPATION_FACTOR` then the participating elements are the generators. The simulator uses the participation factors of the generators given by the [active power control extension](../../grid/model/extensions.md#active-power-control).
 - If using `PROPORTIONAL_TO_LOAD` then the participating elements are the loads. The participation factor is computed using the active power $$P0$$.
 - If using `PROPORTIONAL_TO_CONFORM_LOAD` then the participating elements are the loads which have a conform active power part. The participation factor is computed using the [load detail extension](../../grid/model/extensions.md#load-detail), which specifies the variable and the fixed parts of $$P0$$. The slack is distributed only on loads that have a variable part. If the extension is not available on a load, the whole $$P0$$ is considered as a variable.