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.

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