openego / eDisGo / 27414215606

84%

dev: 84%

Build Type

Pull #646

github

Committed by joda9

Commit Message

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).

Pull Request Pull Request #646: docs: restructure ReadTheDocs into tiered guide with flexibility chap…

Coverage Stats

8 of 8 new or added lines in 2 files covered. (100.0%)

248 existing lines in 9 files now uncovered.

8588 of 10270 relevant lines covered (83.62%)

0.84 hits per line