FEAT: RCS class

.github/workflows/ci_cd.yml

@@ -88,7 +88,7 @@ jobs:
       - name: Run unit tests
         uses: ansys/actions/tests-pytest@v8
         with:
-          pytest-markers: -m unit
+          pytest-postargs: 'tests/unit'
           pytest-extra-args: ${{ env.PYTEST_ARGUMENTS }}
           python-version: ${{ env.MAIN_PYTHON_VERSION }}
           optional-dependencies-name: unit-tests
@@ -108,13 +108,41 @@ jobs:
           path: junit/test-results.xml
         if: ${{ always() }}
 
+  integration-tests:
+    name: Running integration tests
+    needs: [unit-tests]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Run integration tests
+        uses: ansys/actions/tests-pytest@v8
+        with:
+          pytest-postargs: 'tests/integration'
+          pytest-extra-args: ${{ env.PYTEST_ARGUMENTS }}
+          python-version: ${{ env.MAIN_PYTHON_VERSION }}
+          optional-dependencies-name: integration-tests
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          name: codecov-integration-tests
+          file: ./coverage.xml
+          flags: linux_integration
+
+      - name: Upload pytest test results
+        uses: actions/upload-artifact@v4
+        with:
+          name: pytest-integration
+          path: junit/test-results.xml
+        if: ${{ always() }}
+
 # # =================================================================================================
 # # vvvvvvvvvvvvvvvvvvvvvvvvvvvvvv    RUNNING ON SELF-HOSTED RUNNER    vvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
 # # =================================================================================================
 
   system-tests-solvers-windows:
     name: Testing solvers and coverage (Windows)
-    needs: [unit-tests]
+    needs: [integration-tests]
     if: github.event.pull_request.draft == false
     runs-on: [ self-hosted, Windows, pyaedt ]
     steps:
@@ -173,7 +201,7 @@ jobs:
 
   system-tests-solvers-linux:
     name: Testing solvers and coverage (Linux)
-    needs: [unit-tests]
+    needs: [integration-tests]
     if: github.event.pull_request.draft == false
     runs-on: [ self-hosted, Linux, pyaedt ]
     env:
@@ -229,7 +257,7 @@ jobs:
 
   system-tests-general-windows:
     name: Testing and coverage (Windows)
-    needs: [unit-tests]
+    needs: [integration-tests]
     if: github.event.pull_request.draft == false
     runs-on: [ self-hosted, Windows, pyaedt ]
     steps:
@@ -294,7 +322,7 @@ jobs:
   system-tests-general-linux:
     name: Testing and coverage (Linux)
     if: github.event.pull_request.draft == false
-    needs: [unit-tests]
+    needs: [integration-tests]
     runs-on: [ self-hosted, Linux, pyaedt ]
     env:
       ANSYSEM_ROOT242: '/opt/AnsysEM/v242/Linux64'

doc/source/API/visualization/advanced.rst

@@ -116,6 +116,58 @@ If you have existing farfield data, or you want to export it manually, you can s
     :alt: Farfield data with AEDT
 
 
+Monostatic RCS
+~~~~~~~~~~~~~~
+
+PyAEDT offers sophisticated tools for advanced monostatic radar cross section (RCS) post-processing.
+There are three complementary classes: ``MonostaticRCSExporter``, ``MonostaticRCSData``, and ``MonostaticRCSPlotter``.
+
+- MonostaticRCSExporter: Enables efficient export and manipulation of RCS data. It allows users to convert simulation results into a standard metadata format for further analysis, or reporting.
+
+- MonostaticRCSData: Focuses on the direct access and processing of RCS solution data. It supports a comprehensive set of postprocessing operations, from visualizing radiation patterns to computing key performance metrics.
+
+- MonostaticRCSPlotter: Focuses on the post-processing of RCS solution data.
+
+
+.. currentmodule:: ansys.aedt.core.visualization.advanced.rcs_visualization
+
+.. autosummary::
+   :toctree: _autosummary
+   :nosignatures:
+
+   MonostaticRCSData
+   MonostaticRCSPlotter
+
+
+This code shows how you can get the RCS data and perform some post-processing:
+
+.. code:: python
+
+    from ansys.aedt.core import Hfss
+    from ansys.aedt.core.visualization.advanced.rcs_visualization import MonostaticRCSPlotter
+    app = Hfss()
+    rcs_object = app.get_rcs_data()
+    rcs_plotter = MonostaticRCSPlotter(rcs_data=rcs_object.rcs_data)
+    rcs_plotter.plot_rcs()
+
+If you exported the RCS data previously, you can directly get the RCS data:
+
+.. code:: python
+
+    from ansys.aedt.core.visualization.advanced.rcs_visualization import MonostaticRCSPlotter
+    from ansys.aedt.core.visualization.advanced.rcs_visualization import MonostaticRCSData
+    input_file = r"path_to_data\pyaedt_rcs_metadata.json"
+    rcs_data = MonostaticRCSData(input_file)
+    rcs_plotter = MonostaticRCSPlotter(rcs_data)
+    rcs_plotter.plot_cut()
+
+The following diagram shows both classes work. You can use them independently or from the ``get_rcs_data`` method.
+
+  .. image:: ../../_static/rcs_visualization_pyaedt.png
+    :width: 800
+    :alt: RCS data with PyAEDT
+
+
 Heterogeneous data message
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

doc/source/API/visualization/post.rst

@@ -202,6 +202,25 @@ If you need to export HFSS far field data, then you can use the following featur
     antenna_data = app.post.get_antenna_data()
     app.release_desktop(False, False)
 
+If you need to export HFSS monostatic RCS data, then you can use the following feature to obtain the RCS metadata:
+
+.. currentmodule:: ansys.aedt.core.visualization.post.rcs_exporter
+
+.. autosummary::
+   :toctree: _autosummary
+   :nosignatures:
+
+   MonostaticRCSExporter
+
+.. code:: python
+
+    from ansys.aedt.core import Hfss
+
+    app = Hfss()
+
+    rcs_data = app.post.get_rcs_data()
+    app.release_desktop(False, False)
+
 
 Icepak
 ~~~~~~

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

@@ -49,6 +49,7 @@ Maxwell 3D
 Maxwell Circuit
 mcm
 [Mm]echanical
+[Mm]onostatic
 multiphysics
 multiplot
 namespaces

pyproject.toml

@@ -51,6 +51,14 @@ unit-tests = [
     "pytest-cov>=4.0.0,<6.1",
     "mock>=5.1.0,<5.2",
 ]
+integration-tests = [
+    "matplotlib>=3.5.0,<3.10",
+    "mock>=5.1.0,<5.2",
+    "numpy>=1.20.0,<2",
+    "pandas>=1.1.0,<2.3",
+    "pytest>=7.4.0,<8.4",
+    "pytest-cov>=4.0.0,<6.1",
+]
 tests = [
     "ipython>=7.30.0,<8.30",
     "joblib>=1.0.0,<1.5",
@@ -64,6 +72,8 @@ tests = [
     "pytest-cov>=4.0.0,<6.1",
     "pytest-xdist>=3.5.0,<3.7",
     "pyvista[io]>=0.38.0,<0.45",
+    "ansys-tools-visualization-interface; python_version >= '3.10'",
+    "tables; python_version >= '3.10'",
     # Never directly imported but required when loading ML related file see #4713
     "scikit-learn>=1.0.0,<1.6",
     "scikit-rf>=0.30.0,<1.5",
@@ -98,6 +108,8 @@ all = [
     "pandas>=1.1.0,<2.3",
     "pyvista[io]>=0.38.0,<0.45",
     "fast-simplification>=0.1.7",
+    "ansys-tools-visualization-interface; python_version >= '3.10'",
+    "tables; python_version >= '3.10'",
     # Never directly imported but required when loading ML related file see #4713
     "scikit-learn>=1.0.0,<1.6",
     "scikit-rf>=0.30.0,<1.5",
@@ -111,6 +123,8 @@ installer = [
     "osmnx>=1.1.0,<1.10",
     "pandas>=1.1.0,<2.3",
     "pyvista[io]>=0.38.0,<0.45",
+    "fast-simplification>=0.1.7",
+    "ansys-tools-visualization-interface; python_version >= '3.10'",
     # Never directly imported but required when loading ML related file see #4713
     "scikit-learn>=1.0.0,<1.6",
     "scikit-rf>=0.30.0,<1.5",
@@ -160,6 +174,7 @@ omit = ["src/ansys/aedt/core/rpc/*.py"]
 [tool.pytest.ini_options]
 markers = [
     "unit",
+    "integration",
     "system",
     "solvers",
     "general",

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

@@ -1408,6 +1408,9 @@
                     "UseSBREnhancedRadiatedPowerCalculation": False,
                     "AdaptFEBIWithRadiation": False,
                 }
+                if settings.aedt_version >= "2024.2":
+                    default_sbr_setup["IsMonostaticRCS"] = True
+                    default_sbr_setup["FastFrequencyLooping"] = False
                 user_domain = None
                 if props:
                     if "RadiationSetup" in props:

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

@@ -3447,7 +3447,7 @@
         >>> oProject.InsertDesign
         """
         self._close_edb()
-        self._init_design(
+        return self._init_design(
             project_name=self.project_name if self.project_name else generate_unique_name("Project"),
             design_name=name,
             solution_type=solution_type if solution_type else self.solution_type,

src/ansys/aedt/core/hfss.py

@@ -5832,10 +5832,10 @@
             Whether to overwrite FFD files. The default is ``True``.
         link_to_hfss : bool, optional
             Whether to return an instance of the
-            :class:`ansys.aedt.core.generic.farfield_explorerf.FfdSolutionDataExporter` class,
+            :class:`ansys.aedt.core.visualization.advanced.farfield_exporter.FfdSolutionDataExporter` class,
             which requires a connection to an instance of the :class:`Hfss` class.
             The default is `` True``. If ``False``, returns an instance of
-            :class:`ansys.aedt.core.generic.farfield_explorer.FfdSolutionData` class, which is
+            :class:`ansys.aedt.core.visualization.advanced.farfield_visualization.FfdSolutionData` class, which is
             independent of the running HFSS instance.
         export_touchstone : bool, optional
             Whether to export touchstone file. The default is ``False``.
@@ -5919,6 +5919,104 @@
             self.logger.error("Farfield solution data could not be exported.")
             return False
 
+    @pyaedt_function_handler()
+    def get_rcs_data(
+        self,
+        frequencies=None,
+        setup=None,
+        expression="ComplexMonostaticRCSTheta",
+        variations=None,
+        overwrite=True,
+        link_to_hfss=True,
+        variation_name=None,
+    ):
+        """Export the radar cross-section data.
+        This method returns an instance of the ``RcsSolutionDataExporter`` object.
+
+        Parameters
+        ----------
+        frequencies : float, list, optional
+            Frequency value or list of frequencies to compute the data. The default is ``None,`` in which case
+            all available frequencies are computed.
+        setup : str, optional
+            Name of the setup to use. The default is ``None,`` in which case ``nominal_adaptive`` is used.
+        expression : str, optional
+            Monostatic expression name. The default value is ``"ComplexMonostaticRCSTheta"``.
+        variations : dict, optional
+            Variation dictionary. The default is ``None``, in which case the nominal variation is exported.
+        overwrite : bool, optional
+            Whether to overwrite metadata files. The default is ``True``.
+        link_to_hfss : bool, optional
+            Whether to return an instance of the
+            :class:`ansys.aedt.core.visualization.post.rcs_exporter.MonostaticRCSExporter` class,
+            which requires a connection to an instance of the :class:`Hfss` class.
+            The default is `` True``. If ``False``, returns an instance of
+            :class:`ansys.aedt.core.visualization.advanced.rcs_visualization.MonostaticRCSData` class, which is
+            independent of the running HFSS instance.
+        variation_name : str, optional
+            Variation name. The default is ``None``, in which case the nominal variation is added.
+
+        Returns
+        -------
+        :class:`ansys.aedt.core.post.rcs_exporter.MonostaticRCSExporter`
+            SolutionData object.
+
+        Examples
+        --------
+        The method :func:`get_antenna_data` is used to export the farfield of each element of the design.
+
+        Open a design and create the objects.
+
+        >>> from ansys.aedt.core import Hfss
+        >>> hfss = Hfss()
+        >>> rcs_data = hfss.get_rcs_data()
+        """
+        from ansys.aedt.core.visualization.advanced.rcs_visualization import MonostaticRCSData
+        from ansys.aedt.core.visualization.post.rcs_exporter import MonostaticRCSExporter
+
+        if not variations:
+            variations = self.available_variations.nominal_w_values_dict_w_dependent
+        if not setup:
+            setup = self.nominal_adaptive
+
+        if setup in self.existing_analysis_sweeps and not frequencies:
+            rcs_data = self.post.get_solution_data(
+                expressions=expression,
+                variations=variations,
+                setup_sweep_name=setup,
+                report_category="Monostatic RCS",
+            )
+            if rcs_data and rcs_data.primary_sweep_values is not None:
+                frequencies = rcs_data.primary_sweep_values
+                frequency_units = self.odesktop.GetDefaultUnit("Frequency")
+                frequencies = [str(freq) + frequency_units for freq in frequencies]
+
+        if not frequencies:  # pragma: no cover
+            self.logger.info("Frequencies could not be obtained.")
+            return False
+
+        rcs = MonostaticRCSExporter(
+            self,
+            setup_name=setup,
+            frequencies=frequencies,
+            expression=expression,
+            variations=variations,
+            overwrite=overwrite,
+        )
+
+        if variation_name:
+            rcs.solution = variation_name
+
+        metadata = rcs.export_rcs()
+
+        if link_to_hfss:
+            return rcs
+        elif metadata:
+            return MonostaticRCSData(input_file=metadata)
+        else:  # pragma: no cover
+            self.logger.error("Farfield solution data could not be exported.")
+            return False
+
     @pyaedt_function_handler()
     def set_material_threshold(self, threshold=100000):
         """Set the material conductivity threshold.

src/ansys/aedt/core/modules/solve_setup.py

@@ -3403,7 +3403,7 @@ def enable_adaptive_setup_multifrequency(self, frequencies, max_delta_s=0.02):
 
 
 class SetupSBR(Setup, object):
-    """Initializes, creates, and updates an HFSS SBR+ or  HFSS Auto setup.
+    """Initializes, creates, and updates an HFSS SBR+ or HFSS Auto setup.
 
     Parameters
     ----------