Feature/ucte converter

CHANGELOG.rst

@@ -17,9 +17,12 @@ Change Log
 - [FIXED] Increasing geojson precision as the default precision might cause problems with pandahub
 - [ADDED] converter for European EHV grid data from JAO, the "Single Allocation Platform (SAP) for all European Transmission System Operators (TSOs) that operate in accordance to EU legislation"
 - [ADDED] Add GeographicalRegion and SubGeographicalRegion names and ids to bus df in cim converter
+- [ADDED] API function rename_std_type()
 - [CHANGED] Capitalize first letter of columns busbar_id, busbar_name and substation_id in bus df for cim converter
+- [CHANGED] required standard type parameters are made available by function :code:`required_std_type_parameters()`
 - [FIXED] Do not modify pandas options when importing pandapower
 - [FIXED] fixed copy-paste error in contingency results "max_limit_nminus1" and "min_limit_nminus1"
+- [FIXED] default elements in toolbox function add_zones_to_elements()
 - [ADDED] improved lightsim2grid documentation including compatibitliy issues
 - [FIXED] cim2pp: set default xml encoding to None to avoid error after changing to lxml
 - [FIXED] PandaModels OPF with 'bus_dc' key errors
@@ -95,7 +98,9 @@ Change Log
 - [CHANGED] Trafo Controllers can now be added to elements that are out of service, changed self.nothing_to_do()
 - [ADDED] Discrete shunt controller for local voltage regulation with shunt steps
 - [ADDED] fix lengths missmatch of output if ignore_zero_length is False in plotting utility function coords_from_node_geodata() and rename ignore_zero_length by ignore_no_geo_diff
+- [FIXED] from_powerfactory() converter: error that crept in `obj.GetAttributes(a)` instead of `obj.GetAttribute(a)`
 - [ADDED] converter for European EHV grid data from JAO, the "Single Allocation Platform (SAP) for all European Transmission System Operators (TSOs) that operate in accordance to EU legislation"
+- [ADDED] UCTE-DEF (UCTE Data Exchange Format) converter
 - [ADDED] cim2pp converter: Using lxml to parse XML files (better performance)
 - [FIXED] OC relay name attribute error
 

doc/converter.rst

@@ -16,5 +16,6 @@ These tools are:
     converter/matpower
     converter/powerfactory
     converter/cgmes
+    converter/ucte
     converter/jao
 

doc/converter/jao.rst

@@ -1,5 +1,5 @@
-Documentation for the JAO Static Grid Model Converter Function
-==============================================================
+JAO Static Grid Model Converter Function
+========================================
 
 The ``from_jao`` function allows users to convert the Static Grid Model provided by JAO (Joint Allocation Office) into a pandapower network by reading and processing the provided Excel and HTML files.
 

doc/converter/ucte.rst

@@ -0,0 +1,12 @@
+===================================================
+UCTE-DEF to pandapower
+===================================================
+
+panpapower functionality allows to convert grid data from **UCTE** **d**ata **e**xchange **f**ormat for load flow and three phase short circuit studies (UCTE-DEF) to pandapower.
+The UCTE-DEF is a simple data format for electric transmission systems for the exchange of grid data introduced by the *Union for the Co-ordination of Transmission of Electricity (UCTE)*, the predecessor of the ENTSO-E.
+
+Using the Converter
+--------------------
+In order to start the converter the following method is used. Only the location of the UCTE file that should be converted must be specified.
+
+.. autofunction:: pandapower.converter.cim.cim2pp.from_cim.from_cim

pandapower/converter/__init__.py

@@ -1,6 +1,7 @@
 from pandapower.converter.matpower import *
 from pandapower.converter.pypower import *
 from pandapower.converter.pandamodels import *
+from pandapower.converter.ucte import *
 from pandapower.converter.cim import *
 from pandapower.converter.powerfactory import *
 from pandapower.converter.jao import *

pandapower/converter/cim/__init__.py

@@ -2,6 +2,7 @@
 
 # Copyright (c) 2016-2023 by University of Kassel and Fraunhofer Institute for Energy Economics
 # and Energy System Technology (IEE), Kassel. All rights reserved.
+
 from .cim2pp import from_cim
 
 __version__ = '3.6.10'

pandapower/converter/cim/cim2pp/from_cim.py

@@ -2,6 +2,7 @@
 
 # Copyright (c) 2016-2023 by University of Kassel and Fraunhofer Institute for Energy Economics
 # and Energy System Technology (IEE), Kassel. All rights reserved.
+
 import logging
 import time
 from typing import Union, List, Type, Dict
@@ -23,7 +24,7 @@ def from_cim_dict(cim_parser: cim_classes.CimParser, log_debug=False, convert_li
                   custom_converter_classes: Dict = None,
                   **kwargs) -> pandapower.auxiliary.pandapowerNet:
     """
-    Create a pandapower net from a CIM data structure.
+    Creates a pandapower net from a CIM data structure.
 
     :param cim_parser: The CimParser with parsed cim data.
     :param log_debug: Set this parameter to True to enable logging at debug level. Optional, default: False
@@ -105,7 +106,7 @@ def from_cim(file_list: List[str] = None, encoding: str = None, convert_line_to_
         pandapower.auxiliary.pandapowerNet:
     # Nur zum Testen, kann wieder gelöscht werden
     """
-    Convert a CIM net to a pandapower net from XML files.
+    Converts a CIM net to a pandapower net from XML files.
     Additional parameters for kwargs:
     - create_measurements (str): Set this parameter to 'SV' to create measurements for the pandapower net from the SV
     profile. Set it to 'Analog' to create measurements from Analogs. If the parameter is not set or is set to None, no

pandapower/converter/powerfactory/pp_import_functions.py

@@ -397,7 +397,7 @@ def create_bus(net, item, flag_graphics, is_unbalanced):
         'vn_kv': item.uknom,
         'in_service': not bool(item.outserv),
         'type': usage[item.iUsage],
-        'geodata': (x, y),
+        'geodata': geojson.dumps(geojson.Point((x, y))),
     }
 
     system_type = {0: "ac", 1: "dc", 2: "ac/bi"}[item.systype]

pandapower/converter/ucte/__init__.py

@@ -0,0 +1,6 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2016-2023 by University of Kassel and Fraunhofer Institute for Energy Economics
+# and Energy System Technology (IEE), Kassel. All rights reserved.
+
+from .from_ucte import from_ucte

pandapower/converter/ucte/from_ucte.py

@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2016-2023 by University of Kassel and Fraunhofer Institute for Energy Economics
+# and Energy System Technology (IEE), Kassel. All rights reserved.
+
+import logging
+import os
+import time
+from typing import Union, List, Type, Dict
+from pandapower.converter.ucte.ucte_converter import UCTE2pandapower
+from pandapower.converter.ucte.ucte_parser import UCTEParser
+
+logger = logging.getLogger('ucte.from_ucte')
+
+
+def from_ucte_dict(ucte_parser: UCTEParser):
+    """Creates a pandapower net from an UCTE data structure.
+
+    Parameters
+    ----------
+    ucte_parser : UCTEParser
+        The UCTEParser with parsed UCTE data.
+
+    Returns
+    -------
+    pandapowerNet
+        net
+    """
+
+    ucte_converter = UCTE2pandapower()
+    net = ucte_converter.convert(ucte_parser.get_data())
+
+    return net
+
+
+def from_ucte(ucte_file: str):
+    """Converts net data stored as an UCTE file to a pandapower net.
+
+
+    Parameters
+    ----------
+    ucte_file : str
+        _description_
+
+    Returns
+    -------
+    pandapowerNet
+        net
+    """
+
+    time_start_parsing = time.time()
+
+    ucte_parser = UCTEParser(ucte_file)
+    ucte_parser.parse_file()
+
+    time_start_converting = time.time()
+
+    pp_net = from_ucte_dict(ucte_parser)
+
+    time_end_converting = time.time()
+
+    logger.info("Needed time for parsing from ucte: %s" % (time_start_converting - time_start_parsing))
+    logger.info("Needed time for converting from ucte: %s" % (time_end_converting - time_start_converting))
+    logger.info("Total Time (from_ucte()): %s" % (time_end_converting - time_start_parsing))
+
+    return pp_net