Download this example
Download this example as a Jupyter Notebook or as a Python script.
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
Perform imports and define constants#
Perform required imports.
[1]:
import json
import toml
from pathlib import Path
import tempfile
from IPython.display import display
from ansys.aedt.core.examples.downloads import download_file
import pandas as pd
from pyedb import Edb
Define constants.
[2]:
AEDT_VERSION = "2025.2"
Download the example PCB data.
[3]:
temp_folder = tempfile.TemporaryDirectory(suffix=".ansys").name
file_edb = download_file(source="edb/ANSYS-HSD_V1.aedb", local_path=temp_folder)
Load example layout.#
[4]:
edbapp = Edb(file_edb, edbversion=AEDT_VERSION)
C:\actions-runner\_work\pyaedt-examples\pyaedt-examples\.venv\lib\site-packages\pyedb\misc\decorators.py:33: UserWarning: Argument `edbversion` is deprecated for method `Edb`; use `version` instead.
warnings.warn(
C:\actions-runner\_work\pyaedt-examples\pyaedt-examples\.venv\lib\site-packages\pyedb\generic\design_types.py:327: UserWarning: 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
warnings.warn(GRPC_GENERAL_WARNING, UserWarning)
PyEDB INFO: Star initializing Edb 03:53:18.997488
PyEDB INFO: Edb version 2025.2
PyEDB INFO: Logger is initialized. Log file is saved to C:\Users\ansys\AppData\Local\Temp\pyedb_ansys.log.
PyEDB INFO: legacy v0.56.0
PyEDB INFO: Python version 3.10.11 (tags/v3.10.11:7d4cc5a, Apr 5 2023, 00:38:17) [MSC v.1929 64 bit (AMD64)]
PyEDB INFO: Database ANSYS-HSD_V1.aedb Opened in 2025.2
PyEDB INFO: Cell main Opened
PyEDB INFO: Builder was initialized.
PyEDB INFO: open_edb completed in 7.4332 seconds.
PyEDB INFO: EDB initialization completed in 7.5129 seconds.
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’.
[5]:
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",
},
}
]
[6]:
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'} |
[7]:
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
[8]:
edbapp.configuration.load(cfg_file_path, apply_file=True)
PyEDB INFO: Updating boundaries finished. Time lapse 0:00:00.015847
PyEDB INFO: Updating nets finished. Time lapse 0:00:00
PyEDB INFO: Updating components finished. Time lapse 0:00:00
PyEDB INFO: Creating pin groups finished. Time lapse 0:00:00
PyEDB INFO: Placing sources finished. Time lapse 0:00:00
PyEDB INFO: Creating setups finished. Time lapse 0:00:00
PyEDB INFO: Applying materials finished. Time lapse 0:00:00
PyEDB INFO: Updating stackup finished. Time lapse 0:00:00
PyEDB INFO: Applying padstacks finished. Time lapse 0:00:00.015815
PyEDB INFO: Applying S-parameters finished. Time lapse 0:00:00
PyEDB INFO: Applying package definitions finished. Time lapse 0:00:00
PyEDB INFO: Applying modeler finished. Time lapse 0:00:00.510400
PyEDB INFO: Placing ports finished. Time lapse 0:00:00
PyEDB INFO: Placing probes finished. Time lapse 0:00:00
PyEDB INFO: Applying operations finished. Time lapse 0:00:00
[8]:
<pyedb.configuration.cfg_data.CfgData at 0x2497d1d3b20>
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]:
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)
Equivalent toml file looks like below
[11]:
toml_string = toml.dumps(cfg)
print(toml_string)
[padstacks]
[[padstacks.definitions]]
name = "v35h15"
[padstacks.definitions.pad_parameters]
[[padstacks.definitions.pad_parameters.regular_pad]]
layer_name = "1_Top"
shape = "circle"
offset_x = "0.1mm"
offset_y = "0.1mm"
rotation = "0"
diameter = "0.5mm"
[[padstacks.definitions.pad_parameters.regular_pad]]
layer_name = "Inner1(GND1)"
shape = "square"
offset_x = "0.1mm"
offset_y = "0.1mm"
rotation = "45deg"
size = "0.5mm"
[[padstacks.definitions.pad_parameters.anti_pad]]
layer_name = "1_Top"
shape = "circle"
diameter = "1mm"
Load config file
[12]:
edbapp.configuration.load(cfg_file_path, apply_file=True)
PyEDB INFO: Updating boundaries finished. Time lapse 0:00:00
PyEDB INFO: Updating nets finished. Time lapse 0:00:00
PyEDB INFO: Updating components finished. Time lapse 0:00:00
PyEDB INFO: Creating pin groups finished. Time lapse 0:00:00
PyEDB INFO: Placing sources finished. Time lapse 0:00:00
PyEDB INFO: Creating setups finished. Time lapse 0:00:00
PyEDB INFO: Applying materials finished. Time lapse 0:00:00
PyEDB INFO: Updating stackup finished. Time lapse 0:00:00
PyEDB INFO: Applying padstacks finished. Time lapse 0:00:00
PyEDB INFO: Applying S-parameters finished. Time lapse 0:00:00
PyEDB INFO: Applying package definitions finished. Time lapse 0:00:00
PyEDB INFO: Applying modeler finished. Time lapse 0:00:00.428683
PyEDB INFO: Placing ports finished. Time lapse 0:00:00
PyEDB INFO: Placing probes finished. Time lapse 0:00:00
PyEDB INFO: Applying operations finished. Time lapse 0:00:00
[12]:
<pyedb.configuration.cfg_data.CfgData at 0x2491733aa40>
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.
[13]:
edbapp.save()
edbapp.close()
PyEDB INFO: Save Edb file completed in 0.1110 seconds.
PyEDB INFO: Close Edb file completed in 0.0808 seconds.
[13]:
True
Download this example
Download this example as a Jupyter Notebook or as a Python script.