ansys-fluent-visualization 0.18.dev0__tar.gz → 0.19.0__tar.gz

{ansys_fluent_visualization-0.18.dev0 → ansys_fluent_visualization-0.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: ansys-fluent-visualization
-Version: 0.18.dev0
+Version: 0.19.0
 Summary: A python wrapper for ansys Fluent visualization
 License: MIT
 Author: ANSYS, Inc.
@@ -16,15 +16,13 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: ansys-fluent-core (>=0.29.dev0,<1.0)
+Requires-Dist: ansys-fluent-core (==0.30.0)
 Requires-Dist: imageio (>=2.36.1)
 Requires-Dist: importlib-metadata (>=4.0,<5.0) ; python_version < "3.9"
 Requires-Dist: matplotlib (>=3.6.0)
-Requires-Dist: plotly (>=5.24.0)
 Requires-Dist: pyside6 (>=6.8.1,<6.9.0)
-Requires-Dist: pyvista[jupyter] (>=0.44.0)
+Requires-Dist: pyvista (>=0.44.0)
 Requires-Dist: pyvistaqt (>=0.11.1,<0.12.0)
-Requires-Dist: vtk (<9.4.0) ; python_version < "3.13"
 Project-URL: Documentation, https://visualization.fluent.docs.pyansys.com/
 Project-URL: Repository, https://github.com/ansys/pyfluent-visualization
 Project-URL: Source, https://github.com/ansys/pyfluent-visualization

{ansys_fluent_visualization-0.18.dev0 → ansys_fluent_visualization-0.19.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "poetry.core.masonry.api"
 [tool.poetry]
 # Check https://python-poetry.org/docs/pyproject/ for all available sections
 name = "ansys-fluent-visualization"
-version = "0.18.dev0"
+version = "0.19.0"
 description = "A python wrapper for ansys Fluent visualization"
 license = "MIT"
 authors = ["ANSYS, Inc. <ansys.support@ansys.com>"]
@@ -25,13 +25,11 @@ packages = [
 [tool.poetry.dependencies]
 python = ">=3.10,<4.0"
 importlib-metadata = {version = "^4.0", python = "<3.9"}
-ansys-fluent-core = "~=0.29.dev0"
-pyvista = { version = ">=0.44.0", extras = ["jupyter"]}
+ansys-fluent-core = "==0.30.0"
+pyvista = ">=0.44.0"
 matplotlib = ">=3.6.0"
-vtk = {version = "<9.4.0", python = "<3.13"}
 pyvistaqt = "~=0.11.1"
 pyside6 = "~=6.8.1"
-plotly = ">=5.24.0"
 imageio= ">=2.36.1"
 
 [tool.poetry.urls]

{ansys_fluent_visualization-0.18.dev0 → ansys_fluent_visualization-0.19.0}/src/ansys/fluent/visualization/__init__.py

@@ -27,10 +27,10 @@ try:
 except ModuleNotFoundError:
     import importlib_metadata
 
-_VERSION_INFO = "Build date: February 11, 2025 07:45 UTC ShaID: a0f6c2e"
+_VERSION_INFO = "Build date: March 11, 2025 13:48 UTC ShaID: 837c3f6"
 __version__ = importlib_metadata.version(__name__.replace(".", "-"))
 PLOTTER = "matplotlib"
-INTERACTIVE = False
+SINGLE_WINDOW = False
 
 
 def version_info() -> str:

{ansys_fluent_visualization-0.18.dev0 → ansys_fluent_visualization-0.19.0}/src/ansys/fluent/visualization/_config.py

@@ -21,6 +21,7 @@
 # SOFTWARE.
 
 """Global configuration state for visualization."""
+import warnings
 
 _global_config = {"blocking": False, "set_view_on_display": None}
 
@@ -35,7 +36,8 @@ def get_config() -> dict:
     """
     import ansys.fluent.visualization as pyviz
 
-    _global_config["blocking"] = not pyviz.INTERACTIVE
+    if pyviz.SINGLE_WINDOW:
+        _global_config["blocking"] = False
     return _global_config.copy()
 
 
@@ -50,13 +52,18 @@ def set_config(blocking: bool = False, set_view_on_display: str = "isometric"):
         If specified, then graphics will always be displayed in the specified view.
         Valid values are xy, xz, yx, yz, zx, zy and isometric.
     """
+    import ansys.fluent.visualization as pyviz
+
     if set_view_on_display not in set_config.allowed_views:
         raise ValueError(
             f"'{set_view_on_display}' is not an allowed view.\n"
             f"Allowed views are: {set_config.allowed_views}"
         )
 
-    _global_config["blocking"] = blocking
+    if pyviz.SINGLE_WINDOW:
+        warnings.warn("'blocking' cannot be set from PyConsole.")
+    else:
+        _global_config["blocking"] = blocking
     _global_config["set_view_on_display"] = set_view_on_display
 
 

{ansys_fluent_visualization-0.18.dev0 → ansys_fluent_visualization-0.19.0}/src/ansys/fluent/visualization/graphics/graphics_windows.py

@@ -21,11 +21,21 @@
 # SOFTWARE.
 
 """A wrapper to improve the user interface of graphics."""
+from PySide6.QtWidgets import (
+    QApplication,
+    QMainWindow,
+    QTabWidget,
+    QVBoxLayout,
+    QWidget,
+)
 
+import ansys.fluent.visualization as pyviz
 from ansys.fluent.visualization import get_config
 from ansys.fluent.visualization.graphics import graphics_windows_manager
 from ansys.fluent.visualization.plotter.plotter_windows import PlotterWindow
 
+_qt_window = None
+
 
 class GraphicsWindow:
     def __init__(self, grid: tuple = (1, 1)):
@@ -86,26 +96,64 @@ class GraphicsWindow:
                     position=self._graphics_objs[i]["position"],
                     opacity=self._graphics_objs[i]["opacity"],
                 )
-            graphics_windows_manager.show_graphics(self.window_id)
+            if pyviz.SINGLE_WINDOW:
+                global _qt_window
+                if not _qt_window:
+                    QApplication.instance() or QApplication()
+                    _qt_window = MainWindow()
+                    _qt_window.show()
+                _qt_window._add_tab(
+                    self.plotter,
+                    title=self.window_id.replace(
+                        self.window_id[-1], str(int(self.window_id[-1]) + 1)
+                    ),
+                )
+            else:
+                graphics_windows_manager.show_graphics(self.window_id)
 
     def save_graphic(
         self,
-        format: str,
+        filename: str,
     ) -> None:
-        """Save a graphics.
+        """Save a screenshot of the rendering window as a graphic file.
 
         Parameters
         ----------
-        format : str
-            Graphic file format. Supported formats are SVG, EPS, PS, PDF, and TEX.
+        filename : str
+            Path to save the graphic file to.
+            Supported formats are SVG, EPS, PS, PDF, and TEX.
 
         Raises
         ------
         ValueError
             If the window does not support the specified format.
+
+        Examples
+        --------
+        >>> import ansys.fluent.core as pyfluent
+        >>> from ansys.fluent.core import examples
+        >>> from ansys.fluent.visualization import GraphicsWindow, Vector
+        >>>
+        >>> import_case = examples.download_file(
+        >>> file_name="exhaust_system.cas.h5", directory="pyfluent/exhaust_system"
+        >>> )
+        >>> import_data = examples.download_file(
+        >>> file_name="exhaust_system.dat.h5", directory="pyfluent/exhaust_system"
+        >>> )
+        >>>
+        >>> solver_session = pyfluent.launch_fluent()
+        >>> solver_session.settings.file.read_case(file_name=import_case)
+        >>> solver_session.settings.file.read_data(file_name=import_data)
+        >>>
+        >>> velocity_vector = Vector(
+        >>> solver=solver_session, field="pressure", surfaces=["solid_up:1:830"]
+        >>> )
+        >>> graphics_window = GraphicsWindow()
+        >>> graphics_window.add_graphics(velocity_vector)
+        >>> graphics_window.save_graphic("saved_vector.svg")
         """
         if self.window_id:
-            self._renderer.save_graphic(f"{self.window_id}.{format}")
+            self._renderer.save_graphic(filename)
 
     def refresh_windows(
         self,
@@ -168,3 +216,42 @@ class GraphicsWindow:
             graphics_windows_manager.close_windows(
                 windows_id=[self.window_id], session_id=session_id
             )
+
+
+# Define the main window
+class MainWindow(QMainWindow):
+    def __init__(self):
+        super().__init__()
+        self.setWindowTitle("PyFluent Visualization Plots")
+        screen = QApplication.primaryScreen().availableGeometry()
+        width = int(screen.width() * 0.75)
+        height = int(screen.height() * 0.75)
+        self.setGeometry(
+            (screen.width() - width) // 2,  # Center X
+            (screen.height() - height) // 2,  # Center Y
+            width,
+            height,
+        )
+        self.tabs = QTabWidget()
+        self.setCentralWidget(self.tabs)
+        self.tabs.setMovable(True)
+        self.plotters = []
+
+    def _add_tab(self, plotter, title="-"):
+        tab = QWidget()
+        layout = QVBoxLayout()
+
+        self.plotters.append(plotter)
+        layout.addWidget(plotter.interactor)
+        tab.setLayout(layout)
+
+        # Add tabs with PyVista BackgroundPlotters
+        self.tabs.addTab(tab, f"PyViz ({title})")
+
+    def closeEvent(self, event):
+        """Ensure proper cleanup of plotter instances on window close."""
+        for plotter in self.plotters:
+            plotter.close()  # Properly close each PyVista plotter
+        event.accept()
+        global _qt_window
+        _qt_window = None

{ansys_fluent_visualization-0.18.dev0 → ansys_fluent_visualization-0.19.0}/src/ansys/fluent/visualization/graphics/graphics_windows_manager.py

@@ -24,7 +24,6 @@
 
 from enum import Enum
 import itertools
-import os
 import threading
 from typing import Dict, List, Optional, Union
 
@@ -43,6 +42,7 @@ try:
 except ModuleNotFoundError:
     BackgroundPlotter = None
 
+import ansys.fluent.visualization as pyviz
 from ansys.fluent.visualization import get_config
 from ansys.fluent.visualization.post_data_extractor import (
     FieldDataExtractor,
@@ -576,11 +576,7 @@ class GraphicsWindowsManager(PostWindowsManager, metaclass=AbstractSingletonMeta
         with self._condition:
             if not window_id:
                 window_id = self._get_unique_window_id()
-            if (
-                in_notebook()
-                or get_config()["blocking"]
-                or os.getenv("FLUENT_PROD_DIR")
-            ):
+            if in_notebook() or get_config()["blocking"] or pyviz.SINGLE_WINDOW:
                 self._open_window_notebook(window_id, grid)
             else:
                 self._open_and_plot_console(None, window_id, grid=grid)
@@ -639,11 +635,7 @@ class GraphicsWindowsManager(PostWindowsManager, metaclass=AbstractSingletonMeta
         with self._condition:
             if not window_id:
                 window_id = self._get_unique_window_id()
-            if (
-                in_notebook()
-                or get_config()["blocking"]
-                or os.getenv("FLUENT_PROD_DIR")
-            ):
+            if in_notebook() or get_config()["blocking"] or pyviz.SINGLE_WINDOW:
                 self._plot_notebook(object, window_id, fetch_data, overlay)
             else:
                 self._open_and_plot_console(object, window_id, fetch_data, overlay)
@@ -682,11 +674,7 @@ class GraphicsWindowsManager(PostWindowsManager, metaclass=AbstractSingletonMeta
         if not isinstance(object, (GraphicsDefn, PlotDefn)):
             raise RuntimeError("Object type currently not supported.")
         with self._condition:
-            if (
-                in_notebook()
-                or get_config()["blocking"]
-                or os.getenv("FLUENT_PROD_DIR")
-            ):
+            if in_notebook() or get_config()["blocking"] or pyviz.SINGLE_WINDOW:
                 self._add_graphics_in_notebook(
                     object, window_id, fetch_data, overlay, position, opacity
                 )
@@ -698,11 +686,7 @@ class GraphicsWindowsManager(PostWindowsManager, metaclass=AbstractSingletonMeta
     def show_graphics(self, window_id: str):
         """Display the graphics window."""
         with self._condition:
-            if (
-                in_notebook()
-                or get_config()["blocking"]
-                or os.getenv("FLUENT_PROD_DIR")
-            ):
+            if in_notebook() or get_config()["blocking"] or pyviz.SINGLE_WINDOW:
                 self._show_graphics_in_notebook(window_id)
 
     def save_graphic(

{ansys_fluent_visualization-0.18.dev0 → ansys_fluent_visualization-0.19.0}/src/ansys/fluent/visualization/graphics/pyvista/graphics_defns.py

@@ -21,10 +21,11 @@
 # SOFTWARE.
 
 """Module for pyVista windows management."""
-
 import numpy as np
 import pyvista as pv
 
+import ansys.fluent.visualization as pyviz
+
 try:
     from pyvistaqt import BackgroundPlotter
 except ModuleNotFoundError:
@@ -44,7 +45,11 @@ class Renderer(AbstractRenderer):
         self.plotter: BackgroundPlotter | pv.Plotter = (
             pv.Plotter(title=f"PyFluent ({win_id})", shape=grid)
             if in_notebook or non_interactive
-            else BackgroundPlotter(title=f"PyFluent ({win_id})", shape=grid)
+            else BackgroundPlotter(
+                title=f"PyFluent ({win_id})",
+                shape=grid,
+                show=False if pyviz.SINGLE_WINDOW else True,
+            )
         )
         self._init_properties()
         self._colors = {