openego / eDisGo / 27414215606

84%

dev: 84%

Pull #646

github

docs: add switches, PyPSA-relationship and enhanced reinforcement sections

Expand the user guide and methodology docs with three new sections:

components_overview.rst — new "Switches" section:
- explains switches as MV ring disconnecting points, modelled as a branch
  in lines_df with bus_open/bus_closed and an open/closed state
- documents what they drive: power-flow operating point, ring detection,
  where MV line reinforcement may act, and plotting
- shows the Switch object API (state, branch, bus_open/bus_closed,
  open()/close()) and how switches survive import, complexity reduction
  and to_pypsa

data_model.rst — new "Relationship to the PyPSA format" section:
- eDisGo/PyPSA component mapping table with the differing columns
- what eDisGo needs beyond PyPSA (grid hierarchy, geo-coordinates,
  component typing, flexibility containers) and what to_pypsa derives
- guidance for representing a PyPSA grid in eDisGo's ding0-based schema

grid_reinforcement.rst — rewrite the enhanced reinforcement paragraph
into a dedicated section describing the full fallback strategy:
LV-grid separation, per-LV reinforcement with splitting, the
MV/MV+MV/LV/LV sequence, and the cost-distorting last resort, including
the limitation that those measures underestimate grid-expansion costs.

Documented two known code limitations as notes: line r/x are passed to
PyPSA in ohms (PyPSA converts to per-unit, not to_pypsa) and a b column
exists but is always 0; and MV line reinforcement does not yet insert a
switch disconnector at the split point (TODO in
reinforce_lines_voltage_issues).

2 of 2 new or added lines in 1 file covered. (100.0%)

8588 of 10270 relevant lines covered (83.62%)

0.84 hits per line