Import Padstack Definitions#

This example shows how to import padstack definitions. This includes

Download an example board
Create a config file with hole information
Create a config file with pad and anti-pad information

Import the required packages#

[1]:

import json
from pathlib import Path
import tempfile

from IPython.display import display
from ansys.aedt.core.downloads import download_file
import pandas as pd

from pyedb import Edb

AEDT_VERSION = "2024.2"

Download the example PCB data.

[2]:

temp_folder = tempfile.TemporaryDirectory(suffix=".ansys").name
file_edb = download_file(source="edb/ANSYS-HSD_V1.aedb", destination=temp_folder)

Load example layout.#

[3]:

edbapp = Edb(file_edb, edbversion=AEDT_VERSION)

PyAEDT INFO: Logger is initialized in EDB.
PyAEDT INFO: legacy v0.31.0
PyAEDT INFO: Python version 3.10.11 (tags/v3.10.11:7d4cc5a, Apr  5 2023, 00:38:17) [MSC v.1929 64 bit (AMD64)]
PyAEDT INFO: Database ANSYS-HSD_V1.aedb Opened in 2024.2
PyAEDT INFO: Cell main Opened
PyAEDT INFO: Builder was initialized.
PyAEDT INFO: EDB initialized.

Create a config file with hole information#

Keywords

name. Name of the padstack definition.
hole_plating_thickness. Hole plating thickness.
hole_range. Supported types are ‘through’, ‘begin_on_upper_pad’, ‘end_on_lower_pad’, ‘upper_pad_to_lower_pad’.
hole_parameters.
- shape. Supported types are ‘circle’, ‘square’, ‘rectangle’.
- Other parameters are shape dependent.
  - When shape is ‘circle’, supported parameter si ‘diameter’.
  - When shape is ‘square’, supported parameter is ‘size’.
  - When shape is ‘rectangle’, supported parameters are ‘x_size’, ‘y_size’.

[4]:

cfg = dict()
cfg["padstacks"] = {}
cfg["padstacks"]["definitions"] = [
    {
        "name": "v35h15",
        "hole_plating_thickness": "25um",
        "material": "copper",
        "hole_range": "through",
        "hole_parameters": {
            "shape": "circle",
            "diameter": "0.15mm",
        },
    }
]

[5]:

df = pd.DataFrame(data=cfg["padstacks"]["definitions"])
display(df)

	name	hole_plating_thickness	material	hole_range	hole_parameters
0	v35h15	25um	copper	through	{'shape': 'circle', 'diameter': '0.15mm'}

[6]:

cfg_file_path = Path(temp_folder) / "cfg.json"
with open(cfg_file_path, "w") as f:
    json.dump(cfg, f, indent=4, ensure_ascii=False)

Load config file

[7]:

edbapp.configuration.load(cfg_file_path, apply_file=True)

[7]:

<pyedb.configuration.cfg_data.CfgData at 0x1941666d270>

Check layout

[8]:

pdef = edbapp.padstacks.definitions["v35h15"]
display(pdef.hole_plating_thickness)
display(pd.DataFrame([pdef.hole_parameters]))

2.500005000009999e-05

	shape	diameter	offset_x	offset_y	rotation
0	circle	0.15mm	0	0	0

Create a config file with pad information#

Keywords

name. Name of the padstack definition.
pad_parameters.
- regular_pad. List of pad definition per layer.
  - layer_name. Name of the layer.
  - shape. Supported types are ‘circle’, ‘square’, ‘rectangle’, ‘oval’, ‘bullet’.
  - Other parameters are shape dependent.
    - When shape is ‘circle’, supported parameter si ‘diameter’.
    - When shape is ‘square’, supported parameter is ‘size’.
    - When shape is ‘rectangle’, supported parameters are ‘x_size’, ‘y_size’.
    - When shape is ‘oval’, supported parameters are ‘x_size’, ‘y_size’, ‘corner_radius’.
    - When shape is ‘bullet’, supported parameters are ‘x_size’, ‘y_size’, ‘corner_radius’.

[9]:

cfg = dict()
cfg["padstacks"] = {}
cfg["padstacks"]["definitions"] = [
    {
        "name": "v35h15",
        "pad_parameters": {
            "regular_pad": [
                {
                    "layer_name": "1_Top",
                    "shape": "circle",
                    "offset_x": "0.1mm",
                    "offset_y": "0.1mm",
                    "rotation": "0",
                    "diameter": "0.5mm",
                },
                {
                    "layer_name": "Inner1(GND1)",
                    "shape": "square",
                    "offset_x": "0.1mm",
                    "offset_y": "0.1mm",
                    "rotation": "45deg",
                    "size": "0.5mm",
                },
            ],
            "anti_pad": [{"layer_name": "1_Top", "shape": "circle", "diameter": "1mm"}],
        },
    }
]

[10]:

df = pd.DataFrame(data=cfg["padstacks"]["definitions"][0]["pad_parameters"]["regular_pad"])
display(df)

	layer_name	shape	offset_x	offset_y	rotation	diameter	size
0	1_Top	circle	0.1mm	0.1mm	0	0.5mm	NaN
1	Inner1(GND1)	square	0.1mm	0.1mm	45deg	NaN	0.5mm

[11]:

df = pd.DataFrame(data=cfg["padstacks"]["definitions"][0]["pad_parameters"]["anti_pad"])
display(df)

	layer_name	shape	diameter
0	1_Top	circle	1mm

[12]:

cfg_file_path = Path(temp_folder) / "cfg.json"
with open(cfg_file_path, "w") as f:
    json.dump(cfg, f, indent=4, ensure_ascii=False)

Load config file

[13]:

edbapp.configuration.load(cfg_file_path, apply_file=True)

[13]:

<pyedb.configuration.cfg_data.CfgData at 0x1941666cee0>

Check layout

[14]:

pdef = edbapp.padstacks.definitions["v35h15"]

[15]:

display(pd.DataFrame(pdef.pad_parameters["regular_pad"]))

	layer_name	shape	offset_x	offset_y	rotation	diameter	size
0	1_Top	circle	0.1mm	0.1mm	0	0.5mm	NaN
1	Inner1(GND1)	square	0.1mm	0.1mm	0.785398163397448	NaN	0.5mm
2	Inner2(PWR1)	circle	0	0	0	0.3499993mm	NaN
3	Inner3(Sig1)	circle	0	0	0	0.3499993mm	NaN
4	Inner4(Sig2)	circle	0	0	0	0.3499993mm	NaN
5	Inner5(PWR2)	circle	0	0	0	0.3499993mm	NaN
6	Inner6(GND2)	circle	0	0	0	0.3499993mm	NaN
7	16_Bottom	circle	0	0	0	0.3499993mm	NaN

[16]:

display(pd.DataFrame(pdef.pad_parameters["anti_pad"]))

	layer_name	shape	diameter
0	1_Top	circle	1mm
1	Inner1(GND1)	no_geometry	NaN
2	Inner2(PWR1)	no_geometry	NaN
3	Inner3(Sig1)	no_geometry	NaN
4	Inner4(Sig2)	no_geometry	NaN
5	Inner5(PWR2)	no_geometry	NaN
6	Inner6(GND2)	no_geometry	NaN
7	16_Bottom	no_geometry	NaN

Save and close Edb#

The temporary folder will be deleted once the execution of this script is finished. Replace edbapp.save() with edbapp.save_as(“C:/example.aedb”) to keep the example project.

[17]:

edbapp.save()
edbapp.close()

[17]:

True