pyedb 0.34.2__tar.gz → 0.35.0__tar.gz

{pyedb-0.34.2 → pyedb-0.35.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pyedb
-Version: 0.34.2
+Version: 0.35.0
 Summary: Higher-Level Pythonic Ansys Electronics Data Base
 Author-email: "ANSYS, Inc." <pyansys.core@ansys.com>
 Maintainer-email: PyEDB developers <simon.vandenbrouck@ansys.com>
@@ -21,13 +21,13 @@ Requires-Dist: ansys-pythonnet >= 3.1.0rc4
 Requires-Dist: dotnetcore2 ==3.1.23;platform_system=='Linux'
 Requires-Dist: numpy>=1.20.0,<3
 Requires-Dist: pandas>=1.1.0,<2.3
-Requires-Dist: pydantic>=2.6.4,<2.10
+Requires-Dist: pydantic>=2.6.4,<2.11
 Requires-Dist: Rtree >= 1.2.0
 Requires-Dist: toml == 0.10.2
 Requires-Dist: scikit-rf
 Requires-Dist: ansys-sphinx-theme>=0.10.0,<1.1 ; extra == "doc"
 Requires-Dist: imageio>=2.30.0,<2.37 ; extra == "doc"
-Requires-Dist: ipython>=8.13.0,<8.31 ; extra == "doc"
+Requires-Dist: ipython>=8.13.0,<8.32 ; extra == "doc"
 Requires-Dist: jupyterlab>=4.0.0,<4.4 ; extra == "doc"
 Requires-Dist: jupytext>=1.16.0,<1.17 ; extra == "doc"
 Requires-Dist: matplotlib>=3.5.0,<3.10 ; extra == "doc"
@@ -76,7 +76,7 @@ Provides-Extra: tests
 
 ## What is PyEDB?
 
-PyEDB is Python client library for processing complex and large layout designs in the
+PyEDB is a Python client library for processing complex and large layout designs in the
 Ansys Electronics Database (EDB) format, which stores information describing designs for
 [Ansys Electronics Desktop](https://www.ansys.com/products/electronics) (AEDT).
 
@@ -102,7 +102,7 @@ HFSS 3D Layout, Icepak, Maxwell, Q3D, and SIwave.
 
 EDB provides a proprietary database file format (AEDB) for efficient and fast layout design
 handling and processing for building ready-to-solve projects. EDB addresses signal integrity
-(SI), power integrity (PI-DC), and electro-thermal work flows. You can import an AEDB file
+(SI), power integrity (PI-DC), and electro-thermal workflows. You can import an AEDB file
 into AEDT to modify the layout, assign materials, and define ports, simulations, and constraints.
 You can then launch any of the Ansys electromagnetic simulators.
 
@@ -112,7 +112,7 @@ memory, it provides the fastest and most efficient way to handle a large and com
 
 You can also parse an AEDB file from a command line in batch in an Ansys electromagnetic simulator
 like HFSS or SIwave. Thus, you can deploy completely non-graphical flows, from layout
-translation through simulatiom results.
+translation through simulation results.
 
 Additionally, you can use PyAEDT to import an AEDB file into AEDT to view a project,
 combine 3D designs, or perform simulation postprocessing. EDB also supports 3D component models.

{pyedb-0.34.2 → pyedb-0.35.0}/README.md

@@ -13,7 +13,7 @@
 
 ## What is PyEDB?
 
-PyEDB is Python client library for processing complex and large layout designs in the
+PyEDB is a Python client library for processing complex and large layout designs in the
 Ansys Electronics Database (EDB) format, which stores information describing designs for
 [Ansys Electronics Desktop](https://www.ansys.com/products/electronics) (AEDT).
 
@@ -39,7 +39,7 @@ HFSS 3D Layout, Icepak, Maxwell, Q3D, and SIwave.
 
 EDB provides a proprietary database file format (AEDB) for efficient and fast layout design
 handling and processing for building ready-to-solve projects. EDB addresses signal integrity
-(SI), power integrity (PI-DC), and electro-thermal work flows. You can import an AEDB file
+(SI), power integrity (PI-DC), and electro-thermal workflows. You can import an AEDB file
 into AEDT to modify the layout, assign materials, and define ports, simulations, and constraints.
 You can then launch any of the Ansys electromagnetic simulators.
 
@@ -49,7 +49,7 @@ memory, it provides the fastest and most efficient way to handle a large and com
 
 You can also parse an AEDB file from a command line in batch in an Ansys electromagnetic simulator
 like HFSS or SIwave. Thus, you can deploy completely non-graphical flows, from layout
-translation through simulatiom results.
+translation through simulation results.
 
 Additionally, you can use PyAEDT to import an AEDB file into AEDT to view a project,
 combine 3D designs, or perform simulation postprocessing. EDB also supports 3D component models.

{pyedb-0.34.2 → pyedb-0.35.0}/pyproject.toml

@@ -31,7 +31,7 @@ dependencies = [
     "dotnetcore2 ==3.1.23;platform_system=='Linux'",
     "numpy>=1.20.0,<3",
     "pandas>=1.1.0,<2.3",
-    "pydantic>=2.6.4,<2.10",
+    "pydantic>=2.6.4,<2.11",
     "Rtree >= 1.2.0",
     "toml == 0.10.2",
     "scikit-rf"
@@ -50,7 +50,7 @@ tests = [
 doc = [
     "ansys-sphinx-theme>=0.10.0,<1.1",
     "imageio>=2.30.0,<2.37",
-    "ipython>=8.13.0,<8.31",
+    "ipython>=8.13.0,<8.32",
     "jupyterlab>=4.0.0,<4.4",
     "jupytext>=1.16.0,<1.17",
     "matplotlib>=3.5.0,<3.10",

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/__init__.py

@@ -44,7 +44,7 @@ deprecation_warning()
 #
 
 pyedb_path = os.path.dirname(__file__)
-__version__ = "0.34.2"
+__version__ = "0.35.0"
 version = __version__
 
 #

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/configuration/cfg_components.py

@@ -201,7 +201,7 @@ class CfgComponent(CfgBase):
         if height:
             port_prop.SetReferenceHeight(self._pedb.edb_value(height))
         reference_size_auto = self.port_properties.get("reference_size_auto")
-        if reference_size_auto:
+        if reference_size_auto is not None:
             port_prop.SetReferenceSizeAuto(reference_size_auto)
         reference_size_x = self.port_properties.get("reference_size_x", 0)
         reference_size_y = self.port_properties.get("reference_size_y", 0)
@@ -210,10 +210,10 @@ class CfgComponent(CfgBase):
         self._pyedb_obj.component_property = cp
 
     def set_parameters_to_edb(self):
-        if self.enabled:
-            self._pyedb_obj.enabled = self.enabled
         if self.type:
             self._pyedb_obj.type = self.type
+        if self.enabled:
+            self._pyedb_obj.enabled = self.enabled
 
         self._set_model_properties_to_edb()
         if self._pyedb_obj.type.lower() == "ic":

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/configuration/cfg_modeler.py

@@ -97,6 +97,7 @@ class CfgModeler:
             for p in self.padstack_instances:
                 p_inst = self._pedb.padstacks.place(
                     via_name=p.name,
+                    net_name=p.net_name,
                     position=p.position,
                     definition_name=p.definition,
                 )

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/configuration/cfg_pin_groups.py

@@ -67,17 +67,16 @@ class CfgPinGroup(CfgBase):
     def create(self):
         """Apply pin group on layout."""
         if self.pins:
-            self._pedb.siwave.create_pin_group(self.reference_designator, list(self.pins), self.name)
+            pins = self.pins if isinstance(self.pins, list) else [self.pins]
+            self._pedb.siwave.create_pin_group(self.reference_designator, pins, self.name)
         elif self.net:
-            if self.reference_designator in self._pedb.components.instances:
-                comp = self._pedb.components.instances[self.reference_designator]
-            else:
-                raise f"Component not found for creating pin group {self.name}."
-            pins = [p for p, obj in comp.pins.items() if obj.net_name in self.net]
+            nets = self.net if isinstance(self.net, list) else [self.net]
+            comp = self._pedb.components.instances[self.reference_designator]
+            pins = [p for p, obj in comp.pins.items() if obj.net_name in nets]
             if not self._pedb.siwave.create_pin_group(self.reference_designator, pins, self.name):
-                self._pedb.logger.error(f"Failed to create pin group {self.name}")
+                raise RuntimeError(f"Failed to create pin group {self.name}")
         else:
-            self._pedb.logger.error(f"No net and pins defined for defining pin group {self.name}")
+            raise RuntimeError(f"No net and pins defined for defining pin group {self.name}")
 
     def export_properties(self):
         if self.pins:

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/configuration/cfg_ports_sources.py

@@ -265,7 +265,7 @@ class CfgCircuitElement(CfgBase):
             pins = {pos_value: self._pedb.components.instances[self.reference_designator].pins[pos_value]}
             pos_objs.update(pins)
         else:
-            raise f"Wrong positive terminal type {pos_type}"
+            raise Exception(f"Wrong positive terminal type {pos_type}.")
 
         self.pos_terminals = {i: j.create_terminal(i) for i, j in pos_objs.items()}
         self.pos_terminals.update(pos_coor_terminal)
@@ -297,9 +297,12 @@ class CfgCircuitElement(CfgBase):
                     # create pin group
                     neg_obj = self._create_pin_group(pins, True)
                 elif neg_type == "pin":
-                    neg_obj = {neg_value: self._pedb.components.instances[self.reference_designator].pins[neg_value]}
+                    terminal_name = f"{self.reference_designator}_{neg_value}"
+                    neg_obj = {
+                        terminal_name: self._pedb.components.instances[self.reference_designator].pins[neg_value]
+                    }
                 else:
-                    raise f"Wrong negative terminal type {neg_type}"
+                    raise Exception(f"Wrong negative terminal type {neg_type}.")
                 self.neg_terminal = [
                     j.create_terminal(i) if not j.terminal else j.terminal for i, j in neg_obj.items()
                 ][0]

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/configuration/cfg_stackup.py

@@ -45,6 +45,7 @@ class CfgLayer(CfgBase):
         self.fill_material = kwargs.get("fill_material", None)
         self.thickness = kwargs.get("thickness", None)
         self.roughness = kwargs.get("roughness", None)
+        self.etching = kwargs.get("etching", None)
 
 
 class CfgStackup:

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/configuration/configuration.py

@@ -134,13 +134,17 @@ class Configuration:
 
         # Configure stackup
         if kwargs.get("fix_padstack_def"):
+            from pyedb.configuration.cfg_padstacks import CfgPadstackDefinition
+
             pedb_defs = self._pedb.padstacks.definitions
-            temp = {}
-            for name, pdef in pedb_defs.items():
-                temp[name] = pdef.get_properties()
+            temp = []
+            for _, pdef in pedb_defs.items():
+                cfg_def = CfgPadstackDefinition(self._pedb, pdef)
+                cfg_def.retrieve_parameters_from_edb()
+                temp.append(cfg_def)
             self.cfg_data.stackup.apply()
-            for name, pdef_p in temp.items():
-                pedb_defs[name].set_properties(**pdef_p)
+            for cfg_pdef in temp:
+                cfg_pdef.set_parameters_to_edb()
         else:
             self.cfg_data.stackup.apply()
 

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/dotnet/clr_module.py

@@ -45,7 +45,7 @@ if is_linux:  # pragma: no cover
 
             runtime = get_coreclr()
             load(runtime)
-            os.environ["DOTNET_ROOT"] = str(runtime.dotnet_root)
+            os.environ["DOTNET_ROOT"] = runtime.dotnet_root.as_posix()
             is_clr = True
         # TODO: Fall backing to dotnetcore2 should be removed in a near future.
         except Exception:
@@ -83,7 +83,7 @@ if is_linux:  # pragma: no cover
     if dotnet_root is not None and runtime_config is not None:
         try:
             load("coreclr", runtime_config=str(runtime_config), dotnet_root=str(dotnet_root))
-            os.environ["DOTNET_ROOT"] = dotnet_root
+            os.environ["DOTNET_ROOT"] = dotnet_root.as_posix()
             if "mono" not in os.getenv("LD_LIBRARY_PATH", ""):
                 warnings.warn("LD_LIBRARY_PATH needs to be setup to use pyedb.")
                 warnings.warn("export ANSYSEM_ROOT242=/path/to/AnsysEM/v242/Linux64")

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/dotnet/edb.py

@@ -4564,6 +4564,7 @@ class Edb(Database):
             port_poly = cloned_edb.modeler.create_polygon(
                 main_shape=void_info[0].polygon_data._edb_object, layer_name="ref", net_name="GND"
             )
+            port_poly.scale(1.1)
             pec_poly = cloned_edb.modeler.create_polygon(
                 main_shape=port_poly.polygon_data._edb_object, layer_name="port_pec", net_name="GND"
             )

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/dotnet/edb_core/cell/hierarchy/pin_pair_model.py

@@ -66,7 +66,7 @@ class PinPair(object):  # pragma: no cover
     @resistance.setter
     def resistance(self, value):
         self._pin_pair_rlc.R = value
-        self._set_comp_prop(self._pin_pair_rlc)  # pragma: no cover
+        self._set_comp_prop()  # pragma: no cover
 
     @property
     def inductance(self):
@@ -75,7 +75,7 @@ class PinPair(object):  # pragma: no cover
     @inductance.setter
     def inductance(self, value):
         self._pin_pair_rlc.L = value
-        self._set_comp_prop(self._pin_pair_rlc)  # pragma: no cover
+        self._set_comp_prop()  # pragma: no cover
 
     @property
     def capacitance(self):
@@ -84,7 +84,7 @@ class PinPair(object):  # pragma: no cover
     @capacitance.setter
     def capacitance(self, value):
         self._pin_pair_rlc.C = value
-        self._set_comp_prop(self._pin_pair_rlc)  # pragma: no cover
+        self._set_comp_prop()  # pragma: no cover
 
     @property
     def rlc_values(self):  # pragma: no cover

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/dotnet/edb_core/cell/terminal/padstack_instance_terminal.py

@@ -101,3 +101,15 @@ class PadstackInstanceTerminal(Terminal):
     def padstack_instance(self):
         p_inst, _ = self._get_parameters()
         return self._pedb.layout.find_object_by_id(p_inst.GetId())
+
+    @property
+    def layer(self):
+        """Get layer of the terminal."""
+        _, _, layer = self._edb_object.GetParameters()
+        return self._pedb.stackup.all_layers[layer.GetName()]
+
+    @layer.setter
+    def layer(self, value):
+        layer = self._pedb.stackup.layers[value]._edb_layer
+        point_data = self._pedb.point_data(*self.location)
+        self._edb_object.SetParameters(point_data, layer)

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/dotnet/edb_core/cell/terminal/point_terminal.py

@@ -66,3 +66,15 @@ class PointTerminal(Terminal):
             raise Exception(msg)
         else:
             return terminal
+
+    @property
+    def layer(self):
+        """Get layer of the terminal."""
+        _, _, layer = self._edb_object.GetParameters()
+        return self._pedb.stackup.all_layers[layer.GetName()]
+
+    @layer.setter
+    def layer(self, value):
+        layer = self._pedb.stackup.layers[value]._edb_layer
+        point_data = self._pedb.point_data(*self.location)
+        self._edb_object.SetParameters(point_data, layer)

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/dotnet/edb_core/cell/terminal/terminal.py

@@ -105,25 +105,16 @@ class Terminal(Connectable):
     @property
     def layer(self):
         """Get layer of the terminal."""
-        point_data = self._pedb.point_data(0, 0)
-        layer = list(self._pedb.stackup.layers.values())[0]._edb_layer
-        if self._edb_object.GetParameters(point_data, layer):
-            return self._pedb.stackup.all_layers[layer.GetName()]
-        else:
-            self._pedb.logger.warning(f"No pad parameters found for terminal {self.name}")
-
-    @layer.setter
-    def layer(self, value):
-        layer = self._pedb.stackup.layers[value]._edb_layer
-        point_data = self._pedb.point_data(*self.location)
-        self._edb_object.SetParameters(point_data, layer)
+        return self._pedb.logger.error("Cannot determine terminal layer")
 
     @property
     def location(self):
         """Location of the terminal."""
-        layer = list(self._pedb.stackup.layers.values())[0]._edb_layer
-        _, point_data, _ = self._edb_object.GetParameters(None, layer)
-        return [point_data.X.ToDouble(), point_data.Y.ToDouble()]
+        try:
+            _, point_data, _ = self._edb_object.GetParameters()
+            return [point_data.X.ToDouble(), point_data.Y.ToDouble()]
+        except:
+            self._pedb.logger.error("Cannot determine terminal location")
 
     @location.setter
     def location(self, value):

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/dotnet/edb_core/components.py

@@ -111,16 +111,9 @@ class Components(object):
 
     def __init__(self, p_edb):
         self._pedb = p_edb
-        self._cmp = {}
-        self._res = {}
-        self._cap = {}
-        self._ind = {}
-        self._ios = {}
-        self._ics = {}
-        self._others = {}
+        self.refresh_components()
         self._pins = {}
         self._comps_by_part = {}
-        self._init_parts()
         self._padstack = EdbPadstacks(self._pedb)
 
     @property
@@ -132,16 +125,6 @@ class Components(object):
     def _edb(self):
         return self._pedb.edb_api
 
-    def _init_parts(self):
-        a = self.instances
-        a = self.resistors
-        a = self.ICs
-        a = self.Others
-        a = self.inductors
-        a = self.IOs
-        a = self.components_by_partname
-        return True
-
     def _get_edb_value(self, value):
         return self._pedb.edb_value(value)
 
@@ -205,8 +188,6 @@ class Components(object):
         >>> edbapp.components.instances
 
         """
-        if not self._cmp:
-            self.refresh_components()
         return self._cmp
 
     @property
@@ -310,10 +291,29 @@ class Components(object):
 
     def refresh_components(self):
         """Refresh the component dictionary."""
-        # self._logger.info("Refreshing the Components dictionary.")
         self._cmp = {}
+        self._res = {}
+        self._ind = {}
+        self._cap = {}
+        self._ics = {}
+        self._ios = {}
+        self._others = {}
         for i in self._pedb.layout.groups:
             self._cmp[i.name] = i
+            if i.type == "Resistor":
+                self._res[i.name] = i
+            elif i.type == "Capacitor":
+                self._cap[i.name] = i
+            elif i.type == "Inductor":
+                self._ind[i.name] = i
+            elif i.type == "IC":
+                self._ics[i.name] = i
+            elif i.type == "IO":
+                self._ios[i.name] = i
+            elif i.type == "Other":
+                self._others[i.name] = i
+            else:
+                self._logger.warning(f"Unknown component type {i.name} found while refreshing components, will ignore")
         return True
 
     @property
@@ -332,10 +332,6 @@ class Components(object):
         >>> edbapp = Edb("myaedbfolder")
         >>> edbapp.components.resistors
         """
-        self._res = {}
-        for el, val in self.instances.items():
-            if val.type == "Resistor":
-                self._res[el] = val
         return self._res
 
     @property
@@ -354,10 +350,6 @@ class Components(object):
         >>> edbapp = Edb("myaedbfolder")
         >>> edbapp.components.capacitors
         """
-        self._cap = {}
-        for el, val in self.instances.items():
-            if val.type == "Capacitor":
-                self._cap[el] = val
         return self._cap
 
     @property
@@ -377,10 +369,6 @@ class Components(object):
         >>> edbapp.components.inductors
 
         """
-        self._ind = {}
-        for el, val in self.instances.items():
-            if val.type == "Inductor":
-                self._ind[el] = val
         return self._ind
 
     @property
@@ -400,10 +388,6 @@ class Components(object):
         >>> edbapp.components.ICs
 
         """
-        self._ics = {}
-        for el, val in self.instances.items():
-            if val.type == "IC":
-                self._ics[el] = val
         return self._ics
 
     @property
@@ -423,10 +407,6 @@ class Components(object):
         >>> edbapp.components.IOs
 
         """
-        self._ios = {}
-        for el, val in self.instances.items():
-            if val.type == "IO":
-                self._ios[el] = val
         return self._ios
 
     @property
@@ -446,10 +426,6 @@ class Components(object):
         >>> edbapp.components.others
 
         """
-        self._others = {}
-        for el, val in self.instances.items():
-            if val.type == "Other":
-                self._others[el] = val
         return self._others
 
     @property

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/dotnet/edb_core/edb_data/layer_data.py

@@ -60,6 +60,8 @@ class LayerEdbClass(object):
                 self.__setattr__(k, v)
             elif k == "roughness":
                 self.properties = {"roughness": v}
+            elif k == "etching":
+                self.properties = {"etching": v}
             else:
                 self._pedb.logger.error(f"{k} is not a valid layer attribute")
 
@@ -792,6 +794,15 @@ class StackupLayerEdbClass(LayerEdbClass):
         data["thickness"] = self._edb_object.GetThicknessValue().ToString()
         data["color"] = self.color
 
+        data["etching"] = {
+            "factor": self._edb_layer.GetEtchFactor().ToString(),
+            "enabled": self._edb_layer.IsEtchFactorEnabled(),
+        }
+        if self._pedb.edbversion >= "2024.2":
+            etch_power_ground_nets = int(self._edb_layer.GetEtchNetClass())
+            etch_power_ground_nets = False if etch_power_ground_nets else True
+            data["etching"]["etch_power_ground_nets"] = etch_power_ground_nets
+
         roughness = {}
         for region in ["top", "bottom", "side"]:
             temp = {}
@@ -851,5 +862,14 @@ class StackupLayerEdbClass(LayerEdbClass):
                     getattr(self._pedb._edb.Cell.RoughnessModel.Region, region.capitalize()), r_model
                 )
             self._pedb.stackup._set_layout_stackup(layer_clone, "change_attribute")
-
-        layer_clone.SetRoughnessEnabled(True)
+        etching = params.get("etching")
+        if etching:
+            layer_clone = self._edb_layer
+            layer_clone.SetEtchFactorEnabled(etching["enabled"])
+            layer_clone.SetEtchFactor(self._pedb.stackup._edb_value(float(etching["factor"])))
+            if self._pedb.edbversion >= "2024.2":
+                if etching["etch_power_ground_nets"]:
+                    layer_clone.SetEtchNetClass(self._pedb._edb.Cell.EtchNetClass.NoEtchPowerGroundNets)
+                else:
+                    layer_clone.SetEtchNetClass(self._pedb._edb.Cell.EtchNetClass.EtchAllNets)
+            self._pedb.stackup._set_layout_stackup(layer_clone, "change_attribute")

{pyedb-0.34.2 → pyedb-0.35.0}/src/pyedb/dotnet/edb_core/layout_validation.py

@@ -272,7 +272,7 @@ class LayoutValidation:
         bool
         """
         if not net_list:
-            net_list = list(self._pedb.nets.keys())
+            net_list = list(self._pedb.nets.nets.keys())
         elif isinstance(net_list, str):
             net_list = [net_list]
         new_prims = []