English | 中文
PyAEDT is a Python library that interacts directly with the API for Ansys Electronics Desktop (AEDT) to make scripting simpler. The architecture for PyAEDT can be reused for all AEDT 3D products (HFSS, Icepak, Maxwell 3D, and Q3D Extractor), 2D tools, and Ansys Mechanical inside AEDT. PyAEDT also provides support for circuit tools like Nexxim and system simulation tools like Twin Builder. Finally, PyAEDT provides scripting capabilities in Ansys layout tools like HFSS 3D Layout. The Ansys Electronics Database (EDB) is included with PyAEDT as a dependency and is recommended for any automated manipulation and setup of layout data for PCBs, electronic packages, and integrated circuits.
The PyAEDT class and method structures simplify operation while reusing information as much as possible across the API.
You can install PyAEDT on CPython 3.8 through 3.12 from PyPI with this command:
pip install pyaedt
Install PyAEDT with all extra packages (matplotlib, numpy, pandas, pyvista):
pip install pyaedt[all]
You can also install PyAEDT from Conda-Forge with this command:
conda install -c conda-forge pyaedt
PyAEDT remains compatible with IronPython and can be still used in the AEDT Framework.
PyAEDT has different compatibility requirements based on its version. Below is an overview of the compatibility matrix between PyAEDT, Python versions, and AEDT releases:
PyAEDT is part of the larger PyAnsys effort to facilitate the use of Ansys technologies directly from Python.
PyAEDT is intended to consolidate and extend all existing functionalities around scripting for AEDT to allow reuse of existing code, sharing of best practices, and increased collaboration.
AEDT is a platform that enables true electronics system design. AEDT provides access to the Ansys gold-standard electro-magnetics simulation solutions, such as Ansys HFSS, Ansys Maxwell, Ansys Q3D Extractor, Ansys SIwave, and Ansys Icepak using electrical CAD (ECAD) and Mechanical CAD (MCAD) workflows.
In addition, AEDT includes direct links to the complete Ansys portfolio of thermal, fluid, and mechanical solvers for comprehensive multiphysics analysis. Tight integration among these solutions provides unprecedented ease of use for setup and faster resolution of complex simulations for design and optimization.
PyAEDT is licensed under the MIT License
PyAEDT includes functionality for interacting with the following AEDT tools and Ansys products:
Documentation for the latest stable release of PyAEDT is hosted at PyAEDT documentation.
In the upper right corner of the documentation's title bar, there is an option for switching from viewing the documentation for the latest stable release to viewing the documentation for the development version or previously released versions.
You can also view or download PyAEDT cheat sheets, which are one-page references providing syntax rules and commands for using the PyAEDT API and PyEDB API:
On the PyAEDT Issues page, you can create issues to report bugs and request new features. On the PyAEDT Discussions page or the Discussions page on the Ansys Developer portal, you can post questions, share ideas, and get community feedback.
To reach the project support team, email pyansys.core@ansys.com.
To run PyAEDT, you must have a local licenced copy of AEDT. PyAEDT supports AEDT versions 2022 R1 or newer.
For comprehensive information on contributing to the PyAnsys project, see the PyAnsys developer's guide.
Note that PyAEDT uses semantic naming for pull requests (PR). This convention greatly simplifies the review process by providing meaningful information in the PR title. The following prefixes should be used for pull request name:
PyAEDT supports AEDT Student versions 2022 R1 and later. For more information, see the Ansys Electronics Desktop Student - Free Software Download page on the Ansys website.
A quick and easy approach for automating a simple operation in the AEDT UI is to record and reuse a script. However, disadvantages of this approach are:
The main advantages of PyAEDT are:
Desktop class with the version of AEDT to use.PyAEDT works both inside AEDT and as a standalone application. This Python library automatically detects whether it is running in an IronPython or CPython environment and initializes AEDT accordingly. PyAEDT also provides advanced error management. Usage examples follow.
# Launch AEDT 2022 R2 in non-graphical mode
from ansys.aedt.core import Desktop, Circuit
with Desktop(specified_version="2022.2",
non_graphical=False, new_desktop_session=True,
close_on_exit=True, student_version=False):
circuit = Circuit()
...
# Any error here will be caught by Desktop.
...
# Desktop is automatically released here.
# Launch the latest installed version of AEDT in graphical mode
from ansys.aedt.core import Circuit
with Circuit(specified_version="2022.2",
non_graphical=False) as circuit:
...
# Any error here will be caught by Desktop.
...
# Desktop is automatically released here.
You can make a remote application call on a CPython server or any Windows client machine.
On a CPython Server:
# Launch PyAEDT remote server on CPython
from ansys.aedt.core.common_rpc import pyaedt_service_manager
pyaedt_service_manager()
On any Windows client machine:
from ansys.aedt.core.common_rpc import create_session
cl1 = create_session("server_name")
cl1.aedt(port=50000, non_graphical=False)
hfss = Hfss(machine="server_name", port=50000)
# your code here
from ansys.aedt.core.HFSS import HFSS
with HFSS as hfss:
hfss["dim"] = "1mm" # design variable
hfss["$dim"] = "1mm" # project variable
# Create a box, assign variables, and assign materials.
from ansys.aedt.core.hfss import Hfss
with Hfss as hfss:
hfss.modeler.create_box([0, 0, 0], [10, "dim", 10],
"mybox", "aluminum")
PyAEDT is licensed under the MIT license.
PyAEDT makes no commercial claim over Ansys whatsoever. This library extends the functionality of AEDT by adding a Python interface to AEDT without changing the core behavior or license of the original software. The use of PyAEDT requires a legally licensed local copy of AEDT.
To get a copy of AEDT, see the Ansys Electronics page on the Ansys website.
FAQs
High-level Python API for Ansys Electronics Desktop Framework
We found that pyaedt demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.
Security News
Research
Socket researchers found a malicious Maven package impersonating the legitimate ‘XZ for Java’ library, introducing a backdoor for remote code execution.