Advanced#

You can use PyAEDT for postprocessing of AEDT results to display graphics object and plot data.

Touchstone#

TouchstoneData class is based on scikit-rf package and allows advanced touchstone post-processing. The following methods allows to read and check touchstone files.

TouchstoneData.get_insertion_loss_index

Get all insertion losses.

TouchstoneData.plot_insertion_losses

Plot all insertion losses.

TouchstoneData.plot

Plot a list of curves.

TouchstoneData.plot_return_losses

Plot all return losses.

TouchstoneData.get_mixed_mode_touchstone_data

Transform network from single ended parameters to generalized mixed mode parameters.

TouchstoneData.get_return_loss_index

Get the list of all the Returnloss from a list of exctitations.

TouchstoneData.get_insertion_loss_index_from_prefix

Get the list of all the Insertion Losses from prefix.

TouchstoneData.get_next_xtalk_index

Get the list of all the Near End XTalk a list of excitation.

TouchstoneData.get_fext_xtalk_index_from_prefix

Get the list of all the Far End XTalk from a list of exctitations and a prefix that will be used to retrieve driver and receivers names.

TouchstoneData.plot_next_xtalk_losses

Plot all next crosstalk curves.

TouchstoneData.plot_fext_xtalk_losses

Plot all fext crosstalk curves.

TouchstoneData.get_worst_curve

Analyze a solution data object with multiple curves and find the worst curve.

read_touchstone

Load the contents of a Touchstone file into an NPort.

check_touchstone_files

Check passivity and causality for all Touchstone files included in the folder.

find_touchstone_files

Get all Touchstone files in a directory.

Here an example on how to use TouchstoneData class.

from ansys.aedt.core.visualization.advanced.touchstone_parser import TouchstoneData

ts1 = TouchstoneData(touchstone_file=os.path.join(test_T44_dir, "port_order_1234.s8p"))
assert ts1.get_mixed_mode_touchstone_data()
ts2 = TouchstoneData(touchstone_file=os.path.join(test_T44_dir, "port_order_1324.s8p"))
assert ts2.get_mixed_mode_touchstone_data(port_ordering="1324")

assert ts1.plot_insertion_losses(plot=False)
assert ts1.get_worst_curve(curve_list=ts1.get_return_loss_index(), plot=False)

Farfield#

PyAEDT offers sophisticated tools for advanced farfield post-processing. There are two complementary classes: FfdSolutionDataExporter and FfdSolutionData.

  • FfdSolutionDataExporter: Enables efficient export and manipulation of farfield data. It allows users to convert simulation results into a standard metadata format for further analysis, or reporting.

  • FfdSolutionData: Focuses on the direct access and processing of farfield solution data. It supports a comprehensive set of postprocessing operations, from visualizing radiation patterns to computing key performance metrics.

FfdSolutionData

Provides antenna far-field data.

This code shows how you can get the farfield data and perform some post-processing:

import ansys.aedt.core
from ansys.aedt.core.generic.farfield_visualization import FfdSolutionDataExporter
app = ansys.aedt.core.Hfss()
ffdata = app.get_antenna_data(frequencies=None,
                              setup="Setup1 : Sweep",
                              sphere="3D",
                              variations=None,
                              overwrite=False,
                              link_to_hfss=True,
                              export_touchstone=True)
incident_power = ffdata.incident_power
ffdata.plot_cut(primary_sweep="Theta", theta=0)
ffdata.plot_contour(polar=True)
ffdata.plot_3d(show_geometry=False)
app.release_desktop(False, False)

If you exported the farfield data previously, you can directly get the farfield data:

from ansys.aedt.core.generic.farfield_visualization import FfdSolutionData
input_file = r"path_to_ffd\pyaedt_antenna_metadata.json"
ffdata = FfdSolutionData(input_file)
incident_power = ffdata.incident_power
ffdata.plot_cut(primary_sweep="Theta", theta=0)
ffdata.plot_contour(polar=True)
ffdata.plot_3d(show_geometry=False)
app.release_desktop(False, False)

The following diagram shows both classes work. You can use them independently or from the get_antenna_data method.

If you have existing farfield data, or you want to export it manually, you can still use FfdSolutionData class.

Heterogeneous data message#

Heterogeneous data message (HDM) is the file exported from SBR+ solver containing rays information. The following methods allows to read and plot rays information.

hdm_plot.HDMPlotter

Manages Hdm data to be plotted with pyvista.

sbrplus.hdm_parser.Parser

Parser class that loads an HDM-format export file from HFSS SBR+, interprets its header and its binary content.

Miscellaneous#

PyAEDT has additional advanced post-processing features:

convert_nearfield_data

Convert a near field data folder to hfss nfd file and link it to and file.

parse_rdat_file

Parse Ansys report '.rdat' file.

nastran_to_stl

Convert Nastran file into stl.

simplify_stl

Import and simplify a stl file using pyvista and fast-simplification.