FEAT: Design_mode

.github/workflows/ci_cd.yml

@@ -94,6 +94,10 @@ jobs:
   smoke-tests:
     name: Build and Smoke tests (${{ matrix.os }} | Python ${{ matrix.python-version }})
     runs-on: ${{ matrix.os }}
+    permissions:
+      attestations: write
+      contents: read
+      id-token: write
     strategy:
       fail-fast: false
       matrix:
@@ -107,6 +111,7 @@ jobs:
           library-name: ${{ env.PACKAGE_NAME }}
           operating-system: ${{ matrix.os }}
           python-version: ${{ matrix.python-version }}
+          attest-provenance: true
 
       - name: Import python package
         shell: bash
@@ -449,14 +454,14 @@ jobs:
       - name: "Create coverage files"
         run: |
           . .venv/bin/activate
-          python -m coverage html -d .cov\system-html
-          python -m coverage xml -o .cov\system.xml
+          python -m coverage html -d .cov/system-html
+          python -m coverage xml -o .cov/system.xml
 
       - name: Upload Coverage Results
         if: always()
         uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
         with:
-          path: .cov\system-html
+          path: .cov/system-html
           name: html-system-linux-coverage-${{ github.job }}-${{ github.run_attempt }}
           retention-days: 7
 
@@ -524,14 +529,14 @@ jobs:
       - name: "Create coverage files"
         run: |
           . .venv/bin/activate
-          python -m coverage html -d .cov\system-html
-          python -m coverage xml -o .cov\system.xml
+          python -m coverage html -d .cov/system-html
+          python -m coverage xml -o .cov/system.xml
 
       - name: Upload Coverage Results
         if: always()
         uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
         with:
-          path: .cov\system-html
+          path: .cov/system-html
           name: html-system-linux-coverage-${{ github.job }}-${{ github.run_attempt }}
           retention-days: 7
 
@@ -599,14 +604,14 @@ jobs:
       - name: "Create coverage files"
         run: |
           . .venv/bin/activate
-          python -m coverage html -d .cov\unit-html
-          python -m coverage xml -o .cov\unit.xml
+          python -m coverage html -d .cov/unit-html
+          python -m coverage xml -o .cov/unit.xml
 
       - name: Upload Coverage Results
         if: always()
         uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
         with:
-          path: .cov\unit-html
+          path: .cov/unit-html
           name: html-unit-linux-coverage-${{ github.job }}-${{ github.run_attempt }}
           retention-days: 7
 
@@ -674,14 +679,14 @@ jobs:
       - name: "Create coverage files"
         run: |
           . .venv/bin/activate
-          python -m coverage html -d .cov\unit-html
-          python -m coverage xml -o .cov\unit.xml
+          python -m coverage html -d .cov/unit-html
+          python -m coverage xml -o .cov/unit.xml
 
       - name: Upload Coverage Results
         if: always()
         uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
         with:
-          path: .cov\unit-html
+          path: .cov/unit-html
           name: html-unit-linux-coverage-${{ github.job }}-${{ github.run_attempt }}
           retention-days: 7
 
@@ -929,12 +934,17 @@ jobs:
             unit-tests-linux-grpc,
             docs-build]
     runs-on: ubuntu-latest
+    permissions:
+      attestations: write
+      contents: read
+      id-token: write
     steps:
       - name: Build library source and wheel artifacts
         uses: ansys/actions/build-library@c2fa7c93f6883114e0e643599431b33d29f0b13f # v10.1.4
         with:
           library-name: ${{ env.PACKAGE_NAME }}
           python-version: ${{ env.MAIN_PYTHON_VERSION }}
+          attest-provenance: true
 
   release:
     name: Release project
@@ -967,6 +977,7 @@ jobs:
         with:
           library-name: ${{ env.PACKAGE_NAME }}
           token: ${{ secrets.GITHUB_TOKEN }}
+          add-artifact-attestation-notes: true
 
   upload-dev-docs:
     name: Upload dev documentation

doc/changelog.d/1601.maintenance.md

@@ -0,0 +1 @@
+Adding artifact attestations and fix warnings related to coverage upload

doc/changelog.d/1602.added.md

@@ -0,0 +1 @@
+Layout file warnings

doc/changelog.d/1605.added.md

@@ -0,0 +1 @@
+Design_mode

examples/use_configuration/dcir.py

@@ -0,0 +1,179 @@
+# 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.
+
+# # DCIR Setup Leveraging EDB Configuration Format
+
+# ## Import the required packages
+
+import json
+
+# +
+import os
+import tempfile
+
+from ansys.aedt.core import Hfss3dLayout
+from ansys.aedt.core.downloads import download_file
+
+from pyedb import Edb
+
+AEDT_VERSION = "2024.2"
+NG_MODE = False
+
+# -
+
+# Download the example BGA Package design.
+
+temp_folder = tempfile.TemporaryDirectory(suffix=".ansys")
+file_edb = download_file(source=r"edb/BGA_Package.aedb", destination=temp_folder.name)
+
+# ## Load example layout
+
+edbapp = Edb(file_edb, edbversion=AEDT_VERSION)
+
+# ## Create config file
+
+# Define Component with solderballs.
+
+cfg_components = [
+    {
+        "reference_designator": "FCHIP",
+        "part_type": "other",
+        "solder_ball_properties": {
+            "shape": "cylinder",
+            "diameter": "0.1mm",
+            "height": "0.085mm",
+            "chip_orientation": "chip_up",
+        },
+        "port_properties": {
+            "reference_offset": 0,
+            "reference_size_auto": False,
+            "reference_size_x": 0,
+            "reference_size_y": 0,
+        },
+    },
+    {
+        "reference_designator": "BGA",
+        "part_type": "io",
+        "solder_ball_properties": {
+            "shape": "cylinder",
+            "diameter": "0.45mm",
+            "height": "0.45mm",
+            "chip_orientation": "chip_down",
+        },
+        "port_properties": {
+            "reference_offset": 0,
+            "reference_size_auto": False,
+            "reference_size_x": 0,
+            "reference_size_y": 0,
+        },
+    },
+]
+
+# Define Pin Groups on Components.
+
+cfg_pin_groups = [
+    {"name": "BGA_VSS", "reference_designator": "BGA", "net": "VSS"},
+    {"name": "BGA_VDD", "reference_designator": "BGA", "net": "VDD"},
+]
+
+# Define sources.
+
+cfg_sources = [
+    {
+        "name": "FCHIP_Current",
+        "reference_designator": "FCHIP",
+        "type": "current",
+        "magnitude": 2,
+        "distributed": True,
+        "positive_terminal": {"net": "VDD"},
+        "negative_terminal": {"nearest_pin": {"reference_net": "VSS", "search_radius": 5e-3}},
+    },
+    {
+        "name": "BGA_Voltage",
+        "reference_designator": "BGA",
+        "type": "voltage",
+        "magnitude": 1,
+        "positive_terminal": {"pin_group": "BGA_VDD"},
+        "negative_terminal": {"pin_group": "BGA_VSS"},
+    },
+]
+
+# Define DCIR setup.
+
+cfg_setups = [
+    {
+        "name": "siwave_dc",
+        "type": "siwave_dc",
+        "dc_slider_position": 1,
+        "dc_ir_settings": {"export_dc_thermal_data": True},
+    }
+]
+
+# Create final configuration.
+
+cfg = {
+    "components": cfg_components,
+    "sources": cfg_sources,
+    "pin_groups": cfg_pin_groups,
+    "setups": cfg_setups,
+}
+
+# Create the config file.
+
+file_json = os.path.join(temp_folder.name, "edb_configuration.json")
+with open(file_json, "w") as f:
+    json.dump(cfg, f, indent=4, ensure_ascii=False)
+
+# ## Apply Config file
+
+# Apply configuration to the example layout
+
+edbapp.configuration.load(config_file=file_json)
+edbapp.configuration.run()
+
+# Save and close EDB.
+
+edbapp.save()
+edbapp.close()
+
+# The configured EDB file is saved in a temp folder.
+
+print(temp_folder.name)
+
+# ## Load edb into HFSS 3D Layout.
+
+h3d = Hfss3dLayout(edbapp.edbpath, version=AEDT_VERSION, non_graphical=NG_MODE, new_desktop=True)
+
+# Solve.
+
+h3d.analyze(setup="siwave_dc")
+
+# Plot insertion loss.
+
+h3d.post.create_fieldplot_layers_nets(layers_nets=[["VDD_C1", "VDD"]], quantity="Voltage", setup="siwave_dc")
+
+# Shut Down Electronics Desktop
+
+h3d.close_desktop()
+
+# All project files are saved in the folder ``temp_file.dir``. If you've run this example as a Jupyter notebook you
+# can retrieve those project files.

src/pyedb/dotnet/edb.py

@@ -839,11 +839,15 @@ def import_layout_file(
         try:
             subprocess.run(cmd_translator, check=True)  # nosec
         except subprocess.CalledProcessError as e:  # nosec
-            raise RuntimeError("An error occurred while translating board file to ``edb.def`` file") from e
+            raise RuntimeError(
+                "An error occurred while translating board file to ``edb.def`` file. Please check the log file."
+            ) from e
         if not os.path.exists(os.path.join(working_dir, aedb_name)):
-            raise RuntimeWarning(f"Translator failed. command : {' '.join(cmd_translator)}")
+            raise RuntimeWarning(
+                f"Translation failed. command : {' '.join(cmd_translator)}. Please check the log file."
+            )
         else:
-            self.logger.info("Translation correctly completed")
+            self.logger.info("Translation successfully completed")
         self.edbpath = os.path.join(working_dir, aedb_name)
         return self.open_edb()