FEAT: Fresnel extension

doc/changelog.d/6480.added.md

@@ -0,0 +1 @@
+Fresnel extension

doc/source/User_guide/extensions.rst

@@ -176,6 +176,13 @@ They are small automated workflows with a simple GUI.
 
             Automated assembly workflow.
 
+   .. grid-item-card:: Fresnel coefficients
+            :link: pyaedt_extensions_doc/hfss/fresnel
+            :link-type: doc
+            :margin: 2 2 0 0
+
+            Extract Fresnel coefficients from HFSS Floquet port simulations for periodic structures.
+
 
 Icepak extensions
 ~~~~~~~~~~~~~~~~~

doc/source/User_guide/pyaedt_extensions_doc/hfss/fresnel.rst

@@ -0,0 +1,100 @@
+Fresnel coefficients (RTTBL extraction)
+=======================================
+
+With this extension, you can export Fresnel Coefficients for periodic structures from an HFSS Unit-Cell design with
+Floquet ports in the RTTBL file format for further use in SBR+ for Fresnel (SBR+) Boundary Condition assignment.
+
+You can access the extension from the icon created on the **Automation** tab using the Extension Manager.
+
+Features
+--------
+
+The extension supports two regimes for processing Fresnel Coefficients:
+
+* **Isotropic**: Scans over the elevation angle (theta) only - coupling between the TE and TM polarizations is not considered
+* **Anisotropic**: Scans over both elevation (theta) and azimuth (phi) angles (not available yet) - considering the polarization coupling
+
+Workflows
+---------
+
+The extension provides two workflow tabs:
+
+Extraction workflow
+~~~~~~~~~~~~~~~~~~~
+
+Extract Fresnel coefficients from existing analysis results for a setup with parametric sweep.
+
+1. Select a simulation setup and sweep
+2. Click **Validate** to verify the design configuration
+3. Click **Start** to extract the coefficients
+
+.. image:: ../../../_static/extensions/fresnel_extraction.png
+  :width: 800
+  :alt: Fresnel Extraction workflow
+
+Advanced workflow
+~~~~~~~~~~~~~~~~~
+
+Configure and run a new parametric analysis:
+
+1. Select a simulation setup
+2. Define the frequency sweep range (start, stop, step, units)
+3. Set angular resolution (coarse, regular, or fine) for theta and phi (only for the Anisotropic regime)
+4. Set the maximum theta scan value
+5. Click **Apply and Validate** to create the parametric setup
+6. Click **Start** to run the analysis and extract coefficients
+
+.. image:: ../../../_static/extensions/fresnel_advanced.png
+  :width: 800
+  :alt: Fresnel Advanced Workflow
+
+Simulation settings
+~~~~~~~~~~~~~~~~~~~
+
+This tab is to configure HPC and Parametric Sweep options:
+
+* **HPC Options**: Set number of cores and tasks
+* **Optimetrics Options**: Enable mesh reuse across variations
+
+.. image:: ../../../_static/extensions/fresnel_settings.png
+  :width: 800
+  :alt: Fresnel Simulation Settings
+
+Validation checks
+-----------------
+
+The extension performs several validation checks:
+
+* Verifies Floquet Ports are correctly defined
+* Checks for lattice pair boundaries
+* Validates design integrity
+* Confirms angular sweep configuration
+* Calculates total number of frequency points and spatial directions
+
+Requirements
+------------
+**General:**
+
+* Unit-cell HFSS design with Floquet ports defined
+* Lattice pair boundaries configured
+
+**Specific for the Extraction Workflow:**
+
+* Design variables ``scan_T`` (theta) and ``scan_P`` (phi) assigned to Lattice Pairs
+* Both spatial and frequency sampling distributions should be uniform
+
+Command line usage
+------------------
+
+You can also launch the extension from the terminal:
+
+.. code-block:: python
+
+    from ansys.aedt.core.extensions.hfss.fresnel import FresnelExtension
+
+    extension = FresnelExtension(withdraw=False)
+
+.. toctree::
+   :maxdepth: 2
+
+   ../commandline

doc/source/User_guide/pyaedt_extensions_doc/hfss/index.rst

@@ -37,3 +37,10 @@ HFSS extensions
             :margin: 2 2 0 0
 
             Automated assembly workflow.
+
+   .. grid-item-card:: Fresnel
+            :link: fresnel
+            :link-type: doc
+            :margin: 2 2 0 0
+
+            Extract Fresnel coefficients from HFSS Floquet port simulations for periodic structures.

doc/styles/config/vocabularies/ANSYS/accept.txt

@@ -39,6 +39,7 @@ FEBI
 FE-BI
 file_path
 fix_disjoints
+Floquet
 FRTM
 getters
 Github
@@ -97,6 +98,7 @@ RC
 reusability
 RF
 RMXprt
+RTTBL
 scipy
 setters
 SIwave

src/ansys/aedt/core/application/analysis.py

@@ -535,6 +535,9 @@ def design_excitations(self) -> dict[str, BoundaryObject]:
         """
         exc_names = self.excitation_names[::]
 
+        # Filter modes
+        exc_names = list(set([item.split(":")[0] for item in exc_names]))
+
         for el in self.boundaries:
             if el.name in exc_names:
                 self._excitation_objects[el.name] = el
@@ -543,7 +546,7 @@ def design_excitations(self) -> dict[str, BoundaryObject]:
         keys_to_remove = [
             internal_excitation
             for internal_excitation in self._excitation_objects
-            if internal_excitation not in self.excitation_names
+            if internal_excitation not in exc_names
         ]
 
         for key in keys_to_remove:
@@ -1347,9 +1350,9 @@ def create_output_variable(
 
         Parameters
         ----------
-        variable : str, optional
+        variable : str
             Name of the variable.
-        expression : str, optional
+        expression : str
             Value for the variable.
         solution : str, optional
             Name of the solution in the format `"name : sweep_name"`.

src/ansys/aedt/core/desktop.py

@@ -691,7 +691,8 @@ def __init__(
 
         # Setup logging.
         self.__set_logger_file()
-        settings.enable_desktop_logs = not self.non_graphical and self.aedt_version_id < "2024.2"
+        if self.non_graphical:
+            settings.enable_desktop_logs = False
         self.__init_desktop()
 
         self._check_new_desktop(aedt_process_id, student_version)