Security analysis#
The security analysis module allows to simulate contingencies (the loss of a line or a generator, for example) in a “batch” mode, in AC mode.
Run a security analysis#
You can run a security analysis using the following methods:
Creates a security analysis objet, which can be used to run a security analysis on a network |
|
Runs an AC security analysis. |
|
Runs a DC security analysis. |
|
Set the default security analysis provider. |
|
Get the current default security analysis provider. |
|
Get list of supported provider names |
Parameters#
The execution of the security analysis can be customized using security analysis parameters.
Parameters for a security analysis execution. |
|
Parameters which define what violations should be considered as "increased" between N and post-contingency situations |
|
Get list of parameters for the specified security analysis provider. |
Define contingencies and monitored elements#
You can define contingencies to be simulated, as well as network elements to be monitored, with the following methods:
Add one N-1 contingency. |
|
Add one N-K contingency. |
|
Add multiple N-1 contingencies. |
|
Add elements to be monitored by the security analysis. |
|
Add elements to be monitored by the security analysis on precontingency state. |
|
Add elements to be monitored by the security analysis for specific contingencies. |
Define operator strategies and remedial actions#
You can define operator strategies and remedial actions with the following methods:
Add a load action, modifying the load active power |
|
Add a load action, modifying the load reactive power |
|
Add a generator action, modifying the generator active power |
|
Add a switch action, modifying the switch open/close status |
|
Add an operator strategy to the specified contingency |
Results#
When the security analysis is completed, you can inspect its results:
The result of a security analysis. |
|
All limit violations in a dataframe representation. |
|
Result for the pre-contingency state. |
|
Results for the contingencies, as a dictionary contingency ID -> result. |
|
Results for the operator strategies, as a dictionary operator strategy ID -> result. |
|
Result for the specified contingency. |
|
Result for the specified operator strategy |
|
Results (P, Q, I) for monitored branches. |
|
Bus results (voltage angle and magnitude) for monitored voltage levels. |
|
Results (P, Q, I) for monitored three winding transformers. |