Import Materials#

This example shows how to import materials.

Import the required packages#

[1]:

import json
from pathlib import Path
import tempfile

from IPython.display import display
import pandas as pd
from pyaedt.downloads import download_file

from pyedb import Edb

AEDT_VERSION = "2024.1"
NG_MODE = False

Download the example PCB data.

[2]:

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

Load example layout.#

[3]:

edbapp = Edb(file_edb, edbversion=AEDT_VERSION)

PyAEDT INFO: Logger is initialized in EDB.
PyAEDT INFO: legacy v0.23.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.1
PyAEDT INFO: Cell main Opened
PyAEDT INFO: Builder was initialized.
PyAEDT INFO: EDB initialized.

Review materials from layout#

Get materials from layout in a dictionary. Materials are exported together with stadckup.

[4]:

data_cfg = edbapp.configuration.get_data_from_db(stackup=True)

PyAEDT INFO: Getting data from layout database.

[5]:

df = pd.DataFrame(data=data_cfg["stackup"]["materials"])
display(df)
name permittivity conductivity dielectric_loss_tangent magnetic_loss_tangent mass_density permeability poisson_ratio specific_heat thermal_conductivity
0 copper 0.00 58000000.0 0.000 0.0 0.0 0.0 0.00 0.0 0.000
1 FR4_epoxy 4.40 0.0 0.020 0.0 1900.0 0.0 0.28 1150.0 0.294
2 Megtron4 3.77 0.0 0.005 0.0 0.0 0.0 0.00 0.0 0.000
3 Megtron4_2 3.47 0.0 0.006 0.0 0.0 0.0 0.00 0.0 0.000
4 Megtron4_3 4.20 0.0 0.005 0.0 0.0 0.0 0.00 0.0 0.000
5 Solder Resist 3.00 0.0 0.000 0.0 0.0 0.0 0.00 0.0 0.000

Add a new material#

[6]:

data_cfg["stackup"]["materials"].append(
    {"name": "soldermask", "permittivity": 3.3, "dielectric_loss_tangent": 0.02},
)

Edit existing material properties#

[7]:

data_cfg["stackup"]["materials"][1]["name"] = "fr4_epoxy"
data_cfg["stackup"]["materials"][1]["dielectric_loss_tangent"] = 0.015

Review modified materials#

[8]:

df = pd.DataFrame(data=data_cfg["stackup"]["materials"])
display(df)
name permittivity conductivity dielectric_loss_tangent magnetic_loss_tangent mass_density permeability poisson_ratio specific_heat thermal_conductivity
0 copper 0.00 58000000.0 0.000 0.0 0.0 0.0 0.00 0.0 0.000
1 fr4_epoxy 4.40 0.0 0.015 0.0 1900.0 0.0 0.28 1150.0 0.294
2 Megtron4 3.77 0.0 0.005 0.0 0.0 0.0 0.00 0.0 0.000
3 Megtron4_2 3.47 0.0 0.006 0.0 0.0 0.0 0.00 0.0 0.000
4 Megtron4_3 4.20 0.0 0.005 0.0 0.0 0.0 0.00 0.0 0.000
5 Solder Resist 3.00 0.0 0.000 0.0 0.0 0.0 0.00 0.0 0.000
6 soldermask 3.30 NaN 0.020 NaN NaN NaN NaN NaN NaN

Write material definition into a json file#

[9]:

file_cfg = Path(temp_folder.name) / "edb_configuration.json"
with open(file_cfg, "w") as f:
    json.dump(data_cfg, f, indent=4, ensure_ascii=False)

Load materials from json configuration file#

[10]:

edbapp.configuration.load(str(file_cfg), apply_file=True)

[10]:

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

Review materials from layout#

[11]:

edbapp.materials.materials

[11]:

{'copper': <pyedb.dotnet.edb_core.materials.Material at 0x1adc9fd2c00>,
 'fr4_epoxy': <pyedb.dotnet.edb_core.materials.Material at 0x1adc9fc6140>,
 'Megtron4': <pyedb.dotnet.edb_core.materials.Material at 0x1adc9fc9e00>,
 'Megtron4_2': <pyedb.dotnet.edb_core.materials.Material at 0x1adc9fc9880>,
 'Megtron4_3': <pyedb.dotnet.edb_core.materials.Material at 0x1adc9fc97c0>,
 'Solder Resist': <pyedb.dotnet.edb_core.materials.Material at 0x1adc9fc9800>,
 'soldermask': <pyedb.dotnet.edb_core.materials.Material at 0x1adc9fc9f40>}

Check modified material properties#

[12]:

edbapp.materials["fr4_epoxy"].loss_tangent

[12]:

0.015

Close EDB#

[13]:

edbapp.close()

[13]:

True