Configuration

The security-analysis module is used to configure the execution of the security-analysis command and simulation.

Implementation

preprocessor
The preprocessor property is an optional property which requires that the SecurityAnalysisPreprocessor with specified name is used to preprocess inputs, based on the contingency file, before actually running the security analysis.

Such a preprocessor will have the possibility to programmatically transform the following objects before the security analysis is actually executed :

  • The Network

  • The ContingenciesProvider

  • The LimitViolationDetector

  • The LimitViolationFilter

  • The SecurityAnalysisParameters

  • The SecurityAnalysisInterceptors

It enables, for example, to customize what should be considered a limit violation and what should not.

If absent, the default behavior of the tool is used: the contingency file is simply interpreted by the configured contingency provider.

YAML configuration:

security-analysis:
    preprocessor: my_custom_preprocessor_name

XML configuration:

<security-analysis>
    <preprocessor>my_custom_preprocessor_name</preprocessor>
</security-analysis>

Parameters

Violations increase thresholds

The user can provide parameters to define which violations must be raised after a contingency, if the violation was already present in the pre-contingency state (IncreasedViolationsParameters).

flow-proportional-threshold

After a contingency, only flow violations (either current, active power or apparent power violations) that have increased in proportion by more than a threshold value, compared to the pre-contingency state, are listed in the limit violations. The other ones are filtered. The threshold value is unitless and should be positive. This method gets the flow violation proportional threshold. The default value is 0.1, meaning that only violations that have increased by more than 10% appear in the limit violations.

low-voltage-proportional-threshold

After a contingency, only low-voltage violations that have increased by more than the proportional threshold compared to the pre-contingency state, are listed in the limit violations, the other ones are filtered. This method gets the low-voltage violation proportional threshold (unitless, should be positive). The default value is 0.0, meaning that only violations that have increased by more than 0.0 % appear in the limit violations (note that for low-voltage violation, it means that the voltage in the post-contingency state is lower than the voltage in the pre-contingency state).

low-voltage-absolute-threshold

After a contingency, only low-voltage violations that have increased by more than an absolute threshold compared to the pre-contingency state, are listed in the limit violations, the other ones are filtered. This method gets the low-voltage violation absolute threshold (in kV, should be positive). The default value is 0.0, meaning that only violations that have increased by more than 0.0 kV appear in the limit violations (note that for low-voltage violation, it means that the voltage in the post-contingency state is lower than the voltage in the pre-contingency state).

high-voltage-proportional-threshold

Same as before but for high-voltage violations.

high-voltage-absolute-threshold

Same as before but for high-voltage violations.

Monitoring modification thresholds

When monitoring elements both before and after contingencies, it is possible to define thresholds that limit the number of element states stored in the post-contingency state.

Thresholds on power

power-modification-threshold
After a contingency, all the monitored branches and 3 windings transformers whose power has not changed by more than the threshold (in percentage) compared to pre-contingency state are filtered from the post-contingency results. It is set at 0 by default, so it doesn’t filter anything.

Thresholds on voltage

These two following parameters are not exclusive. When both are defined, the threshold in kV that will be used will be the minimum between the value of the absolute parameter and the result of the proportional parameter applied to the pre-contingency value.

voltage-modification-proportional-threshold
After a contingency, all the monitored buses whose voltage has not changed by more than the threshold (in percentage) compared to pre-contingency state are filtered from the post-contingency results. It is set at 0 by default, so it doesn’t filter anything.

voltage-modification-absolute-threshold
After a contingency, all the monitored buses whose voltage has not changed by more than the threshold (in kV) compared to pre-contingency state are filtered from the post-contingency results. It is set at 0 by default, so it doesn’t filter anything.

Violations filtering

The violations listed in the results can be filtered to consider only a certain type of violations, to consider only a few voltage levels or to limit the geographical area by filtering equipment by countries. Check out the documentation of the limit-violation-default-filter configuration module.

Example
Using the following configuration, the results will contain only voltage violations for equipment in France or Belgium:

limit-violation-default-filter:
    countries:
        - FR
        - BE
    violationTypes:
        - LOW_VOLTAGE
        - HIGH_VOLTAGE