Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

CGMES export as bus/branch: unit test to clarify behaviour with non-retained open switches #3370

Merged
merged 5 commits into from
Mar 25, 2025

Conversation

zamarrenolm
Copy link
Member

@zamarrenolm zamarrenolm commented Mar 18, 2025

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?

Related to #3318

What kind of change does this PR introduce?

Additional unit test.

The goal is to show that when using bus/branch exports of a node/breaker network, you should close all non-retained open switches in your case before exporting it, if you plan to use the exported files for later calculations (and want to keep the maximum amount of connectivity).

What is the current behavior?

Having non-retained open switches in a network that is exported as bus/branch may result in multiple connectivity components in the exported network.

What is the new behavior (if this is a feature change)?

No behaviour is changed. The unit tests tries to clarify potential issues with bus/branch export of node/breaker networks that contain non-retained open switches.

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

  • Yes
  • No

If yes, please check if the following requirements are fulfilled

  • The Breaking Change or Deprecated label has been added
  • The migration steps are described in the following section

What changes might users need to make in their application due to this PR? (migration steps)

Other information:

The unit test uses a simple node/breaker network:
Screenshot 2025-03-16 at 23 22 57
where the disconnectors are open and marked as non-retained, and the breakers are also open and retained.

Exporting the network as bus/branch from this situation produces the following:
Screenshot 2025-03-16 at 23 24 42
In this exported network, the generator and the load can not be reconnected to the rest of the network, even after closing the retained breakers.

If the non-retained switches are closed BEFORE exporting to bus/branch, the exported network will keep the possibility of reconnecting these equipment:
Screenshot 2025-03-18 at 12 21 47

Copy link
Member

@rcourtier rcourtier left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The tests are great. Could you please also add some comment in the documentation (grid exchange formats/cgmes/export/topology-kind) to highlight that situation to users?

@zamarrenolm
Copy link
Member Author

The tests are great. Could you please also add some comment in the documentation (grid exchange formats/cgmes/export/topology-kind) to highlight that situation to users?

documentation added

@olperr1
Copy link
Member

olperr1 commented Mar 21, 2025

@zamarrenolm: Can you also fix the DCO problem on your last commit?

@zamarrenolm zamarrenolm force-pushed the cgmes_bus_branch_export_non_retained_open_switches branch from 077e4e8 to dac62f6 Compare March 25, 2025 09:03
@zamarrenolm
Copy link
Member Author

@zamarrenolm: Can you also fix the DCO problem on your last commit?

fixed the problem with DCO

@olperr1 olperr1 force-pushed the cgmes_bus_branch_export_non_retained_open_switches branch from 8a012da to d1a68b6 Compare March 25, 2025 12:31
@olperr1 olperr1 requested a review from rcourtier March 25, 2025 12:32
@olperr1 olperr1 merged commit 455fd74 into main Mar 25, 2025
8 checks passed
@olperr1 olperr1 deleted the cgmes_bus_branch_export_non_retained_open_switches branch March 25, 2025 13:13
olperr1 pushed a commit that referenced this pull request Mar 25, 2025
…etained open switches (#3370)

* unit test to clarify bus/branch export with non-retained open switches
* add documentation
* move paragraph

Signed-off-by: Luma <[email protected]>
(cherry picked from commit 455fd74)
olperr1 pushed a commit that referenced this pull request Mar 25, 2025
…etained open switches (#3370)

* unit test to clarify bus/branch export with non-retained open switches
* add documentation
* move paragraph

Signed-off-by: Luma <[email protected]>
(cherry picked from commit 455fd74)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

3 participants