Add LineCouplings extension

[colineplqt]

Please check if the PR fulfills these requirements

• The commit message follows our guidelines
• Tests for the changes have been added (for bug fixes / features)
• Docs have been added / updated (for bug fixes / features)
• A PR or issue has been opened in all impacted repositories (if any)

Does this PR already have an issue describing the problem?

No

What kind of change does this PR introduce?

Feature

What is the current behavior?

The extension does not exist

What is the new behavior (if this is a feature change)?
A new extension of Network is created to store the mutual couplings existing on the network between two lines that are close.
This can be used for short-circuit calculations.

Does this PR introduce a breaking change or deprecate an API?

• Yes
• No

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[jeandemanged]

As it is now the link to the other line is missing. This also raises the question, if the extension is on a Line: which line should hold the mutual coupling ? Maybe this should be a network extension holding a collection of lines mutual couplings instead.

See also https://www.powerworld.com/WebHelp/Content/MainDocumentation_HTML/Mutual_Impedance_Records.htm and also CGMES ShortCircuit profile:

Note that these formats also account that portions of the lines may have different mutual couplings, e.g. two lines independent over 20 km, then one same tower over 15 km, then independent again.

[colineplqt]

As it is now the link to the other line is missing. This also raises the question, if the extension is on a Line: which line should hold the mutual coupling ? Maybe this should be a network extension holding a collection of lines mutual couplings instead.

See also https://www.powerworld.com/WebHelp/Content/MainDocumentation_HTML/Mutual_Impedance_Records.htm and also CGMES ShortCircuit profile:

Note that these formats also account that portions of the lines may have different mutual couplings, e.g. two lines independent over 20 km, then one same tower over 15 km, then independent again.

You are absolutely right. I am going to make the change to make this extension at network level. I will also add the portions of line. It is not in my use case but I thought of adding for each line two percentages indicating the beginning and the end of the mutual coupling. Thank you for checking.

[colineplqt]

As it is now the link to the other line is missing. This also raises the question, if the extension is on a Line: which line should hold the mutual coupling ? Maybe this should be a network extension holding a collection of lines mutual couplings instead.
See also https://www.powerworld.com/WebHelp/Content/MainDocumentation_HTML/Mutual_Impedance_Records.htm and also CGMES ShortCircuit profile:

Note that these formats also account that portions of the lines may have different mutual couplings, e.g. two lines independent over 20 km, then one same tower over 15 km, then independent again.

You are absolutely right. I am going to make the change to make this extension at network level. I will also add the portions of line. It is not in my use case but I thought of adding for each line two percentages indicating the beginning and the end of the mutual coupling. Thank you for checking.

I have one "problem" about having the extension at network level: what should be done if one of the line is removed from the network? I would say that it would be good to remove the associated mutual couplings, but I don't know if it is the best.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
94.8% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
91.8% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud