ansys-fluent-visualization 0.17.dev0__tar.gz → 0.18.0__tar.gz

{ansys_fluent_visualization-0.17.dev0 → ansys_fluent_visualization-0.18.0}/LICENSE

@@ -1,13 +1,13 @@
 MIT License
 
-Copyright (c) 2022 ANSYS, Inc. All rights reserved.
+Copyright (c) 2022 - 2025 ANSYS, Inc. and/or its affiliates.
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.

{ansys_fluent_visualization-0.17.dev0 → ansys_fluent_visualization-0.18.0}/PKG-INFO

@@ -1,8 +1,7 @@
 Metadata-Version: 2.3
 Name: ansys-fluent-visualization
-Version: 0.17.dev0
+Version: 0.18.0
 Summary: A python wrapper for ansys Fluent visualization
-Home-page: https://github.com/ansys/pyfluent-visualization
 License: MIT
 Author: ANSYS, Inc.
 Author-email: ansys.support@ansys.com
@@ -17,15 +16,11 @@ 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: imageio (>=2.36.1)
-Requires-Dist: importlib-metadata (>=4.0,<5.0) ; python_version < "3.9"
+Requires-Dist: ansys-fluent-core (==0.29.0)
 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.17.dev0 → ansys_fluent_visualization-0.18.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.17.dev0"
+version = "0.18.0"
 description = "A python wrapper for ansys Fluent visualization"
 license = "MIT"
 authors = ["ANSYS, Inc. <ansys.support@ansys.com>"]
@@ -24,15 +24,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.29.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]
 "Documentation" = "https://visualization.fluent.docs.pyansys.com/"

ansys_fluent_visualization-0.18.0/src/ansys/fluent/visualization/__init__.py

@@ -0,0 +1,64 @@
+# Copyright (C) 2022 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+"""Python post processing integrations for the Fluent solver."""
+
+try:
+    import importlib.metadata as importlib_metadata
+except ModuleNotFoundError:
+    import importlib_metadata
+
+_VERSION_INFO = "Build date: February 20, 2025 13:32 UTC ShaID: d8bef97"
+__version__ = importlib_metadata.version(__name__.replace(".", "-"))
+PLOTTER = "matplotlib"
+SINGLE_WINDOW = False
+
+
+def version_info() -> str:
+    """Method returning the version of PyFluent being used.
+    Returns
+    -------
+    str
+        The PyFluent version being used.
+    Notes
+    -------
+    Only available in packaged versions. Otherwise it will return __version__.
+    """
+    return _VERSION_INFO if _VERSION_INFO is not None else __version__
+
+
+from ansys.fluent.visualization._config import get_config, set_config  # noqa: F401
+from ansys.fluent.visualization.containers import (  # noqa: F401
+    Contour,
+    Mesh,
+    Monitor,
+    Pathline,
+    Surface,
+    Vector,
+    XYPlot,
+)
+from ansys.fluent.visualization.graphics import Graphics  # noqa: F401
+from ansys.fluent.visualization.graphics.graphics_windows import (  # noqa: F401
+    GraphicsWindow,
+)
+from ansys.fluent.visualization.plotter import Plots  # noqa: F401
+from ansys.fluent.visualization.plotter.plotter_windows import PlotterWindow

ansys_fluent_visualization-0.18.0/src/ansys/fluent/visualization/_config.py

@@ -0,0 +1,70 @@
+# Copyright (C) 2022 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+"""Global configuration state for visualization."""
+import warnings
+
+_global_config = {"blocking": False, "set_view_on_display": None}
+
+
+def get_config() -> dict:
+    """Retrieve visualization configuration.
+
+    Returns
+    -------
+    config : dict
+        Keys are parameter names that can be passed to :func:`set_config`.
+    """
+    import ansys.fluent.visualization as pyviz
+
+    if pyviz.SINGLE_WINDOW:
+        _global_config["blocking"] = False
+    return _global_config.copy()
+
+
+def set_config(blocking: bool = False, set_view_on_display: str = "isometric"):
+    """Set visualization configuration.
+
+    Parameters
+    ----------
+    blocking : bool, default=False
+        If True, then graphics/plot display will block the current thread.
+    set_view_on_display : str, default=None
+        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}"
+        )
+
+    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
+
+
+set_config.allowed_views = ["xy", "xz", "yx", "yz", "zx", "zy", "isometric"]

{ansys_fluent_visualization-0.17.dev0 → ansys_fluent_visualization-0.18.0}/src/ansys/fluent/visualization/containers.py

@@ -1,3 +1,25 @@
+# Copyright (C) 2022 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
 """Containers for graphics."""
 
 from ansys.fluent.visualization.graphics import Graphics

{ansys_fluent_visualization-0.17.dev0 → ansys_fluent_visualization-0.18.0}/src/ansys/fluent/visualization/contour.py

@@ -1,3 +1,25 @@
+# Copyright (C) 2022 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
 """Contour objects based on field name and surfaces list."""
 
 from typing import List, Optional

ansys_fluent_visualization-0.18.0/src/ansys/fluent/visualization/graphics/__init__.py

@@ -0,0 +1,28 @@
+# Copyright (C) 2022 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+"""A package that provides interfacing Fluent with graphics renderer (PyVista)."""
+
+from ansys.fluent.visualization.graphics.graphics_objects import Graphics  # noqa: F401
+from ansys.fluent.visualization.graphics.graphics_windows_manager import (  # noqa: F401
+    graphics_windows_manager,
+)

ansys_fluent_visualization-0.18.0/src/ansys/fluent/visualization/graphics/abstract_graphics_defns.py

@@ -0,0 +1,66 @@
+# Copyright (C) 2022 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+"""Abstract module providing graphics functionality."""
+
+from abc import ABC, abstractmethod
+
+
+class AbstractRenderer(ABC):
+    """Abstract class for renderer."""
+
+    @abstractmethod
+    def show(self):
+        """Show graphics."""
+        pass
+
+    @abstractmethod
+    def render(self, mesh, **kwargs):
+        """Render graphics in window."""
+        pass
+
+    @abstractmethod
+    def save_graphic(self, file_name: str):
+        """Save graphics to the specified file.
+
+        Parameters
+        ----------
+        file_name : str
+            File name to save graphic.
+        """
+        pass
+
+    @abstractmethod
+    def get_animation(self, win_id: str):
+        """Animate windows.
+
+        Parameters
+        ----------
+        win_id : str
+            ID for the window to animate.
+        """
+        pass
+
+    @abstractmethod
+    def close(self):
+        """Close graphics window."""
+        pass

{ansys_fluent_visualization-0.17.dev0 → ansys_fluent_visualization-0.18.0}/src/ansys/fluent/visualization/graphics/graphics_objects.py

@@ -1,3 +1,25 @@
+# Copyright (C) 2022 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
 """Module providing visualization objects for PyVista."""
 
 import sys

{ansys_fluent_visualization-0.17.dev0 → ansys_fluent_visualization-0.18.0}/src/ansys/fluent/visualization/graphics/graphics_windows.py

@@ -1,9 +1,41 @@
-"""A wrapper to improve the user interface of graphics."""
+# Copyright (C) 2022 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# 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)):
@@ -64,7 +96,20 @@ 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,
@@ -146,3 +191,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.17.dev0 → ansys_fluent_visualization-0.18.0}/src/ansys/fluent/visualization/graphics/graphics_windows_manager.py

@@ -1,8 +1,29 @@
+# Copyright (C) 2022 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
 """Module for graphics windows management."""
 
 from enum import Enum
 import itertools
-import os
 import threading
 from typing import Dict, List, Optional, Union
 
@@ -21,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,
@@ -554,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)
@@ -617,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)
@@ -660,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
                 )
@@ -676,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.0/src/ansys/fluent/visualization/graphics/pyvista/__init__.py

@@ -0,0 +1,21 @@
+# Copyright (C) 2022 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.

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

@@ -1,8 +1,31 @@
-"""Module for pyVista windows management."""
+# Copyright (C) 2022 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# 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:
@@ -22,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 = {