pyedb 0.60.0__py3-none-any.whl → 0.61.0__py3-none-any.whl

pyedb/grpc/database/padstacks.py

@@ -346,6 +346,188 @@ class Padstacks(object):
         """Return a PadType Enumerator."""
         return GrpcPadType
 
+    def create_dielectric_filled_backdrills(
+        self,
+        layer: str,
+        diameter: Union[float, str],
+        material: str,
+        permittivity: float,
+        padstack_instances: Optional[List[PadstackInstance]] = None,
+        padstack_definition: Optional[Union[str, List[str]]] = None,
+        dielectric_loss_tangent: Optional[float] = None,
+        nets: Optional[Union[str, List[str]]] = None,
+    ) -> bool:
+        r"""Create dielectric-filled back-drills for through-hole vias.
+
+        Back-drilling (a.k.a. controlled-depth drilling) is used to remove the
+        unused via stub that acts as an unterminated transmission-line segment,
+        thereby improving signal-integrity at high frequencies.  This routine
+        goes one step further: after the stub is removed the resulting cylindrical
+        cavity is **completely filled** with a user-specified dielectric.  The
+        fill material restores mechanical rigidity, prevents solder-wicking, and
+        keeps the original via’s electrical characteristics intact on the
+        remaining, still-plated, portion.
+
+        Selection criteria
+        ------------------
+        A via is processed only when **all** of the following are true:
+
+        1. It is a through-hole structure (spans at least three metal layers).
+        2. It includes the requested ``layer`` somewhere in its layer span.
+        3. It belongs to one of the supplied ``padstack_definition`` names
+           (or to *any* definition if the argument is omitted).
+        4. It is attached to one of the supplied ``nets`` (or to *any* net if
+           the argument is omitted).
+
+        Geometry that is created
+        ------------------------
+        For every qualified via the routine
+
+        * Generates a new pad-stack definition named ``<original_name>_BD``.
+          The definition is drilled from the **bottom-most signal layer** up to
+          and **including** ``layer``, uses the exact ``diameter`` supplied, and
+          is plated at 100 %.
+        * Places an additional pad-stack instance on top of the original via,
+          thereby filling the newly drilled cavity with the requested
+          ``material``.
+        * Leaves the original via untouched—only its unused stub is removed.
+
+        The back-drill is **not** subtracted from anti-pads or plane clearances;
+        the filling material is assumed to be electrically invisible at the
+        frequencies of interest.
+
+        Parameters
+        ----------
+        layer : :class:`str`
+            Signal layer name up to which the back-drill is performed (inclusive).
+            The drill always starts on the bottom-most signal layer of the stack-up.
+        diameter : :class:`float` or :class:`str`
+            Finished hole diameter for the back-drill.  A numeric value is
+            interpreted in the database length unit; a string such as
+            ``"0.3mm"`` is evaluated with units.
+        material : :class:`str`
+            Name of the dielectric material that fills the drilled cavity.  If the
+            material does not yet exist in the central material library it is
+            created on the fly.
+        permittivity : :class:`float`
+            Relative permittivity :math:`\varepsilon_{\mathrm{r}}` used when the
+            material has to be created.  Must be positive.
+        padstack_instances : :class:`list` [:class:`PadstackInstance` ], optional
+            Explicit list of via instances to process.  When provided,
+            ``padstack_definition`` and ``nets`` are ignored for filtering.
+        padstack_definition : :class:`str` or :class:`list` [:class:`str` ], optional
+            Pad-stack definition(s) to process.  If omitted, **all** through-hole
+            definitions are considered.
+        dielectric_loss_tangent : :class:`float`, optional
+            Loss tangent :math:`\tan\delta` used when the material has to be
+            created.  Defaults to ``0.0``.
+        nets : :class:`str` or :class:`list` [:class:`str` ], optional
+            Net name(s) used to filter vias.  If omitted, vias belonging to
+            **any** net are processed.
+
+        Returns
+        -------
+        :class:`bool`
+            ``True`` when at least one back-drill was successfully created.
+            ``False`` if no suitable via was found or any error occurred.
+
+        Raises
+        ------
+        ValueError
+            If ``material`` is empty or if ``permittivity`` is non-positive when a
+            new material must be created.
+
+        Notes
+        -----
+        * The routine is safe to call repeatedly: existing back-drills are **not**
+          duplicated because the ``*_BD`` definition name is deterministic.
+        * The original via keeps its pad-stack definition and net assignment; only
+          its unused stub is removed.
+        * The back-drill is **not** subtracted from anti-pads or plane clearances;
+          the filling material is assumed to be electrically invisible at the
+          frequencies of interest.
+
+        Examples
+        --------
+        Create back-drills on all vias belonging to two specific pad-stack
+        definitions and two DDR4 nets:
+
+        >>> edb.padstacks.create_dielectric_filled_backdrills(
+        ...     layer="L3",
+        ...     diameter="0.25mm",
+        ...     material="EPON_827",
+        ...     permittivity=3.8,
+        ...     dielectric_loss_tangent=0.015,
+        ...     padstack_definition=["VIA_10MIL", "VIA_16MIL"],
+        ...     nets=["DDR4_DQ0", "DDR4_DQ1"],
+        ... )
+        True
+        """
+        _padstack_instances = defaultdict(list)
+        if padstack_instances:
+            for inst in padstack_instances:
+                _padstack_instances[inst.padstack_def.name].append(inst)
+        else:
+            if padstack_definition:
+                if isinstance(padstack_definition, str):
+                    padstack_definition = [padstack_definition]
+                padstack_definitions = [
+                    self.definitions.get(padstack_def, None) for padstack_def in padstack_definition
+                ]
+                if nets:
+                    if isinstance(nets, str):
+                        nets = [nets]
+                    for padstack_definition in padstack_definitions:
+                        _padstack_instances[padstack_definition.name] = self.get_instances(
+                            definition_name=padstack_definition.name, net_name=nets
+                        )
+                else:
+                    for padstack_definition in padstack_definitions:
+                        _padstack_instances[padstack_definition.name] = padstack_definition.instances
+            elif nets:
+                instances = self.get_instances(net_name=nets)
+                for inst in instances:
+                    padsatck_def_name = inst.padstack_def.name
+                    padstack_def_layers = inst.padstack_def.data.layer_names
+                    if layer in padstack_def_layers and len(padstack_def_layers) >= 3:
+                        _padstack_instances[padsatck_def_name].append(inst)
+                    else:
+                        self._pedb.logger.info(
+                            f"Drill layer {layer} not in padstack definition layers "
+                            f"or layer number = {len(padstack_def_layers)} "
+                            f"for padstack definition {padsatck_def_name}, skipping for backdrills"
+                        )
+        if not material:
+            raise ValueError("`material` must be specified")
+        if not material in self._pedb.materials:
+            if not dielectric_loss_tangent:
+                dielectric_loss_tangent = 0.0
+            self._pedb.materials.add_dielectric_material(
+                name=material, permittivity=permittivity, dielectric_loss_tangent=dielectric_loss_tangent
+            )
+        for def_name, instances in _padstack_instances.items():
+            padstack_def_backdrill_name = f"{def_name}_BD"
+            start_layer = list(self._pedb.stackup.signal_layers.keys())[-1]  # bottom layer
+            self.create(
+                padstackname=padstack_def_backdrill_name,
+                holediam=self._pedb.value(diameter),
+                paddiam="0.0",
+                antipaddiam="0.0",
+                start_layer=start_layer,
+                stop_layer=layer,
+            )
+            self.definitions[padstack_def_backdrill_name].material = material
+            self.definitions[padstack_def_backdrill_name].hole_plating_ratio = 100.0
+            for inst in instances:
+                inst.set_back_drill_by_layer(drill_to_layer=layer, offset=0.0, diameter=self._pedb.value(diameter))
+                self.place(
+                    position=inst.position,
+                    definition_name=padstack_def_backdrill_name,
+                    fromlayer=start_layer,
+                    tolayer=layer,
+                )
+        return True
+
     def create_circular_padstack(
         self,
         padstackname: Optional[str] = None,
@@ -810,6 +992,23 @@ class Padstacks(object):
                         via_list.append(inst)
         return via_list
 
+    def layers_between(self, layers, start_layer=None, stop_layer=None):
+        """
+        Return the sub-list of *layers* that lies between *start_layer*
+        (inclusive) and *stop_layer* (inclusive).  Works no matter which
+        of the two is nearer the top of the stack.
+        """
+        if not layers:
+            return []
+
+        # default to the full stack if one end is unspecified
+        start_idx = layers.index(start_layer) if start_layer in layers else 0
+        stop_idx = layers.index(stop_layer) if stop_layer in layers else len(layers) - 1
+
+        # always slice from the smaller to the larger index
+        lo, hi = sorted((start_idx, stop_idx))
+        return layers[lo : hi + 1]
+
     def create(
         self,
         padstackname: Optional[str] = None,
@@ -951,11 +1150,7 @@ class Padstacks(object):
         else:  # pragma no cover
             self._logger.error("Unknown padstack hole range")
         padstack_data.material = "copper"
-
-        if start_layer and start_layer in layers:  # pragma no cover
-            layers = layers[layers.index(start_layer) :]
-        if stop_layer and stop_layer in layers:  # pragma no cover
-            layers = layers[: layers.index(stop_layer) + 1]
+        layers = self.layers_between(layers=layers, start_layer=start_layer, stop_layer=stop_layer)
         if not isinstance(paddiam, list):
             pad_array = [paddiam]
         else:
@@ -1315,7 +1510,7 @@ class Padstacks(object):
         name: Optional[str] = None,
         pid: Optional[int] = None,
         definition_name: Optional[str] = None,
-        net_name: Optional[str] = None,
+        net_name: Optional[Union[str, List[str]]] = None,
         component_reference_designator: Optional[str] = None,
         component_pin: Optional[str] = None,
     ) -> List[PadstackInstance]:

pyedb/grpc/database/primitive/padstack_instance.py

@@ -728,6 +728,96 @@ class PadstackInstance(GrpcPadstackInstance):
             except:
                 return False
 
+    @property
+    def backdrill_diameter(self):
+        parameters = []
+        if self.backdrill_bottom:
+            parameters = self.get_back_drill_by_layer(True)
+        elif self.backdrill_top:
+            parameters = self.get_back_drill_by_layer(False)
+        if parameters:
+            return round(parameters[-1].value, 9)
+        return 0.0
+
+    @backdrill_diameter.setter
+    def backdrill_diameter(self, value):
+        if self.backdrill_bottom:
+            parameters = self.get_back_drill_by_layer(True)
+            self.set_back_drill_by_layer(
+                drill_to_layer=parameters[0],
+                offset=parameters[1],
+                diameter=self._pedb.value(value),
+                from_bottom=True,
+            )
+        elif self.backdrill_top:
+            parameters = self.get_back_drill_by_layer(False)
+            self.set_back_drill_by_layer(
+                drill_to_layer=parameters[0],
+                offset=parameters[1],
+                diameter=Value(value),
+                from_bottom=False,
+            )
+
+    @property
+    def backdrill_layer(self):
+        parameters = []
+        if self.backdrill_bottom:
+            parameters = self.get_back_drill_by_layer(True)
+        elif self.backdrill_top:
+            parameters = self.get_back_drill_by_layer(False)
+        if parameters:
+            return parameters[0]
+        return ""
+
+    @backdrill_layer.setter
+    def backdrill_layer(self, value):
+        if self.backdrill_bottom:
+            parameters = self.get_back_drill_by_layer(True)
+            self.set_back_drill_by_layer(
+                drill_to_layer=self._pedb.stackup.layers[value],
+                offset=parameters[1],
+                diameter=parameters[2],
+                from_bottom=True,
+            )
+        elif self.backdrill_top:
+            parameters = self.get_back_drill_by_layer(False)
+            self.set_back_drill_by_layer(
+                drill_to_layer=value,
+                offset=parameters[1],
+                diameter=parameters[2],
+                from_bottom=False,
+            )
+
+    @property
+    def backdrill_offset(self):
+        parameters = []
+        if self.backdrill_bottom:
+            parameters = self.get_back_drill_by_layer(True)
+        elif self.backdrill_top:
+            parameters = self.get_back_drill_by_layer(False)
+        if parameters:
+            return parameters[1].value
+        return 0.0
+
+    @backdrill_offset.setter
+    def backdrill_offset(self, value):
+        if self.backdrill_bottom:
+            parameters = self.get_back_drill_by_layer(True)
+            self.set_back_drill_by_layer(
+                drill_to_layer=parameters[0],
+                offset=Value(value),
+                diameter=parameters[2],
+                from_bottom=True,
+            )
+        elif self.backdrill_top:
+            parameters = self.get_back_drill_by_layer(False)
+            self.set_back_drill_by_layer(
+                drill_to_layer=parameters[0],
+                offset=Value(value),
+                diameter=parameters[2],
+                from_bottom=False,
+            )
+
     @property
     def metal_volume(self) -> float:
         """Metal volume of the via hole instance in cubic units (m3). Metal plating ratio is accounted.

pyedb/grpc/edb.py

@@ -135,6 +135,7 @@ from pyedb.ipc2581.ipc2581 import Ipc2581
 from pyedb.misc.decorators import deprecate_argument_name
 from pyedb.modeler.geometry_operators import GeometryOperators
 from pyedb.workflow import Workflow
+from pyedb.workflows.job_manager.backend.job_manager_handler import JobManagerHandler
 from pyedb.workflows.utilities.cutout import Cutout
 
 os.environ["no_proxy"] = "localhost,127.0.0.1"
@@ -430,6 +431,7 @@ class Edb(EdbInit):
         self._source_excitation = SourceExcitation(self)
         self._differential_pairs = DifferentialPairs(self)
         self._extended_nets = ExtendedNets(self)
+        self._job_manager = JobManagerHandler(self)
 
     def value(self, val) -> float:
         """Convert a value into a pyedb value."""
@@ -439,6 +441,17 @@ class Edb(EdbInit):
             context = self.active_cell if not str(val).startswith("$") else self.active_db
             return Value(GrpcValue(val, context), context)
 
+    @property
+    def job_manager(self):
+        """Job manager for handling simulation tasks.
+
+        Returns
+        -------
+        :class:`JobManagerHandler <pyedb.workflows.job_manager.job_manager_handler.JobManagerHandler>`
+            Job manager instance for submitting and managing simulation jobs.
+        """
+        return self._job_manager
+
     @property
     def cell_names(self) -> List[str]:
         """List of all cell names in the database.
@@ -872,6 +885,62 @@ class Edb(EdbInit):
         self.edbpath = os.path.join(working_dir, aedb_name)
         return self.open_edb()
 
+    def import_vlctech_stackup(
+        self,
+        vlctech_file,
+        working_dir="",
+        export_xml=None,
+    ):
+        """Import a vlc.tech file and generate an ``edb.def`` file in the working directory containing only the stackup.
+
+        Parameters
+        ----------
+        vlctech_file : str
+            Full path to the technology stackup file. It must be vlc.tech.
+        working_dir : str, optional
+            Directory in which to create the ``aedb`` folder. The name given to the AEDB file
+            is the same as the name of the board file.
+        export_xml : str, optional
+            Export technology file in XML control file format.
+
+        Returns
+        -------
+        Full path to the AEDB file : str
+
+        """
+        if not working_dir:
+            working_dir = os.path.dirname(vlctech_file)
+        command = os.path.join(self.base_path, "helic", "tools", "raptorh", "bin", "make-edb")
+        if is_windows:
+            command += ".exe"
+        else:
+            os.environ["HELIC_ROOT"] = os.path.join(self.base_path, "helic")
+        cmd_make_edb = [
+            command,
+            "-t",
+            "{}".format(vlctech_file),
+            "-o",
+            "{}".format(os.path.join(working_dir, "vlctech")),
+        ]
+        if export_xml:
+            cmd_make_edb.extend(["-x", "{}".format(export_xml)])
+
+        try:
+            subprocess.run(cmd_make_edb, check=True)  # nosec
+        except subprocess.CalledProcessError as e:  # nosec
+            raise RuntimeError(
+                "Failed to create edb. Please check if the executable is present in the base path."
+            ) from e
+
+        if not os.path.exists(os.path.join(working_dir, "vlctech.aedb")):
+            self.logger.error("Failed to create edb. Please check if the executable is present in the base path.")
+            return False
+        else:
+            self.logger.info("edb successfully created.")
+        self.edbpath = os.path.join(working_dir, "vlctech.aedb")
+        self.open()
+        return self.edbpath
+
     def export_to_ipc2581(self, ipc_path=None, units="MILLIMETER") -> str:
         """Export design to IPC2581 format.
 
@@ -3127,7 +3196,7 @@ class Edb(EdbInit):
         except subprocess.CalledProcessError as e:  # nosec
             raise RuntimeError(
                 "EDBDiff.exe execution failed. Please check if the executable is present in the base path."
-            )
+            ) from e
 
         if not os.path.exists(os.path.join(results, "EDBDiff.csv")):
             self.logger.error("Comparison execution failed")

pyedb/grpc/rpc_session.py

@@ -150,11 +150,24 @@ class RpcSession:
 
     @staticmethod
     def kill_all_instances():
-        proc = [p.pid for p in list(psutil.process_iter()) if "edb_rpc" in p.name().lower()]
+        # collect PIDs safely
+        proc = []
+        for p in psutil.process_iter(["pid", "name"]):
+            try:
+                if "edb_rpc" in p.info["name"].lower():
+                    proc.append(p.info["pid"])
+            except (psutil.NoSuchProcess, psutil.AccessDenied, psutil.ZombieProcess):
+                continue
+
         time.sleep(latency_delay)
+
+        # terminate gracefully
         for pid in proc:
-            p = psutil.Process(pid)
-            p.terminate()
+            try:
+                p = psutil.Process(pid)
+                p.terminate()
+            except (psutil.NoSuchProcess, psutil.AccessDenied):
+                continue
 
     @staticmethod
     def close():

pyedb/workflows/__init__.py

@@ -0,0 +1,21 @@
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.

pyedb/workflows/job_manager/__init__.py

@@ -0,0 +1,21 @@
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.

pyedb/workflows/job_manager/backend/__init__.py

@@ -0,0 +1,21 @@
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.