Skip to content

Merge links into nodes: Documentation - #1553

Open
mgovers wants to merge 13 commits into
mainfrom
pgm/feature/link-supernode-docs
Open

Merge links into nodes: Documentation#1553
mgovers wants to merge 13 commits into
mainfrom
pgm/feature/link-supernode-docs

Conversation

@mgovers

@mgovers mgovers commented Aug 26, 2026

Copy link
Copy Markdown
Member
  • Add documentation for link component represented as infinite admittance edge
  • Add core design to include topology reducer, link solver + optimizer

Explicitly scoped out: document the actual link solving algorithm.

Signed-off-by: Martijn Govers <Martijn.Govers@Alliander.com>
Signed-off-by: Martijn Govers <Martijn.Govers@Alliander.com>
Signed-off-by: Martijn Govers <Martijn.Govers@Alliander.com>
Signed-off-by: Martijn Govers <Martijn.Govers@Alliander.com>
Signed-off-by: Martijn Govers <Martijn.Govers@Alliander.com>
Signed-off-by: Martijn Govers <Martijn.Govers@Alliander.com>
Signed-off-by: Martijn Govers <Martijn.Govers@Alliander.com>
@mgovers mgovers self-assigned this Aug 26, 2026
@mgovers mgovers added documentation Improvements or additions to documentation do-not-merge This should not be merged labels Aug 26, 2026
@mgovers
mgovers changed the base branch from feature/link-registration-dual-code-path to main August 26, 2026 14:03
@mgovers
mgovers changed the base branch from main to pgm/feature/link-supernode-output-enabled August 26, 2026 14:06
@Jerry-Jinfeng-Guo

Copy link
Copy Markdown
Member

Let's also adjust the ordering of components after Edge. Now Link still lives inside the Branch family.

Base automatically changed from pgm/feature/link-supernode-output-enabled to main August 31, 2026 16:05
figueroa1395 and others added 4 commits September 1, 2026 10:01
Signed-off-by: Santiago Figueroa Manrique <santiago.figueroa.manrique@alliander.com>
Signed-off-by: Santiago Figueroa Manrique <santiago.figueroa.manrique@alliander.com>
Signed-off-by: Santiago Figueroa Manrique <santiago.figueroa.manrique@alliander.com>
@figueroa1395

Copy link
Copy Markdown
Member

Let's also adjust the ordering of components after Edge. Now Link still lives inside the Branch family.

I believe I addressed it in 927e8e1

@figueroa1395
figueroa1395 marked this pull request as ready for review September 1, 2026 08:57
@figueroa1395

Copy link
Copy Markdown
Member

Throughout the documentation, we make reference to branches when talking about from/to side, flows, etc. Do we want to replace those with edges (or both) everywhere?

@sonarqubecloud

sonarqubecloud Bot commented Sep 1, 2026

Copy link
Copy Markdown

```{note}
1. Due to the high admittance of a `link` it is chosen that a power sensor cannot be coupled to a `link`, even though a
link is a `branch`
1. Due to the high admittance of a `link` it is chosen that a power sensor cannot be coupled to a `link`.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
1. Due to the high admittance of a `link` it is chosen that a power sensor cannot be coupled to a `link`.
1. Due to the high admittance of a `link`, it is chosen that a power sensor cannot be coupled to a `link`.

It measures the active/reactive power flow of a terminal.
The terminal is either connecting an `appliance` and a `node`, or connecting the from/to end of a `branch` (except
`link`) and a `node`.
The terminal is either connecting an `appliance` and a `node`, or connecting the from/to end of a `branch` and a `node`.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
The terminal is either connecting an `appliance` and a `node`, or connecting the from/to end of a `branch` and a `node`.
The terminal is always connected to a `node` on the one side, and either `appliance`, or the from/to end of a `branch` on the other.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do-not-merge This should not be merged documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants