pyedb 0.51.2__py3-none-any.whl → 0.53.0__py3-none-any.whl

pyedb/dotnet/database/utilities/siwave_simulation_setup.py

@@ -280,6 +280,21 @@ class SiwaveSimulationSetup(SimulationSetup):
         """List of frequency sweeps."""
         return {i.name: i for i in self._siwave_sweeps_list}
 
+    @property
+    def dc_settings(self):
+        """SIwave DC setting."""
+        return DCSettings(self)
+
+    @property
+    def dc_advanced_settings(self):
+        """Siwave DC advanced settings.
+
+        Returns
+        -------
+        :class:`pyedb.dotnet.database.edb_data.siwave_simulation_setup_data.SiwaveDCAdvancedSettings`
+        """
+        return DCAdvancedSettings(self)
+
 
 class SiwaveDCSimulationSetup(SimulationSetup):
     """Manages EDB methods for SIwave DC simulation setup."""

pyedb/dotnet/edb.py

@@ -104,6 +104,7 @@ from pyedb.generic.process import SiwaveSolve
 from pyedb.generic.settings import settings
 from pyedb.ipc2581.ipc2581 import Ipc2581
 from pyedb.modeler.geometry_operators import GeometryOperators
+from pyedb.siwave_core.product_properties import SIwaveProperties
 from pyedb.workflow import Workflow
 
 
@@ -397,8 +398,7 @@ class Edb(Database):
 
     @property
     def pedb_class(self):
-        if not self.grpc:
-            return pyedb.dotnet
+        return pyedb.dotnet
 
     @property
     def grpc(self):
@@ -1238,7 +1238,7 @@ class Edb(Database):
         return self._core_primitives
 
     @property
-    def layout(self):
+    def layout(self) -> Layout:
         """Layout object.
 
         Returns
@@ -3696,6 +3696,7 @@ class Edb(Database):
         Dict[str, :class:`legacy.database.edb_data.siwave_simulation_setup_data.SiwaveSYZSimulationSetup`]
 
         """
+
         setups = {}
         for i in list(self.active_cell.SimulationSetups):
             if i.GetType().ToString().endswith("kHFSS"):
@@ -3708,6 +3709,18 @@ class Edb(Database):
                 setups[i.GetName()] = RaptorXSimulationSetup(self, i)
             elif i.GetType().ToString().endswith("kHFSSPI"):
                 setups[i.GetName()] = HFSSPISimulationSetup(self, i)
+        try:
+            cpa_setup_name = self.active_cell.GetProductProperty(
+                self._edb.ProductId.SIWave, SIwaveProperties.CPA_SIM_NAME
+            )[-1]
+        except:
+            cpa_setup_name = ""
+        if cpa_setup_name:
+            from pyedb.dotnet.database.utilities.siwave_cpa_simulation_setup import (
+                SIWaveCPASimulationSetup,
+            )
+
+            setups[cpa_setup_name] = SIWaveCPASimulationSetup(self, cpa_setup_name)
         return setups
 
     @property
@@ -4735,3 +4748,37 @@ class Edb(Database):
             return self.variables[variable_name]
         else:
             return False
+
+    def compare(self, input_file, results=""):
+        """Compares current open database with another one.
+
+        Parameters
+        ----------
+        input_file : str
+            Path to the edb file.
+        results: str, optional
+            Path to directory in which results will be saved. If no path is given, a new "_compare_results"
+            directory will be created with the same naming and path as the .aedb folder.
+        Returns
+        -------
+        bool
+            ``True`` when successful, ``False`` when failed.
+        """
+        self.save()
+        if not results:
+            results = self.edbpath[:-5] + "_compare_results"
+            os.mkdir(results)
+        command = os.path.join(self.base_path, "EDBDiff.exe")
+        if is_linux:
+            mono_path = os.path.join(self.base_path, "common/mono/Linux64/bin/mono")
+            cmd_input = [mono_path, command, input_file, self.edbpath, results]
+        else:
+            cmd_input = [command, input_file, self.edbpath, results]
+        subprocess.run(cmd_input)
+
+        if not os.path.exists(os.path.join(results, "EDBDiff.csv")):
+            self.logger.error("Comparison execution failed")
+            return False
+        else:
+            self.logger.info("Comparison correctly completed")
+            return True

pyedb/generic/design_types.py

@@ -19,6 +19,29 @@
 # 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.
+from typing import TYPE_CHECKING, Literal, Union, overload
+import warnings
+
+from pyedb.generic.grpc_warnings import GRPC_GENERAL_WARNING
+
+if TYPE_CHECKING:
+    from pyedb.dotnet.edb import Edb as EdbDotnet
+    from pyedb.grpc.edb import Edb as EdbGrpc
+
+
+@overload
+def Edb(*, grpc: Literal[True], **kwargs) -> "EdbGrpc":
+    ...
+
+
+@overload
+def Edb(*, grpc: Literal[False] = False, **kwargs) -> "EdbDotnet":
+    ...
+
+
+@overload
+def Edb(*, grpc: bool, **kwargs) -> Union["EdbGrpc", "EdbDotnet"]:
+    ...
 
 
 # lazy imports
@@ -235,6 +258,12 @@ def Edb(
     """
 
     # Use EDB legacy (default choice)
+    if float(edbversion) >= 2025.2:
+        if not grpc:
+            warnings.warn(GRPC_GENERAL_WARNING, UserWarning)
+    else:
+        if grpc:
+            raise ValueError(f"gRPC flag was enabled however your ANSYS AEDT version {edbversion} is not compatible")
     if grpc:
         from pyedb.grpc.edb import Edb as app
     else:

pyedb/generic/grpc_warnings.py

@@ -0,0 +1,5 @@
+GRPC_GENERAL_WARNING = (
+    "Your ANSYS AEDT version is eligible to gRPC version."
+    "You might consider switching to that version for better user experience."
+    "For more information please check this link: https://edb.docs.pyansys.com/version/dev/grpc_api/index.html"
+)

pyedb/grpc/database/__init__.py

@@ -1 +0,0 @@
-from __future__ import absolute_import  # noreorder

pyedb/grpc/database/components.py

@@ -28,7 +28,7 @@ import json
 import math
 import os
 import re
-from typing import Union
+from typing import Any, Dict, List, Optional, Tuple, Union
 import warnings
 
 from ansys.edb.core.definition.die_property import DieOrientation as GrpDieOrientation
@@ -100,7 +100,7 @@ class Components(object):
     >>> edbapp.components
     """
 
-    def __getitem__(self, name):
+    def __getitem__(self, name: str) -> Optional[Union[Component, ComponentDef]]:
         """Get a component or component definition by name.
 
         Parameters
@@ -125,7 +125,7 @@ class Components(object):
         self._pedb.logger.error("Component or definition not found.")
         return
 
-    def __init__(self, p_edb):
+    def __init__(self, p_edb: Any) -> None:
         self._pedb = p_edb
         self.refresh_components()
         self._pins = {}
@@ -133,7 +133,7 @@ class Components(object):
         self._padstack = Padstacks(self._pedb)
 
     @property
-    def _logger(self):
+    def _logger(self) -> Any:
         """Logger instance for the component manager.
 
         Returns
@@ -188,7 +188,7 @@ class Components(object):
         return self._pedb.active_db
 
     @property
-    def instances(self) -> dict[str, Component]:
+    def instances(self) -> Dict[str, Component]:
         """Dictionary of all component instances in the layout.
 
         Returns
@@ -203,7 +203,7 @@ class Components(object):
         return self._cmp
 
     @property
-    def definitions(self) -> dict[str, ComponentDef]:
+    def definitions(self) -> Dict[str, ComponentDef]:
         """Dictionary of all component definitions.
 
         Returns
@@ -218,7 +218,7 @@ class Components(object):
         return {l.name: ComponentDef(self._pedb, l) for l in self._pedb.component_defs}
 
     @property
-    def nport_comp_definition(self) -> dict[str, Component]:
+    def nport_comp_definition(self) -> Dict[str, Component]:
         """Dictionary of N-port component definitions.
 
         Returns
@@ -371,7 +371,7 @@ class Components(object):
         return True
 
     @property
-    def resistors(self) -> dict[str, Component]:
+    def resistors(self) -> Dict[str, Component]:
         """Dictionary of resistor components.
 
         Returns
@@ -386,7 +386,7 @@ class Components(object):
         return self._res
 
     @property
-    def capacitors(self) -> dict[str, Component]:
+    def capacitors(self) -> Dict[str, Component]:
         """Dictionary of capacitor components.
 
         Returns
@@ -401,7 +401,7 @@ class Components(object):
         return self._cap
 
     @property
-    def inductors(self) -> dict[str, Component]:
+    def inductors(self) -> Dict[str, Component]:
         """Dictionary of inductor components.
 
         Returns
@@ -416,7 +416,7 @@ class Components(object):
         return self._ind
 
     @property
-    def ICs(self) -> dict[str, Component]:
+    def ICs(self) -> Dict[str, Component]:
         """Dictionary of integrated circuit components.
 
         Returns
@@ -431,7 +431,7 @@ class Components(object):
         return self._ics
 
     @property
-    def IOs(self) -> dict[str, Component]:
+    def IOs(self) -> Dict[str, Component]:
         """Dictionary of I/O components.
 
         Returns
@@ -446,7 +446,7 @@ class Components(object):
         return self._ios
 
     @property
-    def Others(self) -> dict[str, Component]:
+    def Others(self) -> Dict[str, Component]:
         """Dictionary of other components.
 
         Returns
@@ -461,7 +461,7 @@ class Components(object):
         return self._others
 
     @property
-    def components_by_partname(self) -> dict[str, list[Component]]:
+    def components_by_partname(self) -> Dict[str, List[Component]]:
         """Dictionary of components grouped by part name.
 
         Returns
@@ -500,7 +500,12 @@ class Components(object):
         """
         return self.instances[name]
 
-    def get_pin_from_component(self, component, net_name=None, pin_name=None) -> list:
+    def get_pin_from_component(
+        self,
+        component: Union[str, Component],
+        net_name: Optional[Union[str, List[str]]] = None,
+        pin_name: Optional[str] = None,
+    ) -> List[Any]:
         """Get pins from a component with optional filtering.
 
         Parameters
@@ -559,7 +564,7 @@ class Components(object):
                 cmp_list.append(refdes)
         return cmp_list
 
-    def _get_edb_pin_from_pin_name(self, cmp, pin) -> Union[ComponentPin, bool]:
+    def _get_edb_pin_from_pin_name(self, cmp: Component, pin: str) -> Union[ComponentPin, bool]:
         """Get EDB pin from pin name.
 
         Parameters
@@ -584,14 +589,14 @@ class Components(object):
 
     def get_component_placement_vector(
         self,
-        mounted_component,
-        hosting_component,
-        mounted_component_pin1,
-        mounted_component_pin2,
-        hosting_component_pin1,
-        hosting_component_pin2,
-        flipped=False,
-    ) -> tuple:
+        mounted_component: Component,
+        hosting_component: Component,
+        mounted_component_pin1: str,
+        mounted_component_pin2: str,
+        hosting_component_pin1: str,
+        hosting_component_pin2: str,
+        flipped: bool = False,
+    ) -> Tuple[bool, List[float], float, float]:
         """Get placement vector between two components.
 
         Parameters
@@ -670,7 +675,7 @@ class Components(object):
         self._logger.warning("Failed to compute vector.")
         return False, [0, 0], 0, 0
 
-    def get_solder_ball_height(self, cmp) -> float:
+    def get_solder_ball_height(self, cmp: Union[str, Component]) -> float:
         """Get solder ball height of a component.
 
         Parameters
@@ -1012,15 +1017,15 @@ class Components(object):
 
     def create(
         self,
-        pins,
-        component_name=None,
-        placement_layer=None,
-        component_part_name=None,
-        is_rlc=False,
-        r_value=None,
-        c_value=None,
-        l_value=None,
-        is_parallel=False,
+        pins: List[Any],
+        component_name: Optional[str] = None,
+        placement_layer: Optional[str] = None,
+        component_part_name: Optional[str] = None,
+        is_rlc: bool = False,
+        r_value: Optional[float] = None,
+        c_value: Optional[float] = None,
+        l_value: Optional[float] = None,
+        is_parallel: bool = False,
     ) -> Union[Component, bool]:
         """Create a new component.
 
@@ -1156,7 +1161,13 @@ class Components(object):
             is_rlc=False,
         )
 
-    def set_component_model(self, componentname, model_type="Spice", modelpath=None, modelname=None) -> bool:
+    def set_component_model(
+        self,
+        componentname: str,
+        model_type: str = "Spice",
+        modelpath: Optional[str] = None,
+        modelname: Optional[str] = None,
+    ) -> bool:
         """Set component model.
 
         Parameters
@@ -1228,7 +1239,7 @@ class Components(object):
             component.component_property.model = s_parameter_mod
         return True
 
-    def create_pingroup_from_pins(self, pins, group_name=None) -> Union[PinGroup, bool]:
+    def create_pingroup_from_pins(self, pins: List[Any], group_name: Optional[str] = None) -> Union[PinGroup, bool]:
         """Create pin group from pins.
 
         Parameters
@@ -1279,7 +1290,7 @@ class Components(object):
             pin_group.net = pins[0].net
             return pin_group
 
-    def delete_single_pin_rlc(self, deactivate_only=False) -> list[str]:
+    def delete_single_pin_rlc(self, deactivate_only: bool = False) -> List[str]:
         """Delete or deactivate single-pin RLC components.
 
         Parameters
@@ -1310,7 +1321,7 @@ class Components(object):
         self._pedb.logger.info("Deleted {} components".format(len(deleted_comps)))
         return deleted_comps
 
-    def delete(self, component_name) -> bool:
+    def delete(self, component_name: str) -> bool:
         """Delete a component.
 
         Parameters
@@ -1335,7 +1346,7 @@ class Components(object):
             return True
         return False
 
-    def disable_rlc_component(self, component_name) -> bool:
+    def disable_rlc_component(self, component_name: str) -> bool:
         """Disable RLC component.
 
         Parameters
@@ -1369,16 +1380,16 @@ class Components(object):
 
     def set_solder_ball(
         self,
-        component="",
-        sball_diam=None,
-        sball_height=None,
-        shape="Cylinder",
-        sball_mid_diam=None,
-        chip_orientation="chip_down",
-        auto_reference_size=True,
-        reference_size_x=0,
-        reference_size_y=0,
-        reference_height=0,
+        component: Union[str, Component] = "",
+        sball_diam: Optional[float] = None,
+        sball_height: Optional[float] = None,
+        shape: str = "Cylinder",
+        sball_mid_diam: Optional[float] = None,
+        chip_orientation: str = "chip_down",
+        auto_reference_size: bool = True,
+        reference_size_x: float = 0,
+        reference_size_y: float = 0,
+        reference_height: float = 0,
     ) -> bool:
         """Set solder ball properties for a component.
 
@@ -1466,11 +1477,11 @@ class Components(object):
 
     def set_component_rlc(
         self,
-        componentname,
-        res_value=None,
-        ind_value=None,
-        cap_value=None,
-        isparallel=False,
+        componentname: str,
+        res_value: Optional[float] = None,
+        ind_value: Optional[float] = None,
+        cap_value: Optional[float] = None,
+        isparallel: bool = False,
     ) -> bool:
         """Set RLC values for a component.
 
@@ -1539,11 +1550,11 @@ class Components(object):
 
     def update_rlc_from_bom(
         self,
-        bom_file,
-        delimiter=";",
-        valuefield="Func des",
-        comptype="Prod name",
-        refdes="Pos / Place",
+        bom_file: str,
+        delimiter: str = ";",
+        valuefield: str = "Func des",
+        comptype: str = "Prod name",
+        refdes: str = "Pos / Place",
     ) -> bool:
         """Update RLC values from BOM file.
 
@@ -1604,12 +1615,12 @@ class Components(object):
 
     def import_bom(
         self,
-        bom_file,
-        delimiter=",",
-        refdes_col=0,
-        part_name_col=1,
-        comp_type_col=2,
-        value_col=3,
+        bom_file: str,
+        delimiter: str = ",",
+        refdes_col: int = 0,
+        part_name_col: int = 1,
+        comp_type_col: int = 2,
+        value_col: int = 3,
     ) -> bool:
         """Import BOM file.
 
@@ -1693,7 +1704,7 @@ class Components(object):
                 self.instances[comp].enabled = False
         return True
 
-    def export_bom(self, bom_file, delimiter=",") -> bool:
+    def export_bom(self, bom_file: str, delimiter: str = ",") -> bool:
         """Export BOM file.
 
         Parameters
@@ -1732,7 +1743,7 @@ class Components(object):
                 f.writelines([delimiter.join([refdes, part_name, comp_type, value + "\n"])])
         return True
 
-    def find_by_reference_designator(self, reference_designator) -> Component:
+    def find_by_reference_designator(self, reference_designator: str) -> Component:
         """Find component by reference designator.
 
         Parameters
@@ -1751,7 +1762,7 @@ class Components(object):
         """
         return self.instances[reference_designator]
 
-    def get_aedt_pin_name(self, pin) -> str:
+    def get_aedt_pin_name(self, pin: Any) -> str:
         """Get AEDT pin name.
 
         Parameters
@@ -1770,7 +1781,9 @@ class Components(object):
         """
         return pin.aedt_name
 
-    def get_pins(self, reference_designator, net_name=None, pin_name=None) -> dict:
+    def get_pins(
+        self, reference_designator: str, net_name: Optional[str] = None, pin_name: Optional[str] = None
+    ) -> Dict[str, Any]:
         """Get pins of a component.
 
         Parameters
@@ -1802,7 +1815,7 @@ class Components(object):
 
         return pins
 
-    def get_pin_position(self, pin) -> list[float]:
+    def get_pin_position(self, pin: Any) -> List[float]:
         """Get pin position.
 
         Parameters
@@ -1827,7 +1840,7 @@ class Components(object):
             transformed_pt_pos = pin.component.transform.transform_point(pt_pos)
         return [transformed_pt_pos[0].value, transformed_pt_pos[1].value]
 
-    def get_pins_name_from_net(self, net_name, pin_list=None) -> list[str]:
+    def get_pins_name_from_net(self, net_name: str, pin_list: Optional[List[Any]] = None) -> List[str]:
         """Get pin names from net.
 
         Parameters
@@ -1858,7 +1871,7 @@ class Components(object):
                     pin_names.append(self.get_aedt_pin_name(pin))
         return pin_names
 
-    def get_nets_from_pin_list(self, pins) -> list[str]:
+    def get_nets_from_pin_list(self, pins: List[Any]) -> List[str]:
         """Get nets from pin list.
 
         Parameters
@@ -1877,7 +1890,7 @@ class Components(object):
         """
         return list(set([pin.net.name for pin in pins]))
 
-    def get_component_net_connection_info(self, refdes) -> dict:
+    def get_component_net_connection_info(self, refdes: str) -> Dict[str, List[str]]:
         """Get net connection info for a component.
 
         Parameters
@@ -1905,7 +1918,7 @@ class Components(object):
                     data["net_name"].append(net_name)
         return data
 
-    def get_rats(self) -> list[dict]:
+    def get_rats(self) -> List[Dict[str, List[str]]]:
         """Get RATS (Reference Designator, Pin, Net) information.
 
         Returns
@@ -1923,7 +1936,7 @@ class Components(object):
             df_list.append(df)
         return df_list
 
-    def get_through_resistor_list(self, threshold=1) -> list[str]:
+    def get_through_resistor_list(self, threshold: float = 1) -> List[str]:
         """Get through resistors below threshold.
 
         Parameters
@@ -1953,7 +1966,9 @@ class Components(object):
 
         return through_comp_list
 
-    def short_component_pins(self, component_name, pins_to_short=None, width=1e-3) -> bool:
+    def short_component_pins(
+        self, component_name: str, pins_to_short: Optional[List[str]] = None, width: float = 1e-3
+    ) -> bool:
         """Short component pins with traces.
 
         Parameters
@@ -2089,7 +2104,9 @@ class Components(object):
             i += 1
         return True
 
-    def create_pin_group(self, reference_designator, pin_numbers, group_name=None) -> Union[tuple[str, PinGroup], bool]:
+    def create_pin_group(
+        self, reference_designator: str, pin_numbers: Union[str, List[str]], group_name: Optional[str] = None
+    ) -> Union[Tuple[str, PinGroup], bool]:
         """Create pin group on a component.
 
         Parameters
@@ -2134,7 +2151,9 @@ class Components(object):
                         return group_name, PinGroup(self._pedb, pingroup)
         return False
 
-    def create_pin_group_on_net(self, reference_designator, net_name, group_name=None) -> PinGroup:
+    def create_pin_group_on_net(
+        self, reference_designator: str, net_name: str, group_name: Optional[str] = None
+    ) -> PinGroup:
         """Create pin group by net name.
 
         Parameters
@@ -2160,7 +2179,9 @@ class Components(object):
         ]
         return self.create_pin_group(reference_designator, pins, group_name)
 
-    def deactivate_rlc_component(self, component=None, create_circuit_port=False, pec_boundary=False):
+    def deactivate_rlc_component(
+        self, component: Optional[str] = None, create_circuit_port: bool = False, pec_boundary: bool = False
+    ) -> bool:
         """Deactivate RLC component with a possibility to convert it to a circuit port.
 
         Parameters
@@ -2207,7 +2228,7 @@ class Components(object):
             component=component.refdes, circuit_ports=create_circuit_port, pec_boundary=pec_boundary
         )
 
-    def replace_rlc_by_gap_boundaries(self, component=None):
+    def replace_rlc_by_gap_boundaries(self, component: Optional[Union[str, Component]] = None) -> bool:
         """Replace RLC component by RLC gap boundaries. These boundary types are compatible with 3D modeler export.
         Only 2 pins RLC components are supported in this command.
 
@@ -2243,7 +2264,7 @@ class Components(object):
         component.enabled = False
         return self._pedb.source_excitation.add_rlc_boundary(component.refdes, False)
 
-    def add_rlc_boundary(self, component=None, circuit_type=True):
+    def add_rlc_boundary(self, component: Optional[Union[str, Component]] = None, circuit_type: bool = True) -> bool:
         """Add RLC gap boundary on component and replace it with a circuit port.
         The circuit port supports only 2-pin components.