Plugin for interaction between QGIS and pandapower networks.
A pandapower network is opened as a data source, the way you would open a
PostgreSQL or SAP HANA database — not imported. You edit the geodata in QGIS and
the changes are written back to the same .json file. There is no import step
and no separate export step to get your work back out.
Layer → Data Source Manager → pandapower — the entry sits with the database providers, alongside PostgreSQL, SAP HANA and Oracle. Pick a network file and press Add.
The tables that carry geometry are preselected, so opening a network and putting it on the map takes two clicks. Three buttons drive the list:
- Select all — every table, including the attribute-only ones
- Select map layers — only
busandline, the ones that draw on the canvas - Add selected — adds the whole selection at once
Double-clicking a single row adds just that table.
With Add layers in a group named after the network ticked (the default), the layers land in a layer group named after the file, rather than loose at the top of the Layers panel.
The dialog lists each table with its geometry type, voltage level and feature
count, and remembers recently opened networks. A res_* table with no results
yet is greyed out and cannot be selected — run a power flow first.
Network: /data/mv_oberrhein.json [Browse...]
Table Geometry Level Features
bus Point 20.0 177
bus Point 110.0 2
line LineString 20.0 181
trafo 2
load 147
sgen 153
switch 322
res_bus 179
res_line 181
busandlinecarry geometry and are listed once per voltage level.- Tables without geometry (
trafo,load,switch, …) are listed too and open as plain attribute tables, exactly like a non-spatial table in a database. - Only tables that actually contain rows are listed. A pandapower network defines many more tables than a typical grid uses.
res_*result tables are listed as well; an empty one is greyed out until a power flow has produced results.
Result columns are also merged into the bus and line layers, which is what
lets the renderers colour buses by vm_pu and lines by loading_percent.
pandapower does not record a CRS, so the plugin assumes EPSG:4326 unless the URI says otherwise. The network's coordinates are left exactly as they are; QGIS reprojects for display. Set your project CRS as you like — your data is not rewritten.
Standard QGIS editing, with pandapower-specific validation:
- Add features (bus / line)
- Delete features (bus / line)
- Modify attribute values
- Move features (geometry changes)
Click the layer in the Layers panel, toggle editing
, and
use the Move Feature tool
to reposition a feature:
For general instructions see the QGIS documentation.
Edits are held in the layer's edit buffer and written to the .json when you
save the layer edits — the same moment QGIS would commit to any other data
source. Toggling editing off and confirming, or pressing Save Layer Edits,
writes the file.
- Rolling back an edit writes nothing. The file is untouched.
- All layers of one network share a single in-memory network, so an edit made in one layer is immediately visible in the others, and one save writes them all.
- A timestamped backup (
network.json.20231215_143022.bak) is written before the file is overwritten. - If the file changed on disk since it was opened, you are asked before it is overwritten.
line
| name | type | comment |
|---|---|---|
| from_bus | integer | pandapower id |
| to_bus | integer | pandapower id |
| std_type | string | name of a standard linetype |
bus
| name | type | default value | comment |
|---|---|---|---|
| name | string | None | |
| pp_index | int | None | these might change after export |
| type | string | b | |
| zone | string | None | |
| in_service | boolean | True | |
| max_vm_pu | float | NAN | |
| min_vm_pu | float | NAN |
line
| name | type | default value | comment |
|---|---|---|---|
| length_km | float | if not present derived from QGIS | |
| name | string | None | |
| in_service | boolean | True | |
| df | float | 1.0 | |
| parallel | integer | 1 | |
| max_loading_percent | float | ||
| pp_index | integer | None | these might change after export |
Bus deletion (cascade delete)
- Deleting a bus cascade deletes every connected element (lines, loads, transformers, generators, …)
- A confirmation dialog lists the affected elements first
- A timestamped backup is written when the change is saved
Line creation requirements
- Required fields:
from_bus,to_bus,length_km std_type:- If provided: a standard line type name (e.g.
NAYY 4x50 SE) - If NULL or empty: you must provide
r_ohm_per_km,x_ohm_per_km,c_nf_per_km
- If provided: a standard line type name (e.g.
Validation rules
from_bus/to_busmust reference existing bus IDs- Physical parameters (
length_km,r_ohm_per_km, …) must be positive - Required fields cannot be NULL
Editable tables
- Adding and deleting rows is implemented for
busandline - Other tables open read-mostly: attribute values can be changed, but rows cannot be added or deleted from QGIS
This icon is in the plugin toolbar. It runs on the network of the layer selected
in the Layers panel, or on the first pandapower network in the project if
nothing is selected. Open a network first.
- Function: which pandapower run function to use.
- Parameter (**kwargs): parameters in any of these forms:
key1=value1, key2=value2{'key1': 'value1', 'key2': value2}key1='value1', key2=value2
- Initialization:
auto,flatorresults
An unrecognised parameter name falls back to that parameter's default. See the pandapower power flow documentation.
After a run, the Results tables fill and any layer coloured by a result column repaints.
This icon is in the plugin toolbar.
Export builds a new pandapower network from arbitrary QGIS vector layers. It is a different operation from opening a network: use it to turn layers that did not come from pandapower into a network. To save changes to a network you opened with this plugin, just save the layer edits — see When changes are written.
Optional. The name given to the new pandapower network.
Default 50. The network frequency in Hz.
Default 1. The reference apparent power per unit.
Adds the pandapower standard types to the network.
All selected layers are exported. Features are taken from vector layers whose
pp_type is bus or line.
- QGIS 3.44 or newer
- pandapower 3.5 or newer (geodata is read from the
geocolumn)
See pandapower-qgis/requirements.txt for the full list.


