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

pyedb/dotnet/edb.py

@@ -1,4 +1,4 @@
-# Copyright (C) 2023 - 2024 ANSYS, Inc. and/or its affiliates.
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
 # SPDX-License-Identifier: MIT
 #
 #
@@ -98,10 +98,12 @@ from pyedb.generic.general_methods import generate_unique_name, is_linux, is_win
 from pyedb.generic.process import SiwaveSolve
 from pyedb.generic.settings import settings
 from pyedb.ipc2581.ipc2581 import Ipc2581
-from pyedb.misc.decorators import execution_timer
+from pyedb.misc.decorators import deprecate_argument_name, execution_timer
 from pyedb.modeler.geometry_operators import GeometryOperators
 from pyedb.siwave_core.product_properties import SIwaveProperties
 from pyedb.workflow import Workflow
+from pyedb.workflows.job_manager.backend.job_manager_handler import JobManagerHandler
+from pyedb.workflows.utilities.cutout import Cutout
 
 
 class Edb:
@@ -428,11 +430,23 @@ class Edb:
         self._core_primitives = Modeler(self)
         self._stackup2 = self._stackup
         self._materials = Materials(self)
+        self._job_manager = JobManagerHandler(self)
 
     @property
     def pedb_class(self):
         return pyedb.dotnet
 
+    @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
+
     def value(self, val):
         """Convert a value into a pyedb value."""
         val_ = val if isinstance(val, self._edb.Utility.Value) else self.edb_value(val)
@@ -667,7 +681,8 @@ class Edb:
         #     self.standalone = False
 
         self.core.Database.SetRunAsStandAlone(self.standalone)
-
+        if self._db:  # pragma no cover
+            self._db.Close()
         self._db = self.core.Database.Create(self.edbpath)
 
         if not self._db:
@@ -833,6 +848,61 @@ class Edb:
         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_edb()
+        return self.edbpath
+
     def export_to_ipc2581(self, ipc_path=None, units="MILLIMETER"):
         """Create an XML IPC2581 file from the active EDB.
 
@@ -1943,10 +2013,11 @@ class Edb:
         _poly = _poly.Expand(expansion_size, tolerance, round_corner, round_extension)[0]
         return _poly
 
+    @deprecate_argument_name({"signal_list": "signal_nets", "reference_list": "reference_nets"})
     def cutout(
         self,
-        signal_list=None,
-        reference_list=None,
+        signal_nets=None,
+        reference_nets=None,
         extent_type="ConvexHull",
         expansion_size=0.002,
         use_round_corner=False,
@@ -1981,9 +2052,9 @@ class Edb:
 
         Parameters
         ----------
-         signal_list : list
+         signal_nets : list
             List of signal strings.
-        reference_list : list, optional
+        reference_nets : list, optional
             List of references to add. The default is ``["GND"]``.
         extent_type : str, optional
             Type of the extension. Options are ``"Conforming"``, ``"ConvexHull"``, and
@@ -2069,7 +2140,7 @@ class Edb:
         >>>      if "3V3" in net:
         >>>           signal_list.append(net)
         >>> power_list = ["PGND"]
-        >>> edb.cutout(signal_list=signal_list, reference_list=power_list, extent_type="Conforming")
+        >>> edb.cutout(signal_nets=signal_list, reference_nets=power_list, extent_type="Conforming")
         >>> end_time = str((time.time() - start) / 60)
         >>> edb.logger.info("Total legacy cutout time in min %s", end_time)
         >>> edb.nets.plot(signal_list, None, color_by_net=True)
@@ -2079,119 +2150,33 @@ class Edb:
 
 
         """
-        if expansion_factor > 0:
-            expansion_size = self.calculate_initial_extent(expansion_factor)
-        if signal_list is None:
-            signal_list = []
-        if isinstance(reference_list, str):
-            reference_list = [reference_list]
-        elif reference_list is None:
-            reference_list = []
-        if not use_pyaedt_cutout and custom_extent:
-            return self._create_cutout_on_point_list(
-                custom_extent,
-                units=custom_extent_units,
-                output_aedb_path=output_aedb_path,
-                open_cutout_at_end=open_cutout_at_end,
-                nets_to_include=signal_list + reference_list,
-                include_partial_instances=include_partial_instances,
-                keep_voids=keep_voids,
-            )
-        elif not use_pyaedt_cutout:
-            return self._create_cutout_legacy(
-                signal_list=signal_list,
-                reference_list=reference_list,
-                extent_type=extent_type,
-                expansion_size=expansion_size,
-                use_round_corner=use_round_corner,
-                output_aedb_path=output_aedb_path,
-                open_cutout_at_end=open_cutout_at_end,
-                use_pyaedt_extent_computing=use_pyaedt_extent_computing,
-                check_terminals=check_terminals,
-                include_pingroups=include_pingroups,
-                inlcude_voids_in_extents=include_voids_in_extents,
-            )
-        else:
-            legacy_path = self.edbpath
-            if expansion_factor > 0 and not custom_extent:
-                start = time.time()
-                self.save()
-                dummy_path = self.edbpath.replace(".aedb", "_smart_cutout_temp.aedb")
-                working_cutout = False
-                i = 1
-                expansion = expansion_size
-                while i <= maximum_iterations:
-                    self.logger.info("-----------------------------------------")
-                    self.logger.info("Trying cutout with {}mm expansion size".format(expansion * 1e3))
-                    self.logger.info("-----------------------------------------")
-                    result = self._create_cutout_multithread(
-                        signal_list=signal_list,
-                        reference_list=reference_list,
-                        extent_type=extent_type,
-                        expansion_size=expansion,
-                        use_round_corner=use_round_corner,
-                        number_of_threads=number_of_threads,
-                        custom_extent=custom_extent,
-                        output_aedb_path=dummy_path,
-                        remove_single_pin_components=remove_single_pin_components,
-                        use_pyaedt_extent_computing=use_pyaedt_extent_computing,
-                        extent_defeature=extent_defeature,
-                        custom_extent_units=custom_extent_units,
-                        check_terminals=check_terminals,
-                        include_pingroups=include_pingroups,
-                        preserve_components_with_model=preserve_components_with_model,
-                        include_partial=include_partial_instances,
-                        simple_pad_check=simple_pad_check,
-                        keep_lines_as_path=keep_lines_as_path,
-                        inlcude_voids_in_extents=include_voids_in_extents,
-                    )
-                    if self.are_port_reference_terminals_connected():
-                        if output_aedb_path:
-                            self.save_as(output_aedb_path)
-                        else:
-                            self.save_as(legacy_path)
-                        working_cutout = True
-                        break
-                    self.close()
-                    self.edbpath = legacy_path
-                    self.open_edb()
-                    i += 1
-                    expansion = expansion_size * i
-                if working_cutout:
-                    msg = "Cutout completed in {} iterations with expansion size of {}mm".format(i, expansion * 1e3)
-                    self.logger.info_timer(msg, start)
-                else:
-                    msg = "Cutout failed after {} iterations and expansion size of {}mm".format(i, expansion * 1e3)
-                    self.logger.info_timer(msg, start)
-                    return False
-            else:
-                result = self._create_cutout_multithread(
-                    signal_list=signal_list,
-                    reference_list=reference_list,
-                    extent_type=extent_type,
-                    expansion_size=expansion_size,
-                    use_round_corner=use_round_corner,
-                    number_of_threads=number_of_threads,
-                    custom_extent=custom_extent,
-                    output_aedb_path=output_aedb_path,
-                    remove_single_pin_components=remove_single_pin_components,
-                    use_pyaedt_extent_computing=use_pyaedt_extent_computing,
-                    extent_defeature=extent_defeature,
-                    custom_extent_units=custom_extent_units,
-                    check_terminals=check_terminals,
-                    include_pingroups=include_pingroups,
-                    preserve_components_with_model=preserve_components_with_model,
-                    include_partial=include_partial_instances,
-                    simple_pad_check=simple_pad_check,
-                    keep_lines_as_path=keep_lines_as_path,
-                    inlcude_voids_in_extents=include_voids_in_extents,
-                )
-            if result and not open_cutout_at_end and self.edbpath != legacy_path:
-                self.save()
-                self.close()
-                self.edbpath = legacy_path
-                self.open_edb()
-            return result
+        cutout = Cutout(self)
+        cutout.expansion_size = expansion_size
+        cutout.signals = signal_nets
+        cutout.references = reference_nets
+        cutout.extent_type = extent_type
+        cutout.expansion_size = expansion_size
+        cutout.use_round_corner = use_round_corner
+        cutout.output_file = output_aedb_path
+        cutout.open_cutout_at_end = open_cutout_at_end
+        cutout.use_pyaedt_cutout = use_pyaedt_cutout
+        cutout.number_of_threads = number_of_threads
+        cutout.use_pyaedt_extent_computing = use_pyaedt_extent_computing
+        cutout.extent_defeatured = extent_defeature
+        cutout.remove_single_pin_components = remove_single_pin_components
+        cutout.custom_extent = custom_extent
+        cutout.custom_extent_units = custom_extent_units
+        cutout.include_partial_instances = include_partial_instances
+        cutout.keep_voids = keep_voids
+        cutout.check_terminals = check_terminals
+        cutout.include_pingroups = include_pingroups
+        cutout.expansion_factor = expansion_factor
+        cutout.maximum_iterations = maximum_iterations
+        cutout.preserve_components_with_model = preserve_components_with_model
+        cutout.simple_pad_check = simple_pad_check
+        cutout.keep_lines_as_path = keep_lines_as_path
+        cutout.include_voids_in_extents = include_voids_in_extents
+        return cutout.run()
 
     def _create_cutout_legacy(
         self,
@@ -3711,7 +3696,7 @@ class Edb:
             return True
         self.logger.reset_timer()
         if not common_reference:
-            common_reference = list(set([i.reference_net_name for i in all_sources if i.reference_net_name]))
+            common_reference = list(set([i.reference_net_name for i in all_sources if i.reference_terminal.net_name]))
             if len(common_reference) > 1:
                 self.logger.error("More than 1 reference found.")
                 return False
@@ -4234,7 +4219,18 @@ class Edb:
             terminal.ref_terminal = ref_terminal
         if name:
             terminal.name = name
-        return self.ports[terminal.name]
+
+        if terminal.is_circuit_port:
+            port = CircuitPort(self, terminal._edb_object)
+        elif terminal.terminal_type == "BundleTerminal":
+            port = BundleWavePort(self, terminal._edb_object)
+        elif terminal.hfss_type == "Wave":
+            port = WavePort(self, terminal._edb_object)
+        elif terminal.terminal_type == "PadstackInstanceTerminal":
+            port = CoaxPort(self, terminal._edb_object)
+        else:
+            port = GapPort(self, terminal._edb_object)
+        return port
 
     def create_voltage_probe(self, terminal, ref_terminal):
         """Create a voltage probe.

pyedb/edb_logger.py

@@ -1,4 +1,4 @@
-# Copyright (C) 2023 - 2024 ANSYS, Inc. and/or its affiliates.
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
 # SPDX-License-Identifier: MIT
 #
 #

pyedb/exceptions.py

@@ -1,3 +1,25 @@
+# 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/extensions/__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/extensions/create_cell_array.py

@@ -1,4 +1,4 @@
-# Copyright (C) 2023 - 2024 ANSYS, Inc. and/or its affiliates.
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
 # SPDX-License-Identifier: MIT
 #
 #

pyedb/extensions/via_design_backend.py

@@ -1,3 +1,25 @@
+# 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.
+
 from copy import deepcopy as copy
 import json
 from pathlib import Path

pyedb/generic/__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/generic/constants.py

@@ -1,4 +1,4 @@
-# Copyright (C) 2023 - 2024 ANSYS, Inc. and/or its affiliates.
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
 # SPDX-License-Identifier: MIT
 #
 #

pyedb/generic/data_handlers.py

@@ -1,3 +1,25 @@
+# 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.
+
 # -*- coding: utf-8 -*-
 from decimal import Decimal
 import json

pyedb/generic/design_types.py

@@ -1,4 +1,4 @@
-# Copyright (C) 2023 - 2024 ANSYS, Inc. and/or its affiliates.
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
 # SPDX-License-Identifier: MIT
 #
 #

pyedb/generic/filesystem.py

@@ -1,3 +1,25 @@
+# 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.
+
 import os
 import secrets
 import shutil

pyedb/generic/general_methods.py

@@ -1,4 +1,4 @@
-# Copyright (C) 2023 - 2024 ANSYS, Inc. and/or its affiliates.
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
 # SPDX-License-Identifier: MIT
 #
 #
@@ -42,6 +42,7 @@ import sys
 import tempfile
 import time
 import traceback
+from typing import Dict
 
 from pyedb.generic.constants import CSS4_COLORS
 from pyedb.generic.settings import settings
@@ -135,6 +136,26 @@ def _exception(ex_info, func, args, kwargs, message="Type Error"):
         )
 
 
+def installed_ansys_em_versions() -> Dict[str, str]:
+    """
+    Scan environment variables and return a dict
+    {version: installation_path} for every ANSYS EM release found.
+    Versions are ordered from oldest → latest (latest appears last).
+    """
+    pattern = re.compile(r"^ANSYSEM_ROOT(\d{3})$", re.IGNORECASE)
+
+    # collect everything
+    versions = {}
+    for key, value in os.environ.items():
+        m = pattern.match(key)
+        if m:
+            version = m.group(1)
+            versions[version] = value.rstrip(os.sep)
+
+    # sort ascending so the latest is last
+    return dict(sorted(versions.items(), key=lambda kv: int(kv[0])))
+
+
 def get_filename_without_extension(path):
     """Get the filename without its extension.
 

pyedb/generic/grpc_warnings.py

@@ -1,3 +1,25 @@
+# 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.
+
 GRPC_GENERAL_WARNING = (
     "Your ANSYS AEDT version is eligible to gRPC version."
     "You might consider switching to that version for better user experience."

pyedb/generic/plot.py

@@ -1,3 +1,25 @@
+# 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.
+
 import os
 
 from matplotlib.patches import PathPatch

pyedb/generic/process.py

@@ -1,3 +1,25 @@
+# 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.
+
 import os.path
 from pathlib import Path
 import subprocess  # nosec B404
@@ -48,6 +70,11 @@ class SiwaveSolve(object):
     def solve_siwave(self, edbpath, analysis_type):
         """Solve an SIWave setup. Only non-graphical batch mode is supported.
 
+        .. warning::
+            Do not execute this function with untrusted function argument, environment
+            variables or pyedb global settings.
+            See the :ref:`security guide<ref_security_consideration>` for details.
+
         Parameters
         ----------
         analysis_type: str
@@ -67,8 +94,8 @@ class SiwaveSolve(object):
             "-useSubdir",
         ]
         try:
-            subprocess.run(command, check=True)
-        except subprocess.CalledProcessError as e:
+            subprocess.run(command, check=True)  # nosec
+        except subprocess.CalledProcessError as e:  # nosec
             raise RuntimeError(f"An error occurred when launching the solver. Please check input paths") from e
 
     def solve(self, num_of_cores=4):

pyedb/generic/settings.py

@@ -1,4 +1,4 @@
-# Copyright (C) 2023 - 2024 ANSYS, Inc. and/or its affiliates.
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
 # SPDX-License-Identifier: MIT
 #
 #