Structure dict extension

.github/ISSUE_TEMPLATE/01-bug-report.yml

@@ -7,7 +7,7 @@ body:
   - type: checkboxes
     id: checks
     attributes:
-      label: Bug report checklis
+      label: Bug report checklist
       options:
         - label: >
             Searched the [issues page](https://github.com/e2nIEE/pandapower/issues) for similar reports
@@ -48,9 +48,9 @@ body:
         Please follow [this guide](https://matthewrocklin.com/blog/work/2018/02/28/minimal-bug-reports) on how to
         provide a minimal, copy-pastable example.
       placeholder: >
-        from pandapower.create import create_empty_network
+        from pandapower.network import pandapowerNet
 
-        net = create_empty_network()
+        net = pandapowerNet(name="Bug Report")
 
         ...
       render: python

.github/workflows/github_test_action.yml

@@ -30,7 +30,7 @@ jobs:
     timeout-minutes: 20
     strategy:
       matrix:
-        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
+        python-version: [ '3.11', '3.12', '3.13', '3.14' ]
         # Reminder: when removing the support of an old python version here, then don't forget to
         # remove it also in pyproject.toml 'requires-python' and the release pipelines
         group: [ 1, 2 ]
@@ -41,13 +41,13 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install dependencies
-        if: ${{ (matrix.python-version != '3.10') && (matrix.python-version != '3.11') }}
+        if: ${{matrix.python-version != '3.11'}}
         run: |
           uv sync --extra all --extra test --extra pandamodels --extra pgm
           uv pip install pytest-split
           uv pip uninstall juliacall
-      - name: Install dependencies
-        if: ${{ (matrix.python-version == '3.10') || (matrix.python-version == '3.11') }}
+      - name: Install dependencies # Test without pgm
+        if: ${{matrix.python-version == '3.11'}}
         run: |
           uv sync --extra all --extra test --extra pandamodels
           uv pip install pytest-split
@@ -78,7 +78,7 @@ jobs:
     timeout-minutes: 30
     strategy:
       matrix:
-        #python-version: ['3.10', '3.14']
+        #python-version: ['3.11', '3.14']
         # Reminder: when removing the support of an old python version here, then don't forget to
         # remove it also in pyproject.toml 'requires-python' and the release pipelines
         group: [ 1, 2, 3, 4 ]
@@ -241,7 +241,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
+        python-version: [ '3.11', '3.12', '3.13', '3.14' ]
     steps:
     - uses: actions/checkout@v6
     - name: Install uv
@@ -251,11 +251,10 @@ jobs:
     - name: Install dependencies
       run: |
         uv sync --extra test
-        uv pip install setuptools
-        if [ -f requirements.txt ]; then uv pip install -r requirements.txt; fi        
+        uv pip install setuptools    
         uv pip install matplotlib
         uv pip install lxml
-        if ${{ matrix.python-version != '3.10' }}; then uv pip install numba; fi
+        if ${{ matrix.python-version != '3.11' }}; then uv pip install numba; fi
     - name: Install pandapipes and simbench
       run: |
         uv pip install git+https://github.com/e2nIEE/pandapipes@develop#egg=pandapipes
@@ -278,7 +277,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.10']
+        python-version: [ '3.11' ]
     steps:
     - uses: actions/checkout@v6
     - name: Install uv
@@ -354,20 +353,25 @@ jobs:
     - name: List of installed packages
       run: |
         uv pip list
-    - name: Create test_schema in sandbox database
+    - name: Test postgresql available
+      # Test that will fail the pipeline if the tests would be skipped. Prevents pipeline success if psycopg import fails
       env:
-        PGPASSWORD: secret
+        DSN: 'postgresql://test_user:secret@localhost:55432/sandbox'
+        SCHEMA: 'test_schema'
       run: |
-        psql -h localhost -U test_user -d sandbox -c "CREATE SCHEMA test_schema AUTHORIZATION test_user"
-        psql -h localhost -U test_user --list sandbox
+        uv run python -c "import sys; from pandapower.test.api.test_sql_io import POSTGRESQL_AVAILABLE; sys.exit(not POSTGRESQL_AVAILABLE);"
     - name: Test pandapower File I/O
+      env:
+        DSN: 'postgresql://test_user:secret@localhost/sandbox'
+        SCHEMA: 'test_schema'
       run: |
-        uv run python -c "import os; import json; from pandapower import pp_dir; conn_data={'host': 'localhost', 'user': 'test_user', 'database': 'sandbox', 'password': 'secret', 'schema': 'test_schema'}; fp = open(os.path.join(pp_dir, 'test', 'test_files', 'postgresql_connect_data.json'), 'w'); json.dump(conn_data, fp); fp.close()"
-        uv run python -c "from pandapower import pp_dir; import pytest; import sys; import os; ec = pytest.main([os.path.join(pp_dir,'test','api','test_sql_io.py')]); sys.exit(ec)"
+        uv run pytest pandapower/test/api/test_sql_io.py
     - name: Test pandapower File I/O against alternative port
+      env:
+        DSN: 'postgresql://test_user:secret@localhost:55432/sandbox'
+        SCHEMA: 'test_schema'
       run: |
-        uv run python -c "import os; import json; from pandapower import pp_dir; conn_data={'host': 'localhost', 'user': 'test_user', 'database': 'sandbox', 'password': 'secret', 'schema': 'test_schema', 'port': 55432}; fp = open(os.path.join(pp_dir, 'test', 'test_files', 'postgresql_connect_data.json'), 'w'); json.dump(conn_data, fp); fp.close()"
-        uv run python -c "from pandapower import pp_dir; import pytest; import sys; import os; ec = pytest.main([os.path.join(pp_dir,'test','api','test_sql_io.py')]); sys.exit(ec)"
+        uv run pytest pandapower/test/api/test_sql_io.py
 
   tutorial_tests:
     needs: build
@@ -417,7 +421,7 @@ jobs:
       - name: Check sphinx build
         uses: ammaraskar/sphinx-action@54e52bfb642e9b60ea5b6bcb05fe3f74b40d290a #8.2.3
         with:
-          pre-build-command: "python -m pip install uv && uv pip install .[dev] --system --link-mode=copy"
+          pre-build-command: "python -m pip install uv && uv pip install .[docs] --system --link-mode=copy"
           build-command: "sphinx-build -b html . _build -W"
           docs-folder: "doc/"
 

.github/workflows/test_release.yml

@@ -20,7 +20,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
+        python-version: [ '3.11', '3.12', '3.13', '3.14' ]
         os:  [ ubuntu-latest, windows-latest ]
         group: [ 1, 2, 3, 4 ]
 
@@ -41,16 +41,16 @@ jobs:
       - name: Install specific dependencies (Windows)
         if: matrix.os  == 'windows-latest'
         run: |
-          if ( '${{ matrix.python-version }}'  -eq '3.10' ) { uv pip install pypower }
-          if ( '${{ matrix.python-version }}'  -ne '3.10' ) { uv pip install numba }
-          if ( '${{ matrix.python-version }}'  -eq '3.11' ) { uv pip install lightsim2grid }
+          if ( '${{ matrix.python-version }}'  -eq '3.11' ) { uv pip install pypower }
+          if ( '${{ matrix.python-version }}'  -ne '3.11' ) { uv pip install numba }
+          if ( '${{ matrix.python-version }}'  -eq '3.12' ) { uv pip install lightsim2grid }
 
       - name: Install specific dependencies (Ubuntu)
         if: matrix.os  == 'ubuntu-latest'
         run: |
-          if ${{ matrix.python-version == '3.10' }}; then uv pip install pypower; fi
-          if ${{ matrix.python-version != '3.10' }}; then uv pip install numba; fi
-          if ${{ matrix.python-version == '3.11' }}; then uv pip install lightsim2grid; fi
+          if ${{ matrix.python-version == '3.11' }}; then uv pip install pypower; fi
+          if ${{ matrix.python-version != '3.11' }}; then uv pip install numba; fi
+          if ${{ matrix.python-version == '3.12' }}; then uv pip install lightsim2grid; fi
 
       - name: List all installed packages
         run: |

.github/workflows/upload_release.yml

@@ -30,6 +30,10 @@ jobs:
     permissions:
       id-token: write
 
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pandapower/
+
     # Steps represent a sequence of tasks that will be executed as part of the job
     steps:
       # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
@@ -38,7 +42,7 @@ jobs:
       # Sets up python3
       - uses: actions/setup-python@v6
         with:
-          python-version: '3.10'
+          python-version: '3.11'
 
       # Installs and upgrades pip, installs other dependencies and installs the package
       - name: Install dependencies
@@ -70,8 +74,8 @@ jobs:
       - name: Build and Upload to PyPI
         if: ${{ inputs.upload_server == 'pypi' }}
         uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e #release/v1
-        with:
-          repository-url: https://upload.pypi.org/legacy/
+        #with:
+        #  repository-url: https://upload.pypi.org/legacy/
         #run: |
         #  python3 -m build
         #  python3 -m twine check dist/* --strict

.gitignore

@@ -2,6 +2,7 @@
 *~
 build/
 .pytest_cache/
+.mypy_cache/
 dist/
 .cache/
 .idea
@@ -12,6 +13,7 @@ doc/api/
 doc/.build/*
 doc/_build/*
 doc/elements/table_structures/
+doc/std_types/tables/
 *.ipynb_checkpoints
 .cache
 *__pycache__*
@@ -31,7 +33,7 @@ pandapower/timeseries/logs/*
 /.vscode/
 pandapower/test/opf/buffer_file.json
 pandapower/test/buffer_file.json
-/pandapower/test/test_files/postgresql_connect_data.json
 sonar-project.properties
 .scannerwork/
 uv.lock
+*.code-workspace

CHANGELOG.rst

@@ -4,9 +4,55 @@ Change Log
 [upcoming 4.0.0] - 2026-..-..
 -------------------------------
 - [ADDED] pandera network validation
+- [CHANGED] removed deprecated trafo support characteristics table (replaced by trafo_characteristc_table)
+- [ADDED] create function for trafo characteristic entries
+- [ADDED] converter for trafo characteristics
+- [FIXED] create_gen and create_gens now use connected bus voltage limits as generator voltage-limit defaults.
 
 [upcoming release] - 2026-..-..
 -------------------------------
+- [FIXED] speedup dump_to_geojson_node_branch
+- [FIXED] added the LV Schutterwald network to the network documentation.
+- [FIXED] restored ``OpenDSSDirect.py`` to the ``all``/``dev`` extras so the OpenDSS converter is exercised (and its coverage reported) in CI again; it was dropped in #3062 because installing it alongside ``pytest~=9.1`` crashed the pytest process on Windows. Root cause (see `dss-extensions/OpenDSSDirect.py#148 <https://github.com/dss-extensions/OpenDSSDirect.py/issues/148>`_): pytest enables Python's ``faulthandler`` by default, which intercepts a first-chance Windows structured exception that OpenDSSDirect.py's native backend raises -- and normally handles itself -- during import, and misreports it as fatal. Bracketing the import with ``faulthandler.disable()``/``.enable()`` avoids the false crash while leaving ``faulthandler`` protecting the rest of the test run; the converter now runs on Windows instead of merely skipping there.
+- [ADDED] OpenDSS converter: series (bus-to-bus) ``Reactor`` elements are now imported as a fixed-impedance ``line``, the pattern some feeder libraries (e.g. EPRI's Ckt5/Ckt7) use to model the substation's Thevenin-equivalent source impedance instead of a ``Transformer``.
+- [FIXED] impedance element docs: the ``z_tf`` equation used ``rft_pu`` instead of ``rtf_pu``, and the ``gt_pu``/``bt_pu``/``gt0_pu``/``bt0_pu`` shunt parameters were described as being at the ``from_bus`` instead of the ``to_bus``.
+- [FIXED] fixed tutorial for plotting with pyqt
+
+[3.5.4] - 2026-07-08
+-------------------------------
+- [UPDATED] versions of dependent libraries
+- [FIXED] improved from_json even further
+
+[3.5.3] - 2026-07-07
+-------------------------------
+- [FIXED] moved a misleading logger.warning message
+
+[3.5.2] - 2026-07-06
+-------------------------------
+- [REMOVED] direct dependency to helmpy, if you want to use it, you have to install it manually or uncomment the line in pyproject.toml. Otherwise pypi.org rejects the package.
+
+[3.5.1] - 2026-07-06
+-------------------------------
+- [FIXED] upload pipeline
+
+[3.5.0] - 2026-07-06
+-------------------------------
+- [ADDED] toolbox: :code:`compute_switch_flows` computes power flow through zero-impedance bus-bus switches via nodal balance
+- [ADDED] Redispatch optimizer based on a custom formulation in pandamodels.jl, supports cost based and power based redispatch.
+- [ADDED] OpenDSS converter: ``from_opendss`` imports an OpenDSS feeder into a balanced positive-sequence pandapower net (revisits #1442).
+- [FIXED] OPF: fixed generalized cost Hessian evaluation in ``opf_costfcn``.
+- [FIXED] kwargs handling in pandamodels functions
+- [ADDED] added optional init_pq parameter to the PandaModels opf runpm wrappers for active/reactive power starts
+- [ADDED] zigzag earthing transformer vector groups (`ZNyn`, `ZNd`, `ZNy`, `ZN`) in the zero-sequence short-circuit model. Per the YNzn zero-sequence model (IEC / transformer references), the zigzag winding completely decouples the primary and secondary zero sequences, presenting a low-impedance shunt-to-ground at its terminal: the HV-winding leakage portion (`si0_hv_partial`) in series with the neutral earthing impedance `3·(rn_ohm + j·xn_ohm)` at the star point. An earthed-wye secondary (`ZNyn`) gets its own decoupled zero-sequence path to ground (LV leakage portion + zero-sequence magnetising); a delta / unearthed secondary (`ZNd`/`ZNy`) has none. Enables single-phase earth-fault studies on delta-fed systems earthed via a zigzag transformer.
+- [ADDED] `rn_ohm` (resistive neutral earthing impedance) for two-winding transformers; the neutral earthing impedance `(rn_ohm + j*xn_ohm)` is now applied as `3*Z_N` to the zero sequence of all earthed-star vector groups in the short-circuit calculation (previously `xn_ohm` was only considered for power station unit transformers, and only as a reactance). Enables modelling neutral earthing resistors (NER/NGR) for single-phase earth-fault studies.
+- [FIXED] gen for 3ph load flow, so load flow is run without errors.
+- [ADDED] hardening of from_json function with a white list
+- [FIXED] (Log)SplineCharacteristic now have their own de-/serializer
+- [ADDED] HELMpy as an additional solver
+- [CHANGED] sql_io now requires single dsn string for database connection instead of separate host, user, etc. keywords.
+- [FIXED] sql_io not working with version of psycopg installed
+- [FIXED] cim2pp add GeographicalRegion from eqbd profile
+- [FIXED] behavior of PowerFactory2pp-converter if coordinates are saved at cpSubstat.
 - [CHANGED] differing behavior for :code:`in_service=False` depending on `voltage_depend_loads` has been fixed. Out of Service elements for res_bus now always contain `nan` as result.
 - [FIXED] `DiscreteTapControl` to work with `negative tap_step_percent`.
 - [CHANGED] updated the contributing file and documentation
@@ -17,17 +63,21 @@ Change Log
 - [ADDED] check to check if vkr_percent values are reasonable (see issue #786).
 - [FIXED] cim2pp shift_lv_degree was translated from wrong entry
 - [FIXED] UnboundLocalError in _from_ppc_branch when creating impedance elements
+- [FIXED] incompatible network versions (i.e. networks with newer format versions than the currently installed pandapower version) are identified in convert_format and raise an error
 - [ADDED] LTDS support
 - [FIXED] ucte2pp: voltage setpoints from gens connected to the same busbar are now averaged
 - [FIXED] ucte2pp: small X values are clipped to 0.05 Ohm (according to UCTE-DEF) to increase convergence
 - [FIXED] ucte2pp: symmetrical tap changers are now handled as symmetrical tap changers in pandapower (not ideal phase shifters)
 - [FIXED] ucte2pp: prevent nan values for impedances and transformers for B/G/P_fe/i0
-- [FIXED] cim2pp: CimConverter backwards-compatible (default value for cin_version)
+- [FIXED] cim2pp: CimConverter backwards-compatible (default value for cim_version)
 - [FIXED] jao converter: calculation of trafo parameters is based on primary side (hv) now
 - [ADDED] toolbox: :code:`get_all_elements` returns all elements of a pp.pandapowerNet as a DataFrame
 - [ADDED] plotting: highlighting feature and hovering functionality to :code:`simple_plot()`
 - [FIXED] pf2pp: :code:`app.GetActiveScenario().loc_name` can be :code:`None`
+- [FIXED] pf2pp: static generator without a bus does not cause import errors (it is ignored)
 - [ADDED] plotting: added a toggleable colormap feature to :code:`simple_plot`
+- [ADDED] introducing pypowsybl to pandapower converter
+- [ADDED] cim2pp: mapping SV data to the assets with flag use_sv_data_for_assets=True
 
 [3.4.0] - 2026-02-09
 -------------------------------

CONTRIBUTING.md

@@ -192,7 +192,7 @@ tests for the toolbox functions. You then add a new test function to this file:
 ```python
 def test_double_rated_power():
    init_sn_mva = 100
-   net = create_empty_network(sn_mva=init_sn_mva)
+   net = pandapowerNet(name="test_double_rated_power", sn_mva=init_sn_mva)
    assert net.sn_mva == init_sn_mva
    double_rated_power(net)
    assert net.sn_mva == init_sn_mva*2

README.rst

@@ -87,17 +87,17 @@ pandapower's sibling project *pandapipes*. `pandapipes.org <https://www.pandapip
 pandapower is a joint development of the research group of the Department for Sustainable Electrical Energy Systems (e2n), University of Kassel and the Department for Distribution System
 Operation at the Fraunhofer Institute for Energy Economics and Energy System Technology (IEE), Kassel.
 
-.. image:: https://www.pandapower.org/images/contact/Logo_e2n.png
-    :target: https://www.uni-kassel.de/eecs/en/sections/energiemanagement-und-betrieb-elektrischer-netze/home
+.. image:: https://www.pandapower.org/images/contact/Logo_e2n_Originalfarben.svg
+    :target: https://www.uni-kassel.de/eecs/e2n/startseite.html
     :width: 500
 
 |
 
-.. image:: https://www.pandapower.org/images/contact/Logo_Fraunhofer_IEE.png
+.. image:: https://www.pandapower.org/images/contact/Logo_Fraunhofer_IEE.svg
     :target: https://www.iee.fraunhofer.de/en.html
     :width: 500
 
 |
 
 We welcome contributions to pandapower of any kind - if you want to contribute, please check out the
-`contribution guidelines <https://github.com/e2nIEE/pandapower/blob/develop/CONTRIBUTING.rst>`__.
+`contribution guidelines <https://github.com/e2nIEE/pandapower?tab=contributing-ov-file>`__.

doc/_exts/save_std_types.py

@@ -0,0 +1,42 @@
+"""
+Created on Fri Jul  1 13:40:07 2016
+
+@author: thurner
+"""
+import os
+import shutil
+
+from pandapower.std_types import available_std_types
+from pandapower.network import pandapowerNet
+from pandapower.network_structure import get_structure_dict
+
+file_path = os.path.dirname(os.path.realpath(__file__))
+
+
+def save_std_types(_):
+    path = os.path.join(file_path, '..', 'std_types', 'tables')
+    if os.path.isdir(path):
+        shutil.rmtree(path)
+    os.makedirs(path)
+    print("Generating std_types csv files")
+
+    structure_dict = get_structure_dict(required_only=False)
+    net = pandapowerNet(name="save_pp_std_types")
+
+    for type_ in net.std_types.keys():
+        types = available_std_types(net, type_)
+        if type_ in structure_dict:
+            columns = [c for c in types.columns if structure_dict[type_]]
+        else:
+            columns = types.columns  # fuse is not contained in structure dict
+        types = types.reindex(columns, axis=1)
+        types.to_csv(os.path.join(path, f"{type_}_std_types.csv"), sep=";")
+
+
+def setup(app):
+    app.connect('builder-inited', save_std_types)
+    return {'version': '0.1'}
+
+
+if __name__ == '__main__':
+    save_std_types(None)

doc/conf.py

@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-#
 # jsonpy documentation build configuration file, created by
 # sphinx-quickstart on Fri May 03 17:30:42 2013.
 #
@@ -37,7 +35,9 @@
     'sphinx.ext.napoleon',
     'sphinxcontrib.imagesvg',
     'numpydoc',
-    'gen_csv',
+    # custom extensions:
+    'save_element_tables',
+    'save_std_types'
 ]
 # sphinx.ext.mathjax and sphinx.ext.imgmath don't comply with each other any more.
 

doc/converter.rst

@@ -18,4 +18,5 @@ These tools are:
     converter/cgmes
     converter/ucte
     converter/jao
+    converter/opendss