diff --git a/pages/documentation/grid/model/extensions.md b/pages/documentation/grid/model/extensions.md index ab3e8025..9b450a2c 100644 --- a/pages/documentation/grid/model/extensions.md +++ b/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 diff --git a/pages/documentation/simulation/powerflow/index.md b/pages/documentation/simulation/powerflow/index.md index cd66983a..2e61efd9 100644 --- a/pages/documentation/simulation/powerflow/index.md +++ b/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.