wip

pages/documentation/grid/model/extensions.md

@@ -19,13 +19,13 @@ 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                                                                                                                                     |
-| participation factor | double   | -                      | no       | -             | Defines the participation factor explictly. To be used with the `PROPORTIONAL_TO_GENERATION_PARTICIPATION_FACTOR` [balanceType](../../simulation/powerflow/index.md#balanceType) |
+| 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

pages/documentation/simulation/powerflow/index.md

@@ -100,8 +100,8 @@ The `distributedSlack` property is an optional property that defines if the acti
 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_REMAINING_MARGIN` then the participating elements are the generators. The participation factor is computed using the active power set point $$TargetP$$ and the maximum active power target $$MaxP$$.
-- If using `PROPORTIONAL_TO_GENERATION_PARTICIPATION_FACTOR` then the participating elements are the generators. The participation factor values are read from the [active power control extension](../../grid/model/extensions.md#active-power-control) previously defined by the user.
+- 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.